Elaborazione dei dati in modalità batch

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 e asset. 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.

Nota :l'utilizzo di BatchJobService può ridurre il numero di richieste inviate, ma il suo utilizzo deve essere valutato per verificare se è adatto alle tue esigenze. I motivi principali per utilizzare l'elaborazione batch sono ridurre al minimo il numero di richieste API e i tentativi di ripetizione delle operazioni non riuscite a causa di errori temporanei. Ciò non garantisce un miglioramento delle prestazioni con conseguente throughput più elevato o completamento più rapido del 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'opzione errore parziale abilitata (tranne all'interno di batch secondari atomici), se un job viene annullato o le singole operazioni non vanno a buon fine, le operazioni che hanno avuto esito positivo non vengono eseguite.

Le seguenti operazioni in MutateOperation devono essere atomiche e non supportano errori parziali, 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). Esegui invece queste operazioni 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 a partire dalla versione 23)
• CampaignConversionGoalOperation
• ConversionGoalCampaignConfigOperation
• CustomConversionGoalOperation
• CustomerConversionGoalOperation
• CustomerOperation
• QuoteCampaignsOperation (disponibile in MutateOperation a partire dalla versione 23; richiede validate_only impostato su true)