Sebbene la maggior parte dei servizi fornisca API sincrone, quindi è necessario effettuare una richiesta
e attendere una risposta, BatchJobService
fornisce un modo per eseguire batch di operazioni su più servizi senza attendere
in modo sincrono il completamento delle operazioni.
A differenza delle operazioni di modifica specifiche per 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
riprova automaticamente le operazioni non riuscite a causa di errori temporanei, come errori di limite di frequenza. L'API Google Ads conteggia comunque ogni operazione ai fini del limite di operazioni giornaliero seguendo le istruzioni per il conteggio delle operazioni API.
Inoltre, BatchJobService
consente di utilizzare
ID temporanei all'interno delle richieste per
inviare operazioni dipendenti in un singolo job.
Suite operativa
BatchJobService
supporta tutte le operazioni elencate in MutateOperation
, con alcune importanti eccezioni.
Poiché l'API Google Ads esegue tutte le operazioni in un job con errore parziale abilitato, se un job viene annullato o se singole operazioni non riescono, le operazioni andate a buon fine non verranno sottoposte a rollback.
Le seguenti operazioni in MutateOperation
devono essere atomiche, quindi non supportano gli errori parziali e non sono supportate all'interno dei job batch. Evita di aggiungerle ai job, imposta
partial_failure
su false
nelle richieste e usa invece il metodo mutate
in
GoogleAdsService
.
Operazioni non supportate in BatchJobService
AssetGroupOperation
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation