Method: buyers.proposals.accept
Stay organized with collections
Save and categorize content based on your preferences.
Accepts the proposal at the given revision number. If the revision number in the request is behind the latest from the server, an error message will be returned. This call updates the Proposal.state from BUYER_ACCEPTANCE_REQUESTED to FINALIZED; it has no side effect if the Proposal.state is already FINALIZED and throws exception if the Proposal.state is not either BUYER_ACCEPTANCE_REQUESTED or FINALIZED. Accepting a proposal means the buyer understands and accepts the Proposal.terms_and_conditions proposed by the seller.
HTTP request
POST https://authorizedbuyersmarketplace.googleapis.com/v1/{name=buyers/*/proposals/*}:accept
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
name |
string
Name of the proposal. Format: buyers/{accountId}/proposals/{proposalId}
|
Request body
The request body contains data with the following structure:
| JSON representation |
{
"proposalRevision": string
} |
| Fields |
proposalRevision |
string (int64 format)
The last known client revision number of the proposal.
|
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 2025-06-12 UTC.
[null,null,["Last updated 2025-06-12 UTC."],[[["\u003cp\u003eThis endpoint is used to accept a proposal at a given revision number, finalizing it if the revision matches the server's.\u003c/p\u003e\n"],["\u003cp\u003eThe request must include the proposal's name using the format \u003ccode\u003ebuyers/{accountId}/proposals/{proposalId}\u003c/code\u003e and the \u003ccode\u003eproposalRevision\u003c/code\u003e in the request body.\u003c/p\u003e\n"],["\u003cp\u003eIf the proposal's state is not \u003ccode\u003eBUYER_ACCEPTANCE_REQUESTED\u003c/code\u003e or \u003ccode\u003eFINALIZED\u003c/code\u003e, the request will result in an error.\u003c/p\u003e\n"],["\u003cp\u003eA successful response will return the updated \u003ccode\u003eProposal\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/authorized-buyers-marketplace\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: buyers.proposals.accept\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nAccepts the proposal at the given revision number. If the revision number in the request is behind the latest from the server, an error message will be returned. This call updates the [Proposal.state](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals#Proposal.FIELDS.state) from `BUYER_ACCEPTANCE_REQUESTED` to `FINALIZED`; it has no side effect if the [Proposal.state](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals#Proposal.FIELDS.state) is already `FINALIZED` and throws exception if the [Proposal.state](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals#Proposal.FIELDS.state) is not either `BUYER_ACCEPTANCE_REQUESTED` or `FINALIZED`. Accepting a proposal means the buyer understands and accepts the [Proposal.terms_and_conditions](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals#Proposal.FIELDS.terms_and_conditions) proposed by the seller.\n\n### HTTP request\n\n`POST https://authorizedbuyersmarketplace.googleapis.com/v1/{name=buyers/*/proposals/*}:accept`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------|\n| `name` | `string` Name of the proposal. Format: `buyers/{accountId}/proposals/{proposalId}` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------|\n| ``` { \"proposalRevision\": string } ``` |\n\n| Fields ||\n|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------|\n| `proposalRevision` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The last known client revision number of the proposal. |\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`"]]
