A partir de 8 de setembro de 2025, todos os novos itens de linha precisarão declarar se vão veicular anúncios políticos da União Europeia (UE). As APIs do Display & Video 360 e os uploads de SDF que não fornecem declarações vão falhar. Consulte nossa página de suspensões de uso para mais detalhes sobre como atualizar sua integração e fazer essa declaração.
Obrigatório. O ID do anunciante do DV360 a que as listas de locais extraídas pertencem.
Parâmetros de consulta
Parâmetros
pageSize
integer
Tamanho da página solicitada. O valor precisa estar entre 1 e 200. O padrão é 100, caso não esteja definido. Retorna o código de erro INVALID_ARGUMENT se um valor inválido for especificado.
pageToken
string
Um token que identifica a página de resultados que o servidor retornará.
Normalmente, esse é o valor de nextPageToken retornado da chamada anterior para o método locationLists.list. Se não for especificado, a primeira página de resultados será retornada.
orderBy
string
Campo que classifica a lista. Os valores aceitáveis são:
locationListId (padrão)
displayName
A ordem de classificação padrão é crescente. Para especificar a ordem decrescente de um campo, adicione o sufixo "desc" ao nome dele. Exemplo: displayName desc.
filter
string
Permite filtrar por campos de lista de locais.
Sintaxe aceita:
As expressões de filtro são compostas por uma ou mais restrições.
As restrições podem ser combinadas por operadores lógicos AND ou OR. Uma sequência de restrições usa AND implicitamente.
Uma restrição tem o formato {field} {operator} {value}.
Todos os campos precisam usar o operador EQUALS (=).
Campos compatíveis:
locationType
Exemplos:
Lista de todos os locais regionais: locationType="TARGETING_LOCATION_TYPE_REGIONAL"
Lista de todos os locais de proximidade: locationType="TARGETING_LOCATION_TYPE_PROXIMITY"
O comprimento deste campo não pode exceder 500 caracteres.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eLists location lists for a given advertiser using the \u003ccode\u003elocationLists.list\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eFilter results by location type, page size, page token, and order.\u003c/p\u003e\n"],["\u003cp\u003eRequest requires advertiser ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a list of location lists and a token for the next page.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document outlines how to retrieve location lists for a specific DV360 advertiser using a `GET` request to the provided URL. The request requires the `advertiserId` as a path parameter. Optional query parameters include `pageSize`, `pageToken`, `orderBy`, and `filter` to control pagination, sorting, and filtering. The request body should be empty. The successful response contains a list of location list objects and a `nextPageToken` for further pagination. It requires `https://www.googleapis.com/auth/display-video` authorization.\n"],null,["# Method: advertisers.locationLists.list\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\n- [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.ListLocationListsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists location lists based on a given advertiser id.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/locationLists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the DV360 advertiser to which the fetched location lists belong. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. Must be between `1` and `200`. Defaults to `100` if not set. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [nextPageToken](/display-video/api/reference/rest/v3/advertisers.locationLists/list#body.ListLocationListsResponse.FIELDS.next_page_token) returned from the previous call to `locationLists.list` method. If not specified, the first page of results will be returned. |\n| `orderBy` | `string` Field by which to sort the list. Acceptable values are: - `locationListId` (default) - `displayName` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`. |\n| `filter` | `string` Allows filtering by location list fields. Supported syntax: - Filter expressions are made up of one or more restrictions. - Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. - A restriction has the form of `{field} {operator} {value}`. - All fields must use the `EQUALS (=)` operator. Supported fields: - `locationType` Examples: - All regional location list: `locationType=\"TARGETING_LOCATION_TYPE_REGIONAL\"` - All proximity location list: `locationType=\"TARGETING_LOCATION_TYPE_PROXIMITY\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"locationLists\": [ { object (/display-video/api/reference/rest/v3/advertisers.locationLists#LocationList) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `locationLists[]` | `object (`[LocationList](/display-video/api/reference/rest/v3/advertisers.locationLists#LocationList)`)` The list of location lists. This list will be absent if empty. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [pageToken](/display-video/api/reference/rest/v3/advertisers.locationLists/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to `locationLists.list` method to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
