# Ad Exchange Buyer API . marketplacenotes

## Instance Methods

Add notes to the proposal

Get all the notes associated with a proposal

### Method Details

`insert(proposalId, body)`

    Add notes to the proposal

    Args:
      proposalId: string, The proposalId to add notes for. (required)
      body: object, The request body. (required)
        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.
            "kind": "adexchangebuyer#marketplaceNote", # Identifies what kind of resource this is. Value: the fixed string "adexchangebuyer#marketplaceNote".
            "proposalRevisionNumber": "A String", # If the note is associated with a proposal revision number, then store that here. (readonly, except on create)
            "dealId": "A String", # Notes can optionally be associated with a deal. (readonly, except on create)
            "note": "A String", # The actual note to attach. (readonly, except on create)
            "proposalId": "A String", # The proposalId that a note is attached to. (readonly)
            "creatorRole": "A String", # The role of the person (buyer/seller) creating the note. (readonly)
            "noteId": "A String", # The unique id for the note. (readonly)
            "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.
            "kind": "adexchangebuyer#marketplaceNote", # Identifies what kind of resource this is. Value: the fixed string "adexchangebuyer#marketplaceNote".
            "proposalRevisionNumber": "A String", # If the note is associated with a proposal revision number, then store that here. (readonly, except on create)
            "dealId": "A String", # Notes can optionally be associated with a deal. (readonly, except on create)
            "note": "A String", # The actual note to attach. (readonly, except on create)
            "proposalId": "A String", # The proposalId that a note is attached to. (readonly)
            "creatorRole": "A String", # The role of the person (buyer/seller) creating the note. (readonly)
            "noteId": "A String", # The unique id for the note. (readonly)
            "timestampMs": "A String", # The timestamp (ms since epoch) that this note was created. (readonly)
          },
        ],
      }

`list(proposalId)`

    Get all the notes associated with a proposal

    Args:
      proposalId: string, The proposalId to get notes for. (required)

    Returns:
      An object of the form:

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