Перечисление групповых фильтров в пакетных заданиях

При работе с фильтрами групп списков в контексте AdGroupCriterion.listing_group или AssetGroupListingGroupFilter необходимо учитывать несколько моментов при разработке интеграции.

Разделение пакетов

Если в пакетном задании есть какие-либо операции, которые содержат критерии группы объявлений или групповые фильтры списков групп объектов, операции в пакетном задании разбиваются на несколько подпакетов при получении сервером API Google Рекламы. Обратите внимание, что в отличие от стандартных операций в пакетном задании, каждый подпакет, содержащий операции фильтра группы списка, обрабатывается атомарно.

Способ разделения пакетных заданий, содержащих фильтры группы списков, на подпакеты определяется следующими факторами:

1. Тип группового фильтра объявлений
2. AdGroupCriterion или AssetGroup , на который нацелен фильтр группы объявлений.
3. Порядок действий

Имейте в виду следующие моменты, касающиеся группировки операций:

• Все последовательные операции AssetGroupListingGroupFilterOperation , нацеленные на одну и ту же AssetGroup группируются в атомарный подпакет (нет поведения частичного сбоя).
• Все последовательные операции AdGroupCriterionOperation , содержащие listing_group , нацеленную на одну и ту же AdGroup группируются в атомарный подпакет (нет частичного сбоя).
• Все остальные последовательные операции группируются в неатомарные подпакеты (частичный отказ).

Диаграмма ниже иллюстрирует эту концепцию. Каждый из серых прямоугольников представляет собой пакетное задание, отправленное с помощью API Google Рекламы. Внутри серых прямоугольников отдельные операции сгруппированы по цвету, обозначая подпакеты, создаваемые сервером API Google Рекламы. Порядок операций в каждом из серых прямоугольников соответствует порядку, в котором операции были бы добавлены в пакетное задание.

Ограничения

При работе с групповыми фильтрами списков в контексте пакетных заданий применяются следующие ограничения:

• Длина одного пакета операций AssetGroupListingGroupFilterOperation , содержащего listing_group и ориентированного на одну и ту же AdGroup не может превышать 20 000 операций. Однако рекомендуется не превышать 10 000 операций.
• Один пакет операций AssetGroupListingGroupFilterOperation , нацеленный на одну и ту же AssetGroup , не может превышать 10 000 операций.
• Нарушение любого из этих условий приводит к сбою всего пакетного задания.