Sebbene la maggior parte dei servizi fornisca API sincrone e richiede di effettuare una richiesta e poi attendere una risposta, BatchJobService offre un modo per eseguire batch di operazioni su più servizi senza attendere il completamento delle operazioni in modo sincrono.
A differenza delle operazioni di modifica specifiche di un servizio, un singolo job in BatchJobService può operare su una raccolta mista di campagne, gruppi di annunci, annunci, criteri, etichette ed elementi del feed.
I job inviati vengono eseguiti in parallelo e BatchJobService ritenta automaticamente le operazioni che non riescono a causa di errori temporanei come errori della limitazione di frequenza. L'API Google Ads
conteggia comunque ogni operazione ai fini del
limite di operazioni giornaliero seguendo le istruzioni di conteggio
delle operazioni API.
Inoltre, BatchJobService consente di utilizzare ID temporanei all'interno delle richieste in modo da poter inviare operazioni dipendenti in un singolo job.
Suite operativa
BatchJobService supporta tutte le operazioni elencate in
MutateOperation, tranne che per alcune importanti
eccezioni.
Poiché l'API Google Ads esegue tutte le operazioni in un job in cui è abilitato un errore parziale, se un job viene annullato o se singole operazioni non vanno a buon fine, le operazioni riuscite non vengono sottoposte a rollback.
Le seguenti operazioni in MutateOperation devono essere
atomiche e, di conseguenza, non supportano errori parziali
e non sono supportate all'interno dei job batch. Evita di aggiungerli ai tuoi job, imposta partial_failure su false nelle tue richieste e utilizza il metodo mutate in GoogleAdsService.
Operazioni non supportate in BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation