Si bien la mayoría de los servicios proporcionan API síncronas, lo que requiere que realices una solicitud y esperes una respuesta, BatchJobService
proporciona una forma de realizar lotes de operaciones en varios servicios sin esperar a que se completen las operaciones de forma síncrona.
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 de 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 igualmente
cuenta cada operación para tu
límite de operación diaria según las
instrucciones de conteo de operaciones de API.
Además, BatchJobService
te permite usar ID temporales dentro de 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.
La API de Google Ads ejecuta todas las operaciones de un trabajo con
la falla parcial habilitada. Sin embargo, las siguientes operaciones en MutateOperation
no admiten fallas parciales porque deben ser atómicas. Por lo tanto, no son compatibles con los trabajos por lotes, por lo que debes evitar agregarlos a los trabajos.
Si necesitas ejecutar alguna de estas operaciones, usa el método mutate
de GoogleAdsService
y establece partial_failure
en false
en tus solicitudes.