Method: advertisers.adGroups.bulkListAssignedTargetingOptions

Перечисляет назначенные параметры таргетинга для нескольких групп объявлений по типам таргетинга.

Унаследованные назначенные параметры таргетинга не учитываются.

HTTP-запрос

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkListAssignedTargetingOptions

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
advertiserId

string ( int64 format)

Необходимый. Идентификатор рекламодателя, которому принадлежит позиция.

Параметры запроса

Параметры
adGroupIds[]

string ( int64 format)

Необходимый. Идентификаторы групп объявлений, для которых нужно указать назначенные параметры таргетинга.

pageSize

integer

Необязательный. Запрошенный размер страницы. Размер должен быть целым числом от 1 до 5000 . Если не указано, значение по умолчанию — 5000 . Возвращает код ошибки INVALID_ARGUMENT , если указано недопустимое значение.

pageToken

string

Необязательный. Токен, который позволяет клиенту получить следующую страницу результатов. Обычно это значение nextPageToken возвращенное в результате предыдущего вызова метода BulkListAdGroupAssignedTargetingOptions . Если не указано, будет возвращена первая страница результатов.

orderBy

string

Необязательный. Поле, по которому сортируется список. Приемлемые значения:

  • adGroupId (по умолчанию)
  • assignedTargetingOption.targetingType

По умолчанию порядок сортировки — по возрастанию. Чтобы указать порядок убывания поля, к имени поля следует добавить суффикс «desc». Пример: targetingType desc .

filter

string

Необязательный. Позволяет фильтровать по назначенным полям параметров таргетинга.

Поддерживаемый синтаксис:

  • Выражения фильтра состоят из одного или нескольких ограничений.
  • Ограничения можно объединить логическим оператором OR .
  • Ограничение имеет форму {field} {operator} {value} .
  • Во всех полях должен использоваться оператор EQUALS (=) .

Поддерживаемые поля:

  • targetingType

Примеры:

  • Ресурсы AssignedTargetingOption с типом таргетинга TARGETING_TYPE_YOUTUBE_VIDEO или TARGETING_TYPE_YOUTUBE_CHANNEL : targetingType="TARGETING_TYPE_YOUTUBE_VIDEO" OR targetingType="TARGETING_TYPE_YOUTUBE_CHANNEL"

Длина этого поля не должна превышать 500 символов.

Дополнительную информацию можно найти в нашем руководстве по запросам фильтров LIST .

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "adGroupAssignedTargetingOptions": [
    {
      object (AdGroupAssignedTargetingOption)
    }
  ],
  "nextPageToken": string
}
Поля
adGroupAssignedTargetingOptions[]

object ( AdGroupAssignedTargetingOption )

Список объектов-оболочек, каждый из которых предоставляет назначенный параметр таргетинга и группу объявлений, которой он назначен.

Этот список будет отсутствовать, если он пуст.

nextPageToken

string

Токен, идентифицирующий следующую страницу результатов. Это значение должно быть указано как pageToken при последующем вызове BulkListAdGroupAssignedTargetingOptions для получения следующей страницы результатов. Этот токен будет отсутствовать, если больше не будет возвращаемых ресурсов AdGroupAssignedTargetingOption .

Области авторизации

Требуется следующая область действия OAuth:

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

Для получения дополнительной информации см.OAuth 2.0 Overview .

AdGroupAssignedTargetingOption

Объект-оболочка, связывающий ресурс AssignedTargetingOption и группу объявлений, которой он назначен.

JSON-представление 
{
  "adGroupId": string,
  "assignedTargetingOption": {
    object (AssignedTargetingOption)
  }
}
Поля
adGroupId

string ( int64 format)

Идентификатор группы объявлений, которой назначен назначенный параметр таргетинга.

assignedTargetingOption

object ( AssignedTargetingOption )

Назначенный ресурс параметра таргетинга.