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/v1alpha/{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 allows buyers to accept a proposal at a given revision number, finalizing the agreement.\u003c/p\u003e\n"],["\u003cp\u003eIt requires the \u003ccode\u003ename\u003c/code\u003e path parameter to identify the proposal and \u003ccode\u003eproposalRevision\u003c/code\u003e in the request body to specify the revision.\u003c/p\u003e\n"],["\u003cp\u003eAccepting a proposal signifies the buyer's agreement to the seller's terms and conditions.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns the updated \u003ccode\u003eProposal\u003c/code\u003e object, including the finalized state.\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/v1alpha/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/v1alpha/buyers.proposals#Proposal.FIELDS.state) is already `FINALIZED` and throws exception if the [Proposal.state](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/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/v1alpha/buyers.proposals#Proposal.FIELDS.terms_and_conditions) proposed by the seller.\n\n### HTTP request\n\n`POST https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{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/v1alpha/buyers.proposals#Proposal).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/authorized-buyers-marketplace`"]]