Method: accounts.proposals.completeSetup
You can opt-in to manually update proposals to indicate that setup is complete. By default, proposal setup is automatically completed after their deals are finalized. Contact your Technical Account Manager to opt in.
Buyers can call this method when the proposal has been finalized, and all the required creatives have been uploaded using the Creatives API.
This call updates the is_setup_completed field on the deals in the proposal, and notifies the seller. The server then advances the revision number of the most recent proposal.
To mark an individual deal as ready to serve, call buyers.finalizedDeals.setReadyToServe in the Marketplace API.
HTTP request
POST https://adexchangebuyer.googleapis.com/v2beta1/accounts/{accountId}/proposals/{proposalId}:completeSetup
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
accountId |
string
Account ID of the buyer.
|
proposalId |
string
The ID of the proposal to mark as setup completed.
|
Request body
The request body must be empty.
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 method allows buyers to notify the seller that a proposal is ready for serving after finalization and creative uploads."],["It updates the proposal status and triggers a notification to the seller, advancing the proposal's revision number."],["Buyers need to use their Account ID and Proposal ID for this POST request, with an empty body."],["Successful execution returns the updated Proposal object."],["This functionality requires the `https://www.googleapis.com/auth/adexchange.buyer` authorization scope."]]],["Buyers can manually complete proposal setup after deals are finalized and creatives uploaded. This is done by making a `POST` request to `https://adexchangebuyer.googleapis.com/v2beta1/accounts/{accountId}/proposals/{proposalId}:completeSetup`, with an empty request body. The `accountId` and `proposalId` path parameters are required. Successful completion updates the `is_setup_completed` field, notifies the seller, and advances the proposal's revision number. The response will be a `Proposal` instance, and the `adexchange.buyer` authorization scope is needed.\n"]]
