Procesamiento por lotes

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