Mentre la maggior parte dei servizi fornisce API sincrone che richiedono di effettuare una richiesta
e poi attendere una risposta, BatchJobService
offre 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 del 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 vanno a buon fine a causa di errori temporanei, come gli errori di limitazione di frequenza. L'
API Google Ads continua a conteggiare ogni operazione ai fini del
limite di operazioni giornaliero,
seguendo le istruzioni di conteggio delle operazioni API.
BatchJobService ti consente anche di utilizzare
ID temporanei nelle richieste in modo da
poter inviare operazioni dipendenti in un unico job.
Operazioni
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 le singole operazioni non vanno a buon fine, le operazioni riuscite non verranno annullate.
Le seguenti operazioni in MutateOperation devono essere
atomiche e, pertanto, non supportano l'errore parziale
e non sono supportate nei job batch. Evita di aggiungere queste operazioni ai
job, imposta partial_failure su false nelle richieste e utilizza il metodo mutate
in GoogleAdsService invece.
Operazioni non supportate in BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation