AI-generated Key Takeaways
-
This page details how to get a custom list using the Display & Video 360 API v2, which has sunset.
-
A GET request is made to
https://displayvideo.googleapis.com/v2/customLists/{customListId}
with thecustomListId
as a required path parameter. -
A required union parameter
accessor
is used to identify the DV360 entity making the request, determining accessible custom lists. -
The request body must be empty, and a successful response contains an instance of
CustomList
. -
Authorization requires the
https://www.googleapis.com/auth/display-video
OAuth scope.
- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Gets a custom list.
HTTP request
GET https://displayvideo.googleapis.com/v2/customLists/{customListId}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
customListId |
Required. The ID of the custom list to fetch. |
Query parameters
Parameters | |
---|---|
Union parameter accessor . Required. Identifies which DV360 entity the request is being made within. The GET request will only return custom list entities that are accessible to the DV360 entity identified within the accessor . accessor can be only one of the following: |
|
advertiserId |
The ID of the DV360 advertiser that has access to the fetched custom lists. |
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of CustomList
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/display-video
For more information, see the OAuth 2.0 Overview.