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 ritenta automaticamente le operazioni che non riescono a causa di errori temporanei, come gli errori di limitazione di frequenza. L' API Google Ads continua a conteggiare ogni operazione rispetto al 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.

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 riprovare le operazioni che non riescono a causa di errori temporanei. Ciò non garantisce un miglioramento del rendimento che si traduca in un throughput più elevato o in un 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 sottobatch atomici.

Poiché l'API Google Ads esegue le operazioni standard in un job con errore parziale abilitato (tranne che nei sottobatch atomici), se un job viene annullato o le singole operazioni non riescono, 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 MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE errore (o un InternalError.INTERNAL_ERROR per BookCampaignsOperation e QuoteCampaignsOperation). In alternativa, eseguile 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 validate_only impostato su true)