GOgoogle
accounts

GET /v2beta1/accounts/{accountId}/proposals

Changed on

List proposals. A filter expression (PQL query) may be specified to filter the results. To retrieve all finalized proposals, regardless if a proposal is being renegotiated, see the FinalizedProposals resource. Note that Bidder/ChildSeat relationships differ from the usual behavior. A Bidder account can only see its child seats' proposals by specifying the ChildSeat's accountId in the request path.

Request

  • Base URL
    https://adexchangebuyer.googleapis.com
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/adexchange.buyer
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/adexchange.buyer

Path parameters

accountIdstring required

Account ID of the buyer.

Query parameters

filterstring

An optional PQL filter query used to query for proposals. Nested repeated fields, such as proposal.deals.targetingCriterion, cannot be filtered.

filterSyntax'FILTER_SYNTAX_UNSPECIFIED' | 'PQL' | 'LIST_FILTER'

Syntax the filter is written in. Current implementation defaults to PQL but in the future it will be LIST_FILTER.

pageSizeinteger

Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.

pageTokenstring

The page token as returned from ListProposalsResponse.

Response

Successful response

nextPageTokenstring

Continuation token for fetching the next page of results.

Changes