Порядок определяется параметром orderBy . Если filterentityStatus не указан, заказы на размещение с ENTITY_STATUS_ARCHIVED не будут включены в результаты.
HTTP-запрос
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/insertionOrders
Необходимый. Идентификатор рекламодателя, для которого нужно составить список заказов на размещение.
Параметры запроса
Параметры
pageSize
integer
Запрошенный размер страницы. Должно быть от 1 до 100 . Если не указано, по умолчанию будет 100 . Возвращает код ошибки INVALID_ARGUMENT если указано недопустимое значение.
pageToken
string
Токен, идентифицирующий страницу результатов, которую должен вернуть сервер. Обычно это значение nextPageToken возвращенное из предыдущего вызова метода insertionOrders.list . Если не указано, будет возвращена первая страница результатов.
orderBy
string
Поле, по которому сортируется список. Приемлемые значения:
«имя_дисплея» (по умолчанию)
"статус объекта"
"время обновления"
По умолчанию порядок сортировки — по возрастанию. Чтобы указать порядок убывания поля, к имени поля следует добавить суффикс «desc». Пример: displayName desc .
filter
string
Позволяет фильтровать по полям порядка размещения.
Поддерживаемый синтаксис:
Выражения фильтра состоят из одного или нескольких ограничений.
Ограничения могут объединяться логическими операторами AND или OR . Последовательность ограничений неявно использует AND .
Ограничение имеет форму {field} {operator} {value} .
Поле updateTime должно использовать операторы GREATER THAN OR EQUAL TO (>=) или LESS THAN OR EQUAL TO (<=) .
Во всех остальных полях должен использоваться оператор EQUALS (=) .
Поддерживаемые поля:
campaignId
displayName
entityStatus
updateTime (ввод в формате ISO 8601 или YYYY-MM-DDTHH:MM:SSZ )
Примеры:
Все заказы на размещение в рамках кампании: campaignId="1234"
Все заказы на размещение ENTITY_STATUS_ACTIVE или ENTITY_STATUS_PAUSED от рекламодателя: (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED")
Все заказы на размещение со временем обновления, меньшим или равным 2020-11-04T18:54:47Z (формат ISO 8601): updateTime<="2020-11-04T18:54:47Z"
Все заказы на размещение со временем обновления, большим или равным 2020-11-04T18:54:47Z (формат ISO 8601): updateTime>="2020-11-04T18:54:47Z"
Длина этого поля не должна превышать 500 символов.
Токен для получения следующей страницы результатов. Передайте это значение в поле pageToken при последующем вызове метода insertionOrders.list , чтобы получить следующую страницу результатов.