Sebbene la maggior parte dei servizi fornisca API sincrone, che richiedono di inviare una richiesta
e poi attendere una risposta, BatchJobService
offre un modo per eseguire batch di operazioni su più servizi senza
aspettare in modo sincrono il completamento delle operazioni.
A differenza delle operazioni di mutazione specifiche per servizio, un singolo job in
BatchJobService può essere eseguito su una raccolta miscelata
di campagne, gruppi di annunci, annunci, criteri, etichette e elementi del feed.
I job inviati vengono eseguiti in parallelo e
BatchJobService riprova automaticamente le operazioni
che non riescono a causa di errori temporanei, come gli errori di limite di frequenza. L'API Google Ads conteggia comunque ogni operazione ai fini del limite giornaliero di operazioni in base alle istruzioni di conteggio delle operazioni API.
Inoltre, BatchJobService ti consente 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 attivata, se un job viene annullato o se 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 errori parziali
e non sono supportate nei job batch. Evita di aggiungerli ai tuoi job, imposta partial_failure su false nelle richieste e utilizza il metodo mutate in GoogleAdsService.
Operazioni non supportate in BatchJobService
CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation