Attieniti a queste linee guida quando utilizzi BatchJobService
.
Migliora la velocità effettiva
È preferibile privilegiare meno lavori di grandi dimensioni rispetto a molti lavori più piccoli.
Operazioni caricate sull'ordine per tipo di operazione. Ad esempio, se il job contiene operazioni per aggiungere campagne, gruppi di annunci e criteri dei gruppi di annunci, ordina le operazioni nel caricamento in modo che tutte le operazioni della campagna siano per prime, seguite da tutte le operazioni del gruppo di annunci e infine da tutte le operazioni relative ai criteri del gruppo di annunci.
All'interno di operazioni dello stesso tipo, può migliorare le prestazioni raggruppandole per risorsa padre. Ad esempio, se hai una serie di oggetti
AdGroupCriterionOperation
, può essere più efficiente raggruppare le operazioni per gruppo di annunci, anziché combinare operazioni che influiscono sui criteri dei gruppi di annunci in gruppi di annunci diversi.
Evitare problemi di contemporaneità
Quando invii più job simultanei per lo stesso account, prova a ridurre la probabilità che i job vengano utilizzati contemporaneamente sugli stessi oggetti, pur mantenendo grandi dimensioni. Molti job non completati (con stato
RUNNING
) che provano a modificare lo stesso insieme di oggetti possono portare a condizioni simili a deadlock, determinando gravi rallentamenti e persino errori dei job.Non inviare più operazioni che modificano lo stesso oggetto nello stesso job, poiché il risultato può essere imprevedibile.
Recupera i risultati in modo ottimale
Non eseguire il polling dello stato del job troppo spesso, altrimenti rischi di raggiungere errori di limite di frequenza.
Non recuperare più di 1000 risultati per pagina. Il server potrebbe restituire meno di questo a causa del carico o di altri fattori.
L'ordine dei risultati sarà lo stesso dell'ordine di caricamento.
Ulteriori indicazioni sull'utilizzo
Puoi impostare un limite superiore per il periodo di tempo in cui un job batch può essere eseguito prima di essere annullato. Quando crei un nuovo job batch, imposta il campo
metadata.execution_limit_seconds
sul limite di tempo che preferisci, in secondi. Non esiste un limite di tempo predefinito se non è impostatometadata.execution_limit_seconds
.Ti consigliamo di non aggiungere più di 1000 operazioni per
AddBatchJobOperationsRequest
e di utilizzaresequence_token
per caricare il resto delle operazioni nello stesso job. A seconda dei contenuti delle operazioni, troppe operazioni in un singoloAddBatchJobOperationsRequest
potrebbero causare un erroreREQUEST_TOO_LARGE
. Puoi gestire questo errore riducendo il numero di operazioni e riprovando aAddBatchJobOperationsRequest
.
Limitazioni
Ogni
BatchJob
supporta fino a un milione di operazioni.Ogni account può avere fino a 100 job attivi o in attesa contemporaneamente.
I job in attesa che risalgono a più di 7 giorni vengono rimossi automaticamente.
Ogni
AddBatchJobOperationsRequest
ha una dimensione massima di 10.484.504 byte. Se superi questo limite, riceverai unINTERNAL_ERROR
. Puoi stabilire le dimensioni della richiesta prima di inviarla e intraprendere le azioni necessarie se è troppo grande.Java
static final int MAX_REQUEST_BYTES = 10_484_504; ... (code to get the request object) int sizeInBytes = request.getSerializedSize();
Python
from google.ads.googleads.client import GoogleAdsClient MAX_REQUEST_BYTES = 10484504 ... (code to get the request object) size_in_bytes = request._pb.ByteSize()
Ruby
require 'google/ads/google_ads' MAX_REQUEST_BYTES = 10484504 ... (code to get the request object) size_in_bytes = request.to_proto.bytesize
PHP
use Google\Ads\GoogleAds\V16\Resources\Campaign; const MAX_REQUEST_BYTES = 10484504; ... (code to get the request object) $size_in_bytes = $campaign->byteSize() . PHP_EOL;
.NET
using Google.Protobuf; const int MAX_REQUEST_BYTES = 10484504; ... (code to get the request object) int sizeInBytes = request.ToByteArray().Length;
Perl
use Devel::Size qw(total_size); use constant MAX_REQUEST_BYTES => 10484504; ... (code to get the request object) my $size_in_bytes = total_size($request);