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/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
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 negotiation on a proposal without impacting existing deals if the proposal has been finalized.\u003c/p\u003e\n"],["\u003cp\u003eSets the proposal state to \u003ccode\u003eTERMINATED\u003c/code\u003e for unfinalized proposals and to \u003ccode\u003eFINALIZED\u003c/code\u003e for finalized proposals under renegotiation, incrementing the proposal revision in both cases.\u003c/p\u003e\n"],["\u003cp\u003eThis method is not applicable to private auction proposals and requires the \u003ccode\u003ehttps://www.googleapis.com/auth/authorized-buyers-marketplace\u003c/code\u003e authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty and a successful response returns the updated \u003ccode\u003eProposal\u003c/code\u003e object.\u003c/p\u003e\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/v1alpha/buyers.proposals#Proposal.FIELDS.state) to `TERMINATED` and increment the [Proposal.proposal_revision](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/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/v1alpha/buyers.proposals#Proposal.FIELDS.state) to `FINALIZED` and increment the [Proposal.proposal_revision](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.proposals#Proposal.FIELDS.proposal_revision). This method does not support private auction proposals whose [Proposal.deal_type](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.proposals#Proposal.FIELDS.deal_type) is 'PRIVATE_AUCTION'.\n\n### HTTP request\n\n`POST https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{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/v1alpha/buyers.proposals#Proposal).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/authorized-buyers-marketplace`"]]
