REST Resource: buyers.proposals

{
  "name": string,
  "updateTime": string,
  "proposalRevision": string,
  "dealType": enum (DealType),
  "displayName": string,
  "state": enum (State),
  "isRenegotiating": boolean,
  "originatorRole": enum (BuyerSellerRole),
  "publisherProfile": string,
  "buyerPrivateData": {
    object (PrivateData)
  },
  "billedBuyer": string,
  "sellerContacts": [
    {
      object (Contact)
    }
  ],
  "buyerContacts": [
    {
      object (Contact)
    }
  ],
  "lastUpdaterOrCommentorRole": enum (BuyerSellerRole),
  "termsAndConditions": string,
  "pausingConsented": boolean,
  "notes": [
    {
      object (Note)
    }
  ],

  // Union field negotiating_buyer can be only one of the following:
  "buyer": string,
  "client": string
  // End of list of possible types for union field negotiating_buyer.
}

string

Immutable. The name of the proposal serving as a unique identifier. Format: buyers/{accountId}/proposals/{proposalId}

string (Timestamp format)

Output only. The time when the proposal was last revised.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

string (int64 format)

Output only. The revision number for the proposal. Each update to the proposal or deal causes the proposal revision number to auto-increment. The buyer keeps track of the last revision number they know of and pass it in when making an update. If the head revision number on the server has since incremented, then an ABORTED error is returned during the update operation to let the buyer know that a subsequent update was made.

enum (DealType)

Output only. Type of deal the proposal contains.

string

Output only. The descriptive name for the proposal. Maximum length of 255 unicode characters is allowed. Control characters are not allowed. Buyers cannot update this field. Note: Not to be confused with name, which is a unique identifier of the proposal.

enum (State)

Output only. Indicates the state of the proposal.

boolean

Output only. True if the proposal was previously finalized and is now being renegotiated.

enum (BuyerSellerRole)

Output only. Indicates whether the buyer/seller created the proposal.

string

Immutable. Reference to the seller on the proposal. Format: buyers/{buyerAccountId}/publisherProfiles/{publisherProfileId} Note: This field may be set only when creating the resource. Modifying this field while updating the resource will result in an error.

object (PrivateData)

Buyer private data (hidden from seller).

string

Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer. Format : buyers/{buyerAccountId}

object (Contact)

Output only. Contact information for the seller.

object (Contact)

Contact information for the buyer.

enum (BuyerSellerRole)

Output only. The role of the last user that either updated the proposal or left a comment.

string

Output only. The terms and conditions associated with this proposal. Accepting a proposal implies acceptance of this field. This is created by the seller, the buyer can only view it.

boolean

Whether pausing is allowed for the proposal. This is a negotiable term between buyers and publishers.

object (Note)

A list of notes from the buyer and the seller attached to this proposal.

string

Output only. Refers to a buyer in [The Realtime-bidding API][google.ads.realtimebidding.v1.Buyer]. Format: buyers/{buyerAccountId}

string

Output only. Refers to a Client. Format: buyers/{buyerAccountId}/clients/{clientAccountid}

{
  "referenceId": string
}

string

A buyer specified reference ID. This can be queried in the list operations (max-length: 1024 unicode code units).

{
  "email": string,
  "displayName": string
}

string

Email address for the contact.

string

The displayName of the contact.

{
  "createTime": string,
  "creatorRole": enum (BuyerSellerRole),
  "note": string
}

string (Timestamp format)

Output only. When this note was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

enum (BuyerSellerRole)

Output only. The role who created the note.

string

The text of the note. Maximum length is 1024 characters.