Mentre la maggior parte dei servizi fornisce API sincrone che richiedono di effettuare una richiesta
e quindi 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 dei feed.
I job inviati vengono eseguiti in parallelo e
BatchJobService ritenta automaticamente
le operazioni non riuscite a causa di errori temporanei, come gli errori di limite di frequenza. L'API Google Ads continua a conteggiare ogni operazione ai fini del limite di operazioni giornaliere, seguendo le istruzioni di conteggio delle operazioni API.
BatchJobService ti consente anche di utilizzare
ID temporanei all'interno delle 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 l'opzione Errore parziale abilitata, se un job viene annullato o le singole operazioni non vanno a buon fine, le operazioni che hanno avuto esito positivo non verranno eseguite.
Le seguenti operazioni in MutateOperation devono essere
atomiche e, pertanto, non supportano errori parziali
e non sono supportate nei job batch. Evita di aggiungere queste operazioni ai tuoi job, imposta partial_failure su false nelle tue richieste e utilizza il metodo mutate in GoogleAdsService.
Operazioni non supportate in BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation