Необходимый. Идентификатор рекламодателя, которому принадлежит группа объявлений.
Параметры запроса
Параметры
pageSize
integer
Запрошенный размер страницы. Должно быть от 1 до 200 . Если не указано, по умолчанию будет 100 . Возвращает код ошибки INVALID_ARGUMENT если указано недопустимое значение.
pageToken
string
Токен, идентифицирующий страницу результатов, которую должен вернуть сервер. Обычно это значение nextPageToken возвращаемое предыдущим вызовом метода youtubeAdGroups.list . Если не указано, будет возвращена первая страница результатов.
orderBy
string
Поле, по которому сортируется список. Приемлемые значения:
displayName (по умолчанию)
entityStatus
По умолчанию порядок сортировки — по возрастанию. Чтобы указать порядок убывания поля, к имени поля следует добавить суффикс «desc». Пример: displayName desc .
filter
string
Позволяет фильтровать по пользовательским полям группы объявлений YouTube.
Поддерживаемый синтаксис:
Выражения фильтра состоят из одного или нескольких ограничений.
Ограничения можно комбинировать с помощью AND и OR . Последовательность ограничений неявно использует AND .
Ограничение имеет форму {field} {operator} {value} .
Во всех полях должен использоваться оператор EQUALS (=) .
Поддерживаемые свойства:
adGroupId
displayName
entityStatus
lineItemId
adGroupFormat
Примеры:
Все группы объявлений в позиции: lineItemId="1234"
All ENTITY_STATUS_ACTIVE или ENTITY_STATUS_PAUSEDYOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM(entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND adGroupFormat="YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM"
Длина этого поля не должна превышать 500 символов.
Токен для получения следующей страницы результатов. Передайте это значение в поле pageToken при последующем вызове метода youtubeAdGroups.list , чтобы получить следующую страницу результатов.