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