GOgoogle
accounts

POST /v2beta1/accounts/{accountId}/proposals/{proposalId}:accept

Changed on

Mark the proposal as accepted at the given revision number. If the number does not match the server's revision number an ABORTED error message will be returned. This call updates the proposal_state from PROPOSED to BUYER_ACCEPTED, or from SELLER_ACCEPTED to FINALIZED. Upon calling this endpoint, the buyer implicitly agrees to the terms and conditions optionally set within the proposal by the publisher.

Request

  • Base URL
    https://adexchangebuyer.googleapis.com
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/adexchange.buyer
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/adexchange.buyer

Path parameters

accountIdstring required

Account ID of the buyer.

proposalIdstring required

The ID of the proposal to accept.

Request body

proposalRevisionstring int64

The last known client revision number of the proposal.

Response

Successful response

displayNamestring

The name for the proposal.

isRenegotiatingboolean

Output only. True if the proposal is being renegotiated.

isSetupCompleteboolean

Output only. True, if the buyside inventory setup is complete for this proposal.

lastUpdaterOrCommentorRole'BUYER_SELLER_ROLE_UNSPECIFIED' | 'BUYER' | 'SELLER'

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

originatorRole'BUYER_SELLER_ROLE_UNSPECIFIED' | 'BUYER' | 'SELLER'

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

privateAuctionIdstring

Output only. Private auction ID if this proposal is a private auction proposal.

proposalIdstring

Output only. The unique ID of the proposal.

proposalRevisionstring int64

Output only. The revision number for the proposal. Each update to the proposal or the 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.

proposalState'PROPOSAL_STATE_UNSPECIFIED' | 'PROPOSED' | 'BUYER_ACCEPTED' | 'SELLER_ACCEPTED' | 'CANCELED' | 'FINALIZED'

Output only. The current state of the proposal.

termsAndConditionsstring

Output only. The terms and conditions set by the publisher for this proposal.

updateTimestring google-datetime

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

Changes

  • af1a744df07bRevision changes
    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status