Пакетная обработка позволяет отправить набор операций, которые могут быть взаимозависимыми, нескольким службам без синхронного ожидания завершения операций. Пакетную обработку можно использовать для создания кампаний с максимальной эффективностью и управления ими.
В этом руководстве приведены подробные сведения о кампаниях с максимальной эффективностью при работе с пакетной обработкой. В общем руководстве по пакетной обработке представлены общие сведения о пакетной обработке, а в руководстве по структурным запросам содержится подробная информация о составлении запросов для создания кампаний с максимальной эффективностью или управления ими.
Чтобы создать кампанию с максимальной эффективностью с помощью пакетной обработки, выполните следующие действия:
Создать новое пакетное задание
Выполните общий шаг создания задания пакетной обработки, чтобы создать ресурс BatchJob .
Подготовьте список операций мутации
Кампании с максимальной эффективностью требуют операций по созданию нескольких связанных ресурсов, которые подробно описаны в руководстве по структурированию запросов . Создайте MutateOperation для каждого ресурса, который должен быть включен в пакетное задание.
Требования AssetGroupOperation и AssetGroupAssetOperation
Операции типа MutateOperation , которые создают ресурсы AssetGroup и AssetGroupAsset в пакетном задании, должны быть последовательными без других промежуточных операций, поскольку эти операции группируются вместе при обработке. В противном случае запрос выдает AssetGroupError указывающую, что некоторые активы отсутствуют , даже если операции, необходимые для удовлетворения минимальных требований к активам, будут включены позже в список операций.
Рекомендации по AssetGroupListingGroupFilterOperation
При работе с групповыми фильтрами списков в контексте AssetGroupListingGroupFilter мы рекомендуем последовательно добавлять операции AssetGroupListingGroupFilterOperation , нацеленные на одну и ту же AssetGroup , в пакетное задание, чтобы набор операций обрабатывался атомарно во время разделения пакета. Дополнительную информацию о групповом разделении и других факторах, влияющих на группы объявлений, см. в руководстве по пакетной обработке групп объявлений .
Добавьте операции изменения в задание
Добавьте операции изменения из шага 2 в список и вызовите AddBatchJobOperations , чтобы добавить список мутаций в пакетное задание, созданное на шаге 1 . Следуйте шагу добавления операций в общем руководстве по пакетной обработке, чтобы добавить список операций изменения.
Запуск пакетного задания
Разрешите запуск загруженных заданий, вызвав RunBatchJob . Пример см. в разделе «Выполнение пакетного задания» в общем руководстве по пакетной обработке.
Получить статус задания
Пакетные задания начинаются как длительные операции и обычно требуют времени для завершения. После запуска задания используйте метод GetOperation длительной операции, чтобы опрашивать состояние задания, пока оно не будет выполнено.
Когда все пакетные задания будут завершены, вызовите ListBatchJobResults чтобы распечатать их статусы и ответы, следуя шагу «Список всех результатов пакетных заданий» в общем руководстве по пакетной обработке.