Method: advertisers.locationLists.get

AI-generated Key Takeaways

• This document explains how to use the Display & Video 360 API to get a location list for a given advertiser.

• The request requires providing the advertiser ID and location list ID as path parameters.

• Upon successful execution, the API returns a LocationList object containing the details of the specified location list.

• Authorization using OAuth 2.0 with the https://www.googleapis.com/auth/display-video scope is necessary to access this functionality.

• Display & Video 360 API v1 is sunset and the linked document highlights the gRPC Transcoding syntax for URL usage.

Display & Video 360 API v1 has been sunset.

• HTTP request
• Path parameters
• Request body
• Response body
• Authorization Scopes
• Try it!

Gets a location list.

HTTP request

GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/locationLists/{locationListId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId	string (int64 format) Required. The ID of the DV360 advertiser to which the fetched location list belongs.
locationListId	string (int64 format) Required. The ID of the location list to fetch.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of LocationList.

Authorization Scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/display-video

For more information, see the OAuth 2.0 Overview.