Si bien la mayoría de los servicios proporcionan APIs síncronas, lo que requiere 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, una sola tarea en BatchJobService
puede operar en una colección mixta de campañas, grupos de anuncios, anuncios, criterios, etiquetas y elementos de feed.
Las tareas enviadas se ejecutan en paralelo, y BatchJobService
reinyecta automáticamente las operaciones que fallan debido a errores transitorios, como errores de límite de frecuencia. La API de Google Ads aún cuenta cada operación para tu límite de operaciones diarias según las instrucciones de recuento de 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 que se enumeran en MutateOperation
, con algunas excepciones importantes.
Dado que la API de Google Ads ejecuta todas las operaciones de una tarea con la falla parcial habilitada, si se cancela una tarea o fallan operaciones individuales, no se revertirán las operaciones que se hayan realizado correctamente.
Las siguientes operaciones en MutateOperation
deben ser atómicas y, por lo tanto, no admiten fallas parciales ni son compatibles con los trabajos por lotes. Evita agregarlos a tus trabajos, configura partial_failure
en false
en tus solicitudes y usa el método mutate
en GoogleAdsService
.
Operaciones no admitidas en BatchJobService
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation