Method: buyers.proposals.accept

  • This API accepts a proposal at a given revision number, updating its state to FINALIZED if it was BUYER_ACCEPTANCE_REQUESTED.

  • Accepting a proposal signifies that the buyer understands and accepts the seller's terms and conditions.

  • The request requires the proposal's name and the last known client revision number in the request body.

  • A successful response returns an instance of the Proposal.

  • The API requires the https://www.googleapis.com/auth/authorized-buyers-marketplace OAuth scope for authorization.

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