Elaborazione dei dati in modalità batch

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 e asset. I job inviati vengono eseguiti in parallelo e BatchJobService riprova automaticamente le operazioni che non vanno a buon fine a causa di errori temporanei, come quelli di limitazione di frequenza. L'API Google Ads conteggia comunque ogni operazione ai fini del limite di operazioni giornaliere, seguendo le istruzioni di conteggio delle operazioni API.

BatchJobService consente anche di utilizzare ID temporanei all'interno delle richieste, in modo da poter inviare operazioni dipendenti in un singolo job.

Nota: l'utilizzo di BatchJobService può ridurre il numero di richieste inviate, ma deve essere valutato per capire se è adatto alle tue esigenze. I motivi principali per utilizzare l'elaborazione batch sono ridurre al minimo il numero di richieste API e riprovare le operazioni che non vanno a buon fine a causa di errori temporanei. Questo non garantisce un miglioramento delle prestazioni che si traduce in un throughput più elevato o in un completamento più rapido dei job. Sperimenta diverse combinazioni di elaborazione batch e non batch per determinare la soluzione ottimale per le tue circostanze.

Operazioni

BatchJobService supporta tutte le operazioni elencate in MutateOperation il cui servizio sottostante supporta l'errore parziale, nonché AssetGroupOperation e AssetGroupListingGroupFilterOperation, che sono esplicitamente esentate ed eseguite (insieme alle operazioni interdipendenti correlate) in sub-batch atomici.

Poiché l'API Google Ads esegue operazioni standard in un job con l'errore parziale attivato (tranne che all'interno di sub-batch atomici), se un job viene annullato o singole operazioni non vanno a buon fine, le operazioni riuscite non vengono annullate.

Le seguenti operazioni in MutateOperation devono essere atomiche e non supportano l'errore parziale, pertanto non sono supportate nei job batch. L'aggiunta di una di queste operazioni a un job batch restituisce un errore MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE (o un errore InternalError.INTERNAL_ERROR per BookCampaignsOperation e QuoteCampaignsOperation). Eseguile invece utilizzando GoogleAdsService.Mutate con partial_failure impostato su false (e validate_only impostato su true per QuoteCampaignsOperation).

Operazioni non supportate in BatchJobService

• BookCampaignsOperation (disponibile in MutateOperation)
• CampaignConversionGoalOperation
• ConversionGoalCampaignConfigOperation
• CustomConversionGoalOperation
• CustomerConversionGoalOperation
• CustomerOperation
• QuoteCampaignsOperation (disponibile in MutateOperation; richiede l'impostazione di validate_only su true)