Method: advertisers.lineItems.bulkListAssignedTargetingOptions

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

HTTP-запрос

GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:bulkListAssignedTargetingOptions

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

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

Параметры
advertiserId

string ( int64 format)

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

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

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

string ( int64 format)

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

pageSize

integer

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

pageToken

string

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

orderBy

string

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

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

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

filter

string

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

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

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

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

  • targetingType
  • inheritance

Примеры:

  • Ресурсы AssignedTargetingOption с типом таргетинга TARGETING_TYPE_PROXIMITY_LOCATION_LIST или TARGETING_TYPE_CHANNEL : targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR targetingType="TARGETING_TYPE_CHANNEL"
  • Ресурсы AssignedTargetingOption со статусом наследования NOT_INHERITED или INHERITED_FROM_PARTNER : inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"

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

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

Тело запроса

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

Тело ответа

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

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

object ( LineItemAssignedTargetingOption )

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

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

nextPageToken

string

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

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

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

LineItemAssignedTargetingOption

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

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

string ( int64 format)

Идентификатор позиции, которой назначен назначенный параметр таргетинга.

assignedTargetingOption

object ( AssignedTargetingOption )

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