v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1350108168.1 KB
accounts

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.

get/v2beta1/accounts/{accountId}/proposals

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