Method: exchanges.inventorySources.list
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*}/inventorySources
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
parent |
string
Required. The parent resource name. Example: "exchanges/123".
|
Query parameters
Parameters |
pageSize |
integer
Optional. The maximum number of items to return. Defaults to 100. Max allowed value is 500. If unspecified, 100 will be default page size. If pageSize is more than 500, will use 500 as page size.
|
pageToken |
string
Optional. The nextPageToken value returned from a previous List request, if any.
|
filter |
string
Optional. Allows filtering by product properties. Supported syntax:
- Filter expressions are made up of one or more restrictions.
- Restrictions can be combined by
AND logical operators.
- A restriction has the form of
<field> <operator> <value> .
- The operator must be
> or '>=' for last_modified_time
- Supported fields:
Examples:
- Get InventorySource with last_modified_time greater than 04/21/2023 11:30
last_modified_time>"2023-04-21T11:30:00-04:00"
If last_modified_time is not specified, the value will be default to -7 days timestamp. The length of this field should be no more than 500 characters.
|
Request body
The request body must be empty.
Response body
Response to list inventory sources.
If successful, the response body contains data with the following structure:
JSON representation |
{
"inventorySources": [
{
object (InventorySource )
}
],
"nextPageToken": string
} |
Fields |
inventorySources[] |
object (InventorySource )
Listed inventory sources. There will be a maximum number of items returned based on the pageSize field in the request.
|
nextPageToken |
string
Token to retrieve the next page of results, or empty if there are no more results in the list.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/doubleclickbidmanager
For more information, see the OAuth 2.0 Overview.
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-21 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-21 UTC."],[[["\u003cp\u003eLists inventory sources within a specified exchange using the \u003ccode\u003eGET\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by \u003ccode\u003elast_modified_time\u003c/code\u003e and pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes an array of \u003ccode\u003eInventorySource\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclickbidmanager\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This API lists inventory sources via a `GET` request to a specified URL, using gRPC Transcoding syntax. It requires a `parent` path parameter (e.g., \"exchanges/123\"). Optional query parameters include `pageSize` (default 100, max 500), `pageToken`, and a `filter` for product properties, specifically `last_modified_time`. The request body must be empty. The response includes an array of `inventorySources` and a `nextPageToken` for pagination. Authorization requires the `doubleclickbidmanager` OAuth scope.\n"],null,["- [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.ListInventorySourcesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nLists inventory sources.\n\nHTTP request\n\n`GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*}/inventorySources`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource name. Example: \"exchanges/123\". |\n\nQuery parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Optional. The maximum number of items to return. Defaults to 100. Max allowed value is 500. If unspecified, 100 will be default page size. If pageSize is more than 500, will use 500 as page size. |\n| `pageToken` | `string` Optional. The nextPageToken value returned from a previous List request, if any. |\n| `filter` | `string` Optional. Allows filtering by product properties. Supported syntax: - Filter expressions are made up of one or more restrictions. - Restrictions can be combined by `AND` logical operators. - A restriction has the form of `\u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e`. - The operator must be `\u003e` or '\\\u003e=' for last_modified_time - Supported fields: - `last_modified_time` Examples: - Get InventorySource with last_modified_time greater than 04/21/2023 11:30 `last_modified_time\u003e\"2023-04-21T11:30:00-04:00\"` If last_modified_time is not specified, the value will be default to -7 days timestamp. The length of this field should be no more than 500 characters. |\n\nRequest body\n\nThe request body must be empty.\n\nResponse body Response to list inventory sources.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"inventorySources\": [ { object (/display-video/seller/reference/rest/v1beta1/exchanges.inventorySources#InventorySource) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `inventorySources[]` | `object (`[InventorySource](/display-video/seller/reference/rest/v1beta1/exchanges.inventorySources#InventorySource)`)` Listed inventory sources. There will be a maximum number of items returned based on the pageSize field in the request. |\n| `nextPageToken` | `string` Token to retrieve the next page of results, or empty if there are no more results in the list. |\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/doubleclickbidmanager`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]