Method: bidders.filterSets.filteredBids.creatives.list

  • This API allows you to list creatives associated with a specific reason for bid filtering and see the number of bids filtered for each creative.

  • The API uses a GET request with specific path and query parameters to filter the results.

  • The request body must be empty, and the response body contains a list of creatives and their filtered bid counts.

  • Authorization requires the https://www.googleapis.com/auth/adexchange.buyer OAuth scope.

List all creatives associated with a specific reason for which bids were filtered, with the number of bids filtered for each creative.

HTTP request

GET https://adexchangebuyer.googleapis.com/v2beta1/{filterSetName=bidders/*/filterSets/*}/filteredBids/{creativeStatusId}/creatives

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
filterSetName

string

Name of the filter set that should be applied to the requested metrics. For example:

  • For a bidder-level filter set for bidder 123: bidders/123/filterSets/abc

  • For an account-level filter set for the buyer account representing bidder 123: bidders/123/accounts/123/filterSets/abc

  • For an account-level filter set for the child seat buyer account 456 whose bidder is 123: bidders/123/accounts/456/filterSets/abc
creativeStatusId

integer

The ID of the creative status for which to retrieve a breakdown by creative. See creative-status-codes.

Query parameters

Parameters
pageSize

integer

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

string

A token identifying a page of results the server should return. Typically, this is the value of ListCreativeStatusBreakdownByCreativeResponse.nextPageToken returned from the previous call to the filteredBids.creatives.list method.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of ListCreativeStatusBreakdownByCreativeResponse.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adexchange.buyer