GOgoogle
accounts

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

Changed on

You can opt-in to manually update proposals to indicate that setup is complete. By default, proposal setup is automatically completed after their deals are finalized. Contact your Technical Account Manager to opt in. Buyers can call this method when the proposal has been finalized, and all the required creatives have been uploaded using the Creatives API. This call updates the is_setup_completed field on the deals in the proposal, and notifies the seller. The server then advances the revision number of the most recent proposal. To mark an individual deal as ready to serve, call buyers.finalizedDeals.setReadyToServe in the Marketplace API.

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 mark as setup completed.

Request body

externalDealIdsstring[]

The external deal ids of the deals to mark as setup completed. If empty, all the deals in the proposal will be marked as setup completed.

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