StartingSeptember 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See ourdeprecations pagefor more details on how to update your integration to make this declaration.
Lists inventory sources that are accessible to the current user.
The order is defined by theorderByparameter. If afilterbyentityStatusis not specified, inventory sources with entity statusENTITY_STATUS_ARCHIVEDwill not be included in the results.
HTTP request
GET https://displayvideo.googleapis.com/v3/inventorySources
Requested page size. Must be between1and200. If unspecified will default to100.
pageToken
string
A token identifying a page of results the server should return. Typically, this is the value ofnextPageTokenreturned from the previous call toinventorySources.listmethod. If not specified, the first page of results will be returned.
orderBy
string
Field by which to sort the list. Acceptable values are:
displayName(default)
The default sorting order is ascending. To specify descending order for a field, a suffix "desc" should be added to the field name. For example,displayName desc.
filter
string
Allows filtering by inventory source fields.
Supported syntax:
Filter expressions are made up of one or more restrictions.
Restrictions can be combined byANDorORlogical operators. A sequence of restrictions implicitly usesAND.
A restriction has the form of{field} {operator} {value}.
All fields must use theEQUALS (=)operator.
Supported fields:
status.entityStatus
commitment
deliveryMethod
rateDetails.rateType
exchange
Examples:
All active inventory sources:status.entityStatus="ENTITY_STATUS_ACTIVE"
Inventory sources belonging to Google Ad Manager or Rubicon exchanges:exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"
The length of this field should be no more than 500 characters.
Union parameteraccessor. Required. Identifies which DV360 entity the request is being made within. The LIST request will only return inventory source entities that are accessible to the DV360 entity identified within theaccessor.accessorcan be only one of the following:
A token to retrieve the next page of results. Pass this value in thepageTokenfield in the subsequent call toinventorySources.listmethod to retrieve the next page of results.
[[["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-04-02 UTC."],[[["\u003cp\u003eLists inventory sources accessible to the current user, ordered by \u003ccode\u003eorderBy\u003c/code\u003e parameter and excluding archived sources unless filtered.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e for retrieving results in manageable chunks.\u003c/p\u003e\n"],["\u003cp\u003eOffers filtering options using the \u003ccode\u003efilter\u003c/code\u003e parameter for refining results based on entity status, commitment, delivery method, rate type, or exchange.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying an \u003ccode\u003eaccessor\u003c/code\u003e (either \u003ccode\u003epartnerId\u003c/code\u003e or \u003ccode\u003eadvertiserId\u003c/code\u003e) to identify the DV360 entity for access control.\u003c/p\u003e\n"],["\u003cp\u003eUses \u003ccode\u003eGET\u003c/code\u003e request to \u003ccode\u003ehttps://displayvideo.googleapis.com/v3/inventorySources\u003c/code\u003e and requires \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e authorization scope.\u003c/p\u003e\n"]]],["This API lists accessible inventory sources for a user via a `GET` request to `https://displayvideo.googleapis.com/v3/inventorySources`. Key parameters include `pageSize`, `pageToken`, `orderBy` for sorting, and `filter` for filtering by fields like `entityStatus`, `commitment`, or `exchange`. The request body must be empty. The response includes a list of inventory sources and a `nextPageToken` for pagination. The call requires authorization scope: `https://www.googleapis.com/auth/display-video`. A union parameter called `accessor` is required to identify the DV360 entity the request is being made from.\n"],null,[]]
