Ad Exchange Buyer API . marketplacenotes

close()

Close httplib2 connections.

insert(proposalId, body=None)

Add notes to the proposal

Args:
  proposalId: string, The proposalId to add notes for. (required)
  body: object, The request body.
    The object takes the form of:

{
  "notes": [ # The list of notes to add.
    { # A proposal is associated with a bunch of notes which may optionally be associated with a deal and/or revision number.
      "creatorRole": "A String", # The role of the person (buyer/seller) creating the note. (readonly)
      "dealId": "A String", # Notes can optionally be associated with a deal. (readonly, except on create)
      "kind": "adexchangebuyer#marketplaceNote", # Identifies what kind of resource this is. Value: the fixed string "adexchangebuyer#marketplaceNote".
      "note": "A String", # The actual note to attach. (readonly, except on create)
      "noteId": "A String", # The unique id for the note. (readonly)
      "proposalId": "A String", # The proposalId that a note is attached to. (readonly)
      "proposalRevisionNumber": "A String", # If the note is associated with a proposal revision number, then store that here. (readonly, except on create)
      "timestampMs": "A String", # The timestamp (ms since epoch) that this note was created. (readonly)
    },
  ],
}


Returns:
  An object of the form:

    {
  "notes": [
    { # A proposal is associated with a bunch of notes which may optionally be associated with a deal and/or revision number.
      "creatorRole": "A String", # The role of the person (buyer/seller) creating the note. (readonly)
      "dealId": "A String", # Notes can optionally be associated with a deal. (readonly, except on create)
      "kind": "adexchangebuyer#marketplaceNote", # Identifies what kind of resource this is. Value: the fixed string "adexchangebuyer#marketplaceNote".
      "note": "A String", # The actual note to attach. (readonly, except on create)
      "noteId": "A String", # The unique id for the note. (readonly)
      "proposalId": "A String", # The proposalId that a note is attached to. (readonly)
      "proposalRevisionNumber": "A String", # If the note is associated with a proposal revision number, then store that here. (readonly, except on create)
      "timestampMs": "A String", # The timestamp (ms since epoch) that this note was created. (readonly)
    },
  ],
}

list(proposalId, pqlQuery=None)

Get all the notes associated with a proposal

Args:
  proposalId: string, The proposalId to get notes for. To search across all proposals specify order_id = '-' as part of the URL. (required)
  pqlQuery: string, Query string to retrieve specific notes. To search the text contents of notes, please use syntax like "WHERE note.note = "foo" or "WHERE note.note LIKE "%bar%"

Returns:
  An object of the form:

    {
  "notes": [ # The list of matching notes. The notes for a proposal are ordered from oldest to newest. If the notes span multiple proposals, they will be grouped by proposal, with the notes for the most recently modified proposal appearing first.
    { # A proposal is associated with a bunch of notes which may optionally be associated with a deal and/or revision number.
      "creatorRole": "A String", # The role of the person (buyer/seller) creating the note. (readonly)
      "dealId": "A String", # Notes can optionally be associated with a deal. (readonly, except on create)
      "kind": "adexchangebuyer#marketplaceNote", # Identifies what kind of resource this is. Value: the fixed string "adexchangebuyer#marketplaceNote".
      "note": "A String", # The actual note to attach. (readonly, except on create)
      "noteId": "A String", # The unique id for the note. (readonly)
      "proposalId": "A String", # The proposalId that a note is attached to. (readonly)
      "proposalRevisionNumber": "A String", # If the note is associated with a proposal revision number, then store that here. (readonly, except on create)
      "timestampMs": "A String", # The timestamp (ms since epoch) that this note was created. (readonly)
    },
  ],
}