Method: buyers.proposals.accept

  • This endpoint is used to accept a proposal at a given revision number, finalizing it if the revision matches the server's.

  • The request must include the proposal's name using the format buyers/{accountId}/proposals/{proposalId} and the proposalRevision in the request body.

  • If the proposal's state is not BUYER_ACCEPTANCE_REQUESTED or FINALIZED, the request will result in an error.

  • A successful response will return the updated Proposal object.

  • Authorization requires the https://www.googleapis.com/auth/authorized-buyers-marketplace scope.

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