Method: buyers.proposals.cancelNegotiation

  • Cancels an ongoing negotiation on a proposal without impacting existing deals if the proposal has been finalized.

  • Sets the proposal state to TERMINATED for unfinalized proposals and to FINALIZED for finalized proposals under renegotiation, incrementing the proposal revision in both cases.

  • This method is not applicable to private auction proposals and requires the https://www.googleapis.com/auth/authorized-buyers-marketplace authorization scope.

  • The request body must be empty and a successful response returns the updated Proposal object.

Cancels an ongoing negotiation on a proposal. This does not cancel or end serving for the deals if the proposal has been finalized. If the proposal has not been finalized before, calling this method will set the Proposal.state to TERMINATED and increment the Proposal.proposal_revision. If the proposal has been finalized before and is under renegotiation now, calling this method will reset the Proposal.state to FINALIZED and increment the Proposal.proposal_revision. This method does not support private auction proposals whose Proposal.deal_type is 'PRIVATE_AUCTION'.

HTTP request

POST https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{proposal=buyers/*/proposals/*}:cancelNegotiation

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
proposal

string

Name of the proposal. Format: buyers/{accountId}/proposals/{proposalId}

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Proposal.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/authorized-buyers-marketplace