Method: bidders.filterSets.nonBillableWinningBids.list

  • This document provides details on how to list reasons for non-billable winning bids using a specific HTTP request with defined path and query parameters.

  • The request uses a GET method to retrieve non-billable winning bids associated with a given filter set name.

  • Path parameters include filterSetName to specify the relevant bidder or account-level filter set.

  • Query parameters such as pageSize and pageToken can be used for pagination of the results.

  • A successful request returns a ListNonBillableWinningBidsResponse in the response body, and the request requires the https://www.googleapis.com/auth/adexchange.buyer authorization scope.

List all reasons for which winning bids were not billable, with the number of bids not billed for each reason.

HTTP request

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

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

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 ListNonBillableWinningBidsResponse.nextPageToken returned from the previous call to the nonBillableWinningBids.list method.

Request body

The request body must be empty.

Response body

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

Authorization Scopes

Requires the following OAuth scope:

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