Method: bidders.pretargetingConfigs.list
Stay organized with collections
Save and categorize content based on your preferences.
Lists all pretargeting configurations for a single bidder.
HTTP request
GET https://realtimebidding.googleapis.com/v1/{parent=bidders/*}/pretargetingConfigs
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
Required. Name of the bidder whose pretargeting configurations will be listed. Format: bidders/{bidderAccountId}
|
Query parameters
| Parameters |
pageSize |
integer
The maximum number of pretargeting configurations to return. If unspecified, at most 10 pretargeting configurations will be returned. The maximum value is 100; values above 100 will be coerced to 100.
|
pageToken |
string
A token identifying a page of results the server should return. This value is received from a previous pretargetingConfigs.list call in ListPretargetingConfigsResponse.nextPageToken.
|
Request body
The request body must be empty.
Response body
A response containing pretargeting configurations.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"pretargetingConfigs": [
{
object (PretargetingConfig)
}
],
"nextPageToken": string
} |
| Fields |
pretargetingConfigs[] |
object (PretargetingConfig)
List of pretargeting configurations.
|
nextPageToken |
string
A token which can be passed to a subsequent call to the pretargetingConfigs.list method to retrieve the next page of results in ListPretargetingConfigsRequest.pageToken.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/realtime-bidding
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-05-07 UTC.
[null,null,["Last updated 2025-05-07 UTC."],[[["\u003cp\u003eLists proposals, allowing filtering by displayName, dealType, updateTime, and state using Cloud API list filtering syntax.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/authorized-buyers-marketplace\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eRequest is sent as a GET to \u003ccode\u003ehttps://authorizedbuyersmarketplace.googleapis.com/v1alpha/{parent=buyers/*}/proposals\u003c/code\u003e, with parent specifying the buyer account.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a list of proposals and a token for retrieving subsequent pages if results exceed the requested page size.\u003c/p\u003e\n"]]],["This describes how to list pretargeting configurations for a bidder using an HTTP GET request to `https://realtimebidding.googleapis.com/v1/{parent=bidders/*}/pretargetingConfigs`. The `parent` path parameter specifies the bidder's ID. Optional query parameters `pageSize` (max 100) and `pageToken` allow for paginated results. The request body should be empty. The response includes a list of pretargeting configurations and a `nextPageToken` for retrieving subsequent pages, and requires OAuth scope `https://www.googleapis.com/auth/realtime-bidding`.\n"],null,["# Method: bidders.pretargetingConfigs.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListPretargetingConfigsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all pretargeting configurations for a single bidder.\n\n### HTTP request\n\n`GET https://realtimebidding.googleapis.com/v1/{parent=bidders/*}/pretargetingConfigs`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Name of the bidder whose pretargeting configurations will be listed. Format: bidders/{bidderAccountId} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of pretargeting configurations to return. If unspecified, at most 10 pretargeting configurations will be returned. The maximum value is 100; values above 100 will be coerced to 100. |\n| `pageToken` | `string` A token identifying a page of results the server should return. This value is received from a previous `pretargetingConfigs.list` call in [ListPretargetingConfigsResponse.nextPageToken](/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.pretargetingConfigs/list#body.ListPretargetingConfigsResponse.FIELDS.next_page_token). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA response containing pretargeting configurations.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"pretargetingConfigs\": [ { object (/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.pretargetingConfigs#PretargetingConfig) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pretargetingConfigs[]` | `object (`[PretargetingConfig](/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.pretargetingConfigs#PretargetingConfig)`)` List of pretargeting configurations. |\n| `nextPageToken` | `string` A token which can be passed to a subsequent call to the `pretargetingConfigs.list` method to retrieve the next page of results in [ListPretargetingConfigsRequest.pageToken](/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.pretargetingConfigs/list#body.QUERY_PARAMETERS.page_token). |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/realtime-bidding`"]]
