Method: buyers.proposals.cancelNegotiation
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/v1/{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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[null,null,["Last updated 2024-09-18 UTC."],[[["Cancels an ongoing proposal negotiation without impacting finalized deals, potentially terminating or resetting the proposal state."],["Uses an HTTP POST request to a specific endpoint with the proposal identified in the path parameters."],["Requires an empty request body and returns the updated Proposal object in the response."],["Needs authorization with the `https://www.googleapis.com/auth/authorized-buyers-marketplace` scope."],["Does not support private auction proposals with the 'PRIVATE_AUCTION' deal type."]]],["This API method cancels ongoing negotiations for a proposal. It uses a POST request to a specific URL, formatted with the proposal's name as a path parameter. The request body is empty. If the proposal was not finalized, the state is set to `TERMINATED`; otherwise, it reverts to `FINALIZED`. In both cases `Proposal.proposal_revision` is incremented. This method doesn't apply to private auction proposals. A successful call returns a `Proposal` object. The call requires a specific authorization scope.\n"]]