Method: buyers.proposals.cancelNegotiation
Stay organized with collections
Save and categorize content based on your preferences.
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."],[[["\u003cp\u003eCancels an ongoing proposal negotiation without impacting finalized deals, potentially terminating or resetting the proposal state.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP POST request to a specific endpoint with the proposal identified in the path parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and returns the updated Proposal object in the response.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/authorized-buyers-marketplace\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eDoes not support private auction proposals with the 'PRIVATE_AUCTION' deal type.\u003c/p\u003e\n"]]],["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"],null,["# Method: buyers.proposals.cancelNegotiation\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCancels 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](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals#Proposal.FIELDS.state) to `TERMINATED` and increment the [Proposal.proposal_revision](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals#Proposal.FIELDS.proposal_revision). If the proposal has been finalized before and is under renegotiation now, calling this method will reset the [Proposal.state](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals#Proposal.FIELDS.state) to `FINALIZED` and increment the [Proposal.proposal_revision](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals#Proposal.FIELDS.proposal_revision). This method does not support private auction proposals whose [Proposal.deal_type](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals#Proposal.FIELDS.deal_type) is 'PRIVATE_AUCTION'.\n\n### HTTP request\n\n`POST https://authorizedbuyersmarketplace.googleapis.com/v1/{proposal=buyers/*/proposals/*}:cancelNegotiation`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------|\n| `proposal` | `string` Name of the proposal. Format: `buyers/{accountId}/proposals/{proposalId}` |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Proposal](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals#Proposal).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/authorized-buyers-marketplace`"]]