Method: partners.inventorySources.list

Возвращает список сделок, относящихся к источнику инвентаря.

HTTP-запрос

GET https://displayvideo.googleapis.com/v5/partners/{partnerId}/inventorySources

URL имеет синтаксис gRPC Transcoding.

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

Параметры
Обязательно. Идентификатор объекта DV360, в рамках которого выполняется запрос. Запрос LIST возвращает только объекты источников инвентаря, доступные объекту DV360, указанному в accessor. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
partnerId

string (int64 format)

Идентификатор партнера DV360.
Конец взаимоисключающих полей.

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

Параметры
pageSize

integer

Необязательное поле. Запрошенный размер страницы. Значение должно быть в диапазоне от 1 до 200. Если не указано, по умолчанию будет использоваться 100.
pageToken

string

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

string

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

  • displayName (по умолчанию)

По умолчанию используется порядок сортировки по возрастанию. Чтобы указать порядок по убыванию, добавьте к названию поля суффикс desc. например displayName desc (2-е издание).
filter

string

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

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

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

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

  • status.entityStatus
  • commitment
  • deliveryMethod
  • rateDetails.rateType
  • exchange

Примеры:

  • Все активные источники инвентаря: status.entityStatus="ENTITY_STATUS_ACTIVE"
  • Источники инвентаря, относящиеся к Google Менеджеру рекламы или биржам Rubicon: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"

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

Подробную информацию вы найдете в руководстве по фильтрации запросов LIST.
Обязательно. Идентификатор объекта DV360, в рамках которого выполняется запрос. Запрос LIST возвращает только объекты источников инвентаря, доступные объекту DV360, указанному в accessor. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
advertiserId

string (int64 format)

Идентификатор рекламодателя DV360.
Конец взаимоисключающих полей.

Тело запроса

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

Тело ответа

Если ответ получен успешно, его тело содержит экземпляр ListInventorySourceDealsResponse.

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

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

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

Дополнительную информацию вы найдете в OAuth 2.0 Overview.