Method: bidders.finalizedDeals.list

  • Use the /v1/buyers/{accountId}/finalizedDeals path to list finalized deals for a specific buyer and its clients, and the /v1/bidders/{accountId}/finalizedDeals path to list finalized deals for a bidder, its buyers, and all their clients.

  • The HTTP request uses a GET method and the URL https://authorizedbuyersmarketplace.googleapis.com/v1/{parent=bidders/*}/finalizedDeals with gRPC Transcoding syntax.

  • The required path parameter parent specifies the buyer or bidder account ID for which to list finalized deals.

  • Optional query parameters include filter, orderBy, pageSize, and pageToken to customize the results of the finalized deals list.

  • A successful response body will contain an instance of ListFinalizedDealsResponse.

Lists finalized deals. Use the URL path "/v1/buyers/{accountId}/finalizedDeals" to list finalized deals for the current buyer and its clients. Bidders can use the URL path "/v1/bidders/{accountId}/finalizedDeals" to list finalized deals for the bidder, its buyers and all their clients.

HTTP request

GET https://authorizedbuyersmarketplace.googleapis.com/v1/{parent=bidders/*}/finalizedDeals

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The buyer to list the finalized deals for, in the format: buyers/{accountId}. When used to list finalized deals for a bidder, its buyers and clients, in the format bidders/{accountId}.

Query parameters

Parameters
filter

string

Optional query string using the Cloud API list filtering syntax Supported columns for filtering are:

  • deal.displayName
  • deal.dealType
  • deal.createTime
  • deal.updateTime
  • deal.flightStartTime
  • deal.flightEndTime
  • deal.eligibleSeatIds
  • dealServingStatus
orderBy

string

An optional query string to sort finalized deals using the Cloud API sorting syntax. If no sort order is specified, results will be returned in an arbitrary order. Supported columns for sorting are:

  • deal.displayName
  • deal.createTime
  • deal.updateTime
  • deal.flightStartTime
  • deal.flightEndTime
  • rtbMetrics.bidRequests7Days
  • rtbMetrics.bids7Days
  • rtbMetrics.adImpressions7Days
  • rtbMetrics.bidRate7Days
  • rtbMetrics.filteredBidRate7Days
  • rtbMetrics.mustBidRateCurrentMonth
pageSize

integer

Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results per page. If unspecified, the server will pick a default page size of 100.
pageToken

string

The page token as returned from ListFinalizedDealsResponse.

Request body

The request body must be empty.

Response body

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

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/authorized-buyers-marketplace