Sprawdzone metody i ograniczenia

Podczas korzystania z BatchJobService weź pod uwagę te wskazówki.

Zwiększanie przepustowości

• Lepiej jest wykonywać mniej większych zadań niż wiele mniejszych.

• Sortowanie przesłanych operacji według typu operacji. Jeśli np. zadanie zawiera operacje dodawania kampanii, grup reklam i kryteriów grup reklam, uporządkuj operacje w przesyłanych danych tak, aby najpierw znalazły się wszystkie operacje dotyczące kampanii, potem wszystkie operacje dotyczące grup reklam, a na końcu wszystkie operacje dotyczące kryteriów grup reklam.

• W przypadku operacji tego samego typu może poprawić wydajność ich grupowanie według zasobu nadrzędnego. Jeśli np. masz serię obiektów AdGroupCriterionOperation, możesz efektywniej grupować operacje według grup reklam zamiast mieszać operacje wpływające na kryteria grup reklam w różnych grupach reklam.

Unikanie problemów z jednoczesnym wykonywaniem

• Przesyłając wiele zadań jednocześnie na tym samym koncie, postaraj się zmniejszyć prawdopodobieństwo, że zadania będą działać na tych samych obiektach w tym samym czasie, zachowując przy tym duże rozmiary zadań. Wiele niedokończonych zadań o stanie RUNNING próbuje zmodyfikować ten sam zestaw obiektów, co może prowadzić do sytuacji podobnych do blokady, powodując poważne spowolnienie, a nawet niepowodzenie zadań.

• Nie przesyłaj wielu operacji, które zmieniają ten sam obiekt w tym samym zadaniu, ponieważ wynik może być nieprzewidywalny.

Optymalne pobieranie wyników

• Nie sprawdzaj stanu zadania zbyt często, ponieważ możesz przekroczyć limit szybkości i wygenerować błędy.

• Nie pobieraj więcej niż 1000 wyników na stronę. Serwer może zwrócić mniej niż 100% z powodu obciążenia lub innych czynników.

• Kolejność wyników będzie taka sama jak kolejność przesyłania.

Dodatkowe wskazówki dotyczące użytkowania

• Możesz ustawić górną granicę czasu, przez jaki może działać zadanie zbiorcze, zanim zostanie anulowane. Podczas tworzenia nowego zadania zbiorczego ustaw pole metadata.execution_limit_seconds na preferowany limit czasu w sekundach. Jeśli nie ustawisz parametru metadata.execution_limit_seconds, domyślny limit czasu nie będzie obowiązywał.

• Zalecamy dodanie nie więcej niż 1000 operacji na AddBatchJobOperationsRequest i przesłanie pozostałych operacji do tego samego zadania za pomocą opcji sequence_token. W zależności od treści operacji zbyt duża liczba operacji w pojedynczym AddBatchJobOperationsRequest może spowodować błąd REQUEST_TOO_LARGE. Ten błąd możesz rozwiązać, zmniejszając liczbę operacji i ponownie próbując wykonać tę czynność.AddBatchJobOperationsRequest

Ograniczenia

• Każdy element BatchJob obsługuje do miliona operacji.

• Każde konto może mieć jednocześnie maksymalnie 100 aktywizowanych lub oczekujących zadań.

• Zadania oczekujące starsze niż 7 dni są automatycznie usuwane.

• Każdy plik AddBatchJobOperationsRequest ma maksymalny rozmiar 10 484 504 bajtów. Jeśli przekroczysz ten limit, otrzymasz INTERNAL_ERROR. Możesz określić rozmiar żądania przed jego przesłaniem i podjąć odpowiednie działania, jeśli jest ono zbyt duże.

  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);