Pertimbangkan panduan ini saat menggunakan
BatchJobService
.
Meningkatkan throughput
Lebih sedikit pekerjaan yang lebih besar lebih disukai daripada banyak pekerjaan yang lebih kecil.
Urutkan operasi yang diupload menurut jenis operasi. Misalnya, jika tugas Anda berisi operasi untuk menambahkan kampanye, grup iklan, dan kriteria grup iklan, urutkan operasi dalam upload Anda sehingga semua operasi kampanye berada di urutan pertama, diikuti oleh semua operasi grup iklan, dan terakhir semua operasi kriteria grup iklan.
Dalam operasi dengan jenis yang sama, pengelompokkan berdasarkan resource induk dapat meningkatkan performa. Misalnya, jika Anda memiliki serangkaian objek
AdGroupCriterionOperation
, akan lebih efisien untuk mengelompokkan operasi menurut grup iklan, dibandingkan menggabungkan operasi yang memengaruhi kriteria grup iklan di grup iklan yang berbeda.
Menghindari masalah serentak
Saat mengirimkan beberapa tugas serentak untuk akun yang sama, cobalah untuk mengurangi kemungkinan tugas beroperasi pada objek yang sama secara bersamaan, sambil mempertahankan ukuran tugas yang besar. Banyak tugas yang belum selesai (dengan status
RUNNING
) yang mencoba mengubah kumpulan objek yang sama dapat menyebabkan kondisi seperti deadlock yang mengakibatkan perlambatan parah dan bahkan kegagalan tugas.Jangan mengirimkan beberapa operasi yang mengubah objek yang sama dalam pekerjaan yang sama, karena hasilnya bisa tidak dapat diprediksi.
Mengambil hasil secara optimal
Jangan melakukan polling tentang status pekerjaan terlalu sering atau Anda berisiko mencapai error batas kapasitas.
Jangan mengambil lebih dari 1.000 hasil per halaman. Server dapat menampilkan lebih sedikit dari itu karena beban atau faktor lainnya.
Urutan hasil akan sama dengan urutan upload.
Panduan penggunaan tambahan
Anda dapat menetapkan batas atas untuk durasi tugas batch boleh dijalankan sebelum dibatalkan. Saat membuat tugas batch baru, tetapkan kolom
metadata.execution_limit_seconds
ke batas waktu yang Anda inginkan, dalam detik. Tidak ada batas waktu default jikametadata.execution_limit_seconds
tidak ditetapkan.Sebaiknya tambahkan tidak lebih dari 1.000 operasi per
AddBatchJobOperationsRequest
dan gunakansequence_token
untuk mengupload sisa operasi ke tugas yang sama. Bergantung pada konten operasi, terlalu banyak operasi dalam satuAddBatchJobOperationsRequest
dapat menyebabkan errorREQUEST_TOO_LARGE
. Anda dapat menangani error ini dengan mengurangi jumlah operasi dan mencoba kembaliAddBatchJobOperationsRequest
.
Batasan
Setiap
BatchJob
mendukung hingga satu juta operasi.Setiap akun dapat memiliki hingga 100 tugas yang aktif atau tertunda secara bersamaan.
Tugas yang tertunda yang sudah lebih dari 7 hari akan dihapus secara otomatis.
Setiap
AddBatchJobOperationsRequest
memiliki ukuran maksimum 10.484.504 byte. Jika melebihi jumlah ini, Anda akan menerimaINTERNAL_ERROR
. Anda dapat menentukan ukuran permintaan sebelum mengirimkannya, dan mengambil tindakan yang sesuai jika ukurannya terlalu besar.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);