Method: customLists.get

AI-generated Key Takeaways

• Display & Video 360 API v1 is sunset and this documentation details how to get a custom list using the v1 API.

• The API uses an HTTP GET request with path and query parameters to specify the custom list and advertiser ID respectively.

• Authorization is required using the https://www.googleapis.com/auth/display-video OAuth scope.

• A successful request will return a response body containing an instance of CustomList.

Display & Video 360 API v1 has been sunset.

• 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/v1/customLists/{customListId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customListId	string (int64 format) Required. The ID of the custom list to fetch.

Query parameters

Parameters
advertiserId	string (int64 format) 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.