Method: accounts.proposals.update

  • This document explains how to update a proposal with the specified ID for a given buyer account.

  • The request must include the updated proposal details, including any changes to existing deals or the creation of new ones.

  • If a deal in the proposal doesn't have an ID, the server will assign a new one; existing deals omitted in the request will be deleted.

  • Only buyer-modifiable fields will be updated, and an error will occur if the server revision is more recent than the client's.

  • This operation requires authorization with the https://www.googleapis.com/auth/adexchange.buyer scope.

Update the given proposal at the client known revision number. If the server revision has advanced since the passed-in proposal.proposal_revision, an ABORTED error message will be returned. Only the buyer-modifiable fields of the proposal will be updated.

Note that the deals in the proposal will be updated to match the passed-in copy. If a passed-in deal does not have a dealId, the server will assign a new unique ID and create the deal. If passed-in deal has a dealId, it will be updated to match the passed-in copy. Any existing deals not present in the passed-in proposal will be deleted. It is an error to pass in a deal with a dealId not present at head.

HTTP request

PUT https://adexchangebuyer.googleapis.com/v2beta1/accounts/{accountId}/proposals/{proposalId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
accountId

string

Account ID of the buyer.
proposalId

string

The unique ID of the proposal.

Request body

The request body contains an instance of 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