Si bien la mayoría de los servicios proporcionan APIs síncronas, por lo que debes realizar una solicitud y, luego, esperar una respuesta, BatchJobService
proporciona una forma de realizar lotes de operaciones en varios servicios sin tener que esperar de manera síncrona a que se completen las operaciones.
A diferencia de las operaciones de modificación específicas del servicio, un solo trabajo en BatchJobService
puede operar en una colección mixta de campañas, grupos de anuncios, anuncios, criterios, etiquetas y elementos del feed.
Los trabajos enviados se ejecutan en paralelo, y BatchJobService
reintenta automáticamente las operaciones que fallan debido a errores transitorios, como los de límite de frecuencia. La API de Google Ads seguirá contando cada operación para tu límite de operaciones diarias según las instrucciones de recuento de operaciones de API.
Además, BatchJobService
te permite usar IDs temporales en las solicitudes para que puedas enviar operaciones dependientes en un solo trabajo.
Operations
BatchJobService
admite todas las operaciones que se enumeran en MutateOperation
, con algunas excepciones importantes.
Dado que la API de Google Ads ejecuta todas las operaciones en un trabajo con falla parcial habilitada, si un trabajo se cancela o fallan operaciones individuales, las operaciones que se realizaron de forma correcta no se revertirán.
Las siguientes operaciones en MutateOperation
deben ser atómicas y, por lo tanto, no admiten fallas parciales y no se admiten en trabajos por lotes. Evita agregarlos a tus trabajos, configura partial_failure
como false
en tus solicitudes y usa el método mutate
en GoogleAdsService
en su lugar.
Operaciones no admitidas en BatchJobService
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation