В каждой новой позиции необходимо указать, будет ли в ней показываться политическая реклама Европейского союза (ЕС). Загрузка через Display & Video 360 API и SDF без таких указаний невозможна. Подробнее см.
на странице «Устаревшие» .
Method: advertisers.locationLists.assignedLocations.list
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Перечисляет местоположения, назначенные в список местоположений.
HTTP-запрос
GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
advertiserId | string ( int64 format) Необходимый. Идентификатор рекламодателя DV360, которому принадлежит список местоположений. |
locationListId | string ( int64 format) Необходимый. Идентификатор списка местоположений, которому назначены эти назначения. |
Параметры запроса
Параметры |
---|
pageSize | integer Запрошенный размер страницы. Должно быть от 1 до 200 . Если не указано, по умолчанию будет 100 . Возвращает код ошибки INVALID_ARGUMENT , если указано недопустимое значение. |
pageToken | string Токен, идентифицирующий страницу результатов, которую должен вернуть сервер. Обычно это значение nextPageToken , возвращенное из предыдущего вызова метода assignedLocations.list . Если не указано, будет возвращена первая страница результатов. |
orderBy | string Поле, по которому сортируется список. Приемлемые значения: -
assignedLocationId (по умолчанию)
По умолчанию порядок сортировки — по возрастанию. Чтобы указать порядок убывания поля, к имени поля следует добавить суффикс «desc». Пример: assignedLocationId desc . |
filter | string Позволяет фильтровать по полям назначения списка местоположений. Поддерживаемый синтаксис: - Выражения фильтра состоят из одного или нескольких ограничений.
- Ограничения можно объединить логическим оператором
OR . - Ограничение имеет форму
{field} {operator} {value} . - Во всех полях должен использоваться оператор
EQUALS (=) .
Поддерживаемые поля: Длина этого поля не должна превышать 500 символов. Дополнительную информацию можно найти в нашем руководстве по запросам фильтров LIST . |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответное сообщение для AssignedLocationService.ListAssignedLocations.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"assignedLocations": [
{
object (AssignedLocation )
}
],
"nextPageToken": string
} |
Поля |
---|
assignedLocations[] | object ( AssignedLocation ) Список назначенных локаций. Этот список будет отсутствовать, если он пуст. |
nextPageToken | string Токен для получения следующей страницы результатов. Передайте это значение в поле pageToken при последующем вызове метода assignedLocations.list , чтобы получить следующую страницу результатов. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/display-video
Для получения дополнительной информации см.OAuth 2.0 Overview .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[],["This document outlines how to use the Display & Video 360 API v4's `assignedLocations.list` method to retrieve locations linked to a specific location list. It requires a GET request to a specified URL with path parameters for `advertiserId` and `locationListId`. Optional query parameters include `pageSize`, `pageToken`, `orderBy`, and `filter` for managing results. The API returns a list of `assignedLocations` and a `nextPageToken` if more results are available. OAuth 2.0 authorization with the `display-video` scope is needed.\n"],null,[]]