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 forma síncrona a que se completen las operaciones.
A diferencia de las operaciones de mutació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 errores de límite de frecuencia. La API de Google Ads sigue contando cada operación para tu límite de operaciones diarias, según las instrucciones de conteo de las operaciones de la API.
BatchJobService
también te permite usar IDs temporales en tus solicitudes para que puedas enviar operaciones dependientes en un solo trabajo.
Operaciones
BatchJobService
admite todas las operaciones que se indican en MutateOperation
, con algunas excepciones importantes.
Debido a que la API de Google Ads ejecuta todas las operaciones en un trabajo con la falla parcial habilitada, si se cancela un trabajo o fallan operaciones individuales, las operaciones que se completaron 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 los trabajos por lotes. Evita agregar estas operaciones 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