Необходимый. Идентификатор рекламодателя, для которого нужно разместить позиции.
Параметры запроса
Параметры
pageSize
integer
Запрошенный размер страницы. Должно быть от 1 до 200 . Если не указано, по умолчанию будет 100 . Возвращает код ошибки INVALID_ARGUMENT если указано недопустимое значение.
pageToken
string
Токен, идентифицирующий страницу результатов, которую должен вернуть сервер. Обычно это значение nextPageToken возвращенное из предыдущего вызова метода lineItems.list . Если не указано, будет возвращена первая страница результатов.
orderBy
string
Поле, по которому сортируется список. Приемлемые значения:
displayName (по умолчанию)
entityStatus
updateTime
По умолчанию порядок сортировки — по возрастанию. Чтобы указать порядок убывания поля, к имени поля следует добавить суффикс «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
insertionOrderId
lineItemId
lineItemType
updateTime (ввод в формате ISO 8601 или YYYY-MM-DDTHH:MM:SSZ )
Примеры:
Все позиции в заказе на размещение: insertionOrderId="1234"
Все позиции ENTITY_STATUS_ACTIVE или ENTITY_STATUS_PAUSED и LINE_ITEM_TYPE_DISPLAY_DEFAULT рекламодателя: (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
Все позиции со временем обновления, меньшим или равным 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 при последующем вызове метода lineItems.list , чтобы получить следующую страницу результатов.