Пакетная обработка

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

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

BatchJobService также позволяет использовать временные идентификаторы в запросах, что дает возможность отправлять зависимые операции в рамках одного задания.

Примечание: Использование BatchJobService может уменьшить количество отправляемых запросов, но его целесообразность следует оценить, чтобы определить, подходит ли он для ваших нужд. Основные причины использования пакетной обработки — минимизация количества запросов к API и повторная попытка операций, завершившихся с ошибкой из-за временных сбоев. Это не гарантирует повышения производительности, что приведет к увеличению пропускной способности или ускорению выполнения заданий. Экспериментируйте с различными комбинациями пакетной и непакетной обработки, чтобы определить оптимальное решение для ваших условий.

Операции

BatchJobService поддерживает все операции, перечисленные в MutateOperation базовая служба которых поддерживает частичный сбой , а также AssetGroupOperation и AssetGroupListingGroupFilterOperation , которые явно исключены и выполняются (вместе с соответствующими взаимозависимыми операциями) в атомарных подпакетах .

Поскольку API Google Ads выполняет стандартные операции в рамках задания с разрешенным частичным сбоем (за исключением атомарных подпакетов ), если задание отменяется или отдельные операции завершаются с ошибкой, операции, которые прошли успешно, не откатываются.

Следующие операции в MutateOperation должны быть атомарными и не поддерживают частичные сбои, поэтому они не поддерживаются в пакетных заданиях. Добавление любой из этих операций в пакетное задание возвращает ошибку MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE (или InternalError.INTERNAL_ERROR для BookCampaignsOperation и QuoteCampaignsOperation ). Вместо этого выполняйте их с помощью GoogleAdsService.Mutate , установив partial_failure в значение false (и validate_only в значение true для QuoteCampaignsOperation ).

Неподдерживаемые операции в BatchJobService

• BookCampaignsOperation (доступно в MutateOperation начиная с версии 23)
• CampaignConversionGoalOperation
• ConversionGoalCampaignConfigOperation
• CustomConversionGoalOperation
• CustomerConversionGoalOperation
• CustomerOperation
• QuoteCampaignsOperation (доступно в MutateOperation начиная с версии 23; требует установки параметра validate_only в true )