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
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation