Method: accounts.proposals.update

  • This page describes how to update a proposal using the PUT method and specifies the required URL, path parameters, request body, and response body.

  • Updating a proposal requires the client known revision number and will return an ABORTED error if the server revision has advanced.

  • Only buyer-modifiable fields of the proposal can be updated, and deals within the proposal will be updated or created based on the provided data, with existing deals not present being deleted.

  • The update operation requires the https://www.googleapis.com/auth/adexchange.buyer OAuth scope for authorization.

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