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

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

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

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

Операции

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

,

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

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

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

Операции

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

,

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

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

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

Операции

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

Далее
Поток использования