Si bien la mayoría de los servicios proporcionan APIs síncronas, que requieren que realices una solicitud y, luego, esperes una respuesta, BatchJobService
proporciona una forma de realizar lotes de operaciones en varios servicios sin 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 combinada de campañas, grupos de anuncios, anuncios, criterios, etiquetas y elementos del feed.
Los trabajos enviados se ejecutan en paralelo y BatchJobService
vuelve a intentar de forma automática las operaciones que fallan debido a errores transitorios, como errores de límite de frecuencia. De todas maneras, la API de Google Ads sigue contando cada operación para tu límite de operaciones diarias según las instrucciones de recuento de las operaciones de la API.
Además, BatchJobService
te permite usar IDs temporales en tus solicitudes para que puedas enviar operaciones dependientes en un solo trabajo.
Operaciones
BatchJobService
admite todas las operaciones enumeradas en MutateOperation
, con algunas excepciones importantes.
Dado que la API de Google Ads ejecuta todas las operaciones de un trabajo que tiene habilitada la falla parcial, si se cancela un trabajo o fallan las operaciones individuales, las operaciones que se completaron correctamente no se revertirán.
Las siguientes operaciones en MutateOperation
deben ser atómicas y, por lo tanto, no admiten fallas parciales y no son compatibles con los 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
AssetGroupOperation
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation