GOgoogle
accounts

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

Changed on

Update the given proposal to pause serving. This method will set the DealServingMetadata.DealPauseStatus.has_buyer_paused bit to true for all deals in the proposal. It is a no-op to pause an already-paused proposal. It is an error to call PauseProposal for a proposal that is not finalized or renegotiating.

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 pause.

Request body

reasonstring

The reason why the proposal is being paused. This human readable message will be displayed in the seller's UI. (Max length: 1000 unicode code units.)

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