MarketplaceNotes: insert

This is an invitation-only beta feature.

Add notes to the proposal Try it now.


HTTP request



Parameter name Value Description
Path parameters
proposalId string The proposalId to add notes for.


This request requires authorization with the following scope:


For more information, see the authentication and authorization page.

Request body

In the request body, supply a MarketplaceNotes resource.


If successful, this method returns a response body with the following structure:

  "notes": [
      "kind": "adexchangebuyer#marketplaceNote",
      "timestampMs": long,
      "creatorRole": string,
      "note": string,
      "proposalRevisionNumber": long,
      "proposalId": string,
      "dealId": string,
      "noteId": string
Property name Value Description Notes
notes[] list
notes[].kind string Identifies what kind of resource this is. Value: the fixed string "adexchangebuyer#marketplaceNote".
notes[].timestampMs long The timestamp (ms since epoch) that this note was created. (readonly)
notes[].creatorRole string The role of the person (buyer/seller) creating the note. (readonly)

Acceptable values are:
  • "buyer"
  • "seller"
  • "unknownBuyerSellerRole"
notes[].note string The actual note to attach. (readonly, except on create)
notes[].dealId string Notes can optionally be associated with a deal. (readonly, except on create)
notes[].noteId string The unique id for the note. (readonly)
notes[].proposalRevisionNumber long If the note is associated with a proposal revision number, then store that here. (readonly, except on create)
notes[].proposalId string The proposalId that a note is attached to. (readonly)

Try it!

Use the APIs Explorer below to call this method on live data and see the response.