Si bien la mayoría de los servicios proporcionan API síncronas, lo que requiere que realices una solicitud y espere una respuesta, BatchJobService
proporciona una forma de realizar lotes de operaciones en varios servicios sin esperar a que las operaciones se completen de forma síncrona.
A diferencia de las operaciones de mutación específicas de los servicios, 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 de forma automática las operaciones que fallan debido a errores transitorios, como errores de límite de frecuencia. La API de Google Ads sigue registrando cada operación en tu límite de operaciones diarias según las instrucciones de registro de las operaciones de la API.
Además, BatchJobService
te permite usar ID temporales dentro de tus solicitudes para que puedas enviar operaciones dependientes en un solo trabajo.
Operations
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. Como resultado, no son compatibles con los trabajos por lotes y 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.