Method: accounts.proposals.accept
Mark the proposal as accepted at the given revision number. If the number does not match the server's revision number an ABORTED error message will be returned. This call updates the proposalState from PROPOSED to BUYER_ACCEPTED, or from SELLER_ACCEPTED to FINALIZED. Upon calling this endpoint, the buyer implicitly agrees to the terms and conditions optionally set within the proposal by the publisher.
HTTP request
POST https://adexchangebuyer.googleapis.com/v2beta1/accounts/{accountId}/proposals/{proposalId}:accept
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
accountId |
string
Account ID of the buyer.
|
proposalId |
string
The ID of the proposal to accept.
|
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/adexchange.buyer
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."],[[["This endpoint allows buyers to accept a proposal, implicitly agreeing to its terms and conditions."],["The request requires specifying the buyer's account ID, the proposal ID, and the proposal's revision number."],["A successful response returns the updated Proposal object with a state of `BUYER_ACCEPTED` or `FINALIZED`."],["Authorization is required with the `https://www.googleapis.com/auth/adexchange.buyer` scope."],["This action updates the proposal's state from `PROPOSED` to `BUYER_ACCEPTED` or from `SELLER_ACCEPTED` to `FINALIZED`."]]],["This API endpoint facilitates the acceptance of a proposal. A `POST` request is sent to the specified URL, including the `accountId` and `proposalId` in the path. The request body requires a JSON object with `proposalRevision`, representing the last known revision number. Successful execution updates the proposal's state to `BUYER_ACCEPTED` or `FINALIZED`. The response contains a `Proposal` object. The action requires the `https://www.googleapis.com/auth/adexchange.buyer` OAuth scope.\n"]]
