Google Ads API menerapkan batasan pada operasi API, seperti jumlah operasi yang dapat dikirim dalam satu permintaan mutasi. Tabel di bawah ini meringkas beberapa batas dan kuota penting yang perlu diperhatikan.
Jenis Permintaan, Batasan, dan Kode Error | |||
---|---|---|---|
Permintaan yang dipaginasi | 10.000 baris per halaman |
INVALID_PAGE_SIZE
|
|
Operasi dengan Akses Dasar | 15.000 operasi API per hari |
RESOURCE_EXHAUSTED
|
|
Mengubah permintaan | 10.000 operasi per permintaan |
TOO_MANY_MUTATE_OPERATIONS
|
|
Permintaan Layanan Perencanaan | 1 QPS |
RESOURCE_EXHAUSTED
|
|
Permintaan Layanan Upload Konversi | 2.000 konversi per permintaan |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
|
Permintaan Layanan Anggaran Akun dan Penagihan | 1 operasi per permintaan mutasi |
TOO_MANY_MUTATE_OPERATIONS
|
Batas operasi API harian
Batas penggunaan API harian didasarkan pada jumlah operasi API yang dibuat per token developer. Operasi API adalah jumlah total permintaan get dan operasi mutasi. Batas operasi API harian bergantung pada level akses token developer. Panduan Tingkat Akses dan Penggunaan yang Diizinkan menguraikan batas operasi API tertentu untuk setiap tingkat akses.
Permintaan yang melanggar batas ini akan ditolak dengan error:
RESOURCE_EXHAUSTED
.
Batasan gRPC
Semua library klien Google Ads API menggunakan gRPC untuk membuat permintaan dan respons. Secara default, gRPC memiliki ukuran pesan 4 MB, tetapi library klien kami menetapkan ukuran pesan maksimum ke 64 MB untuk meningkatkan efisiensi.
Respons tidak boleh melebihi batas ini. Misalnya, permintaan penelusuran yang menyertakan banyak kolom dapat menghasilkan respons yang ukurannya melebihi 64 MB. Untuk menghindari batas ini, Anda dapat mengurangi jumlah kolom yang dipilih, mengurangi ukuran halaman, atau menggunakan streaming. Untuk mutasi, kirim lebih sedikit operasi per permintaan.
Permintaan yang melanggar batasan ini tidak akan menghasilkan
GoogleAdsError
, tetapi akan menghasilkan
error gRPC 429 Resource Exhausted
. Lihat daftar kode dan pesan error
gRPC.
Mengubah permintaan
Selain mengurangi kuota operasi harian pengguna, permintaan mutasi tidak boleh berisi lebih dari 10.000 operasi per permintaan.
Permintaan yang melanggar batasan ini ditolak dengan error:
TOO_MANY_MUTATE_OPERATIONS
.
Batas dan pertimbangan tambahan untuk layanan dan jenis permintaan tertentu diuraikan di bawah ini.
Telusuri permintaan
Permintaan Search
atau SearchStream
dihitung sebagai satu operasi terhadap kuota operasi harian pengguna. Satu permintaan SearchStream
dihitung sebagai satu operasi API, terlepas dari jumlah batch.
Permintaan yang dipaginasi
Permintaan yang dipaginasi (misalnya, permintaan yang berisi next_page_token
yang valid) tidak dihitung dalam kuota operasi harian pengguna.
Namun, permintaan penomoran halaman yang berisi token halaman yang sudah tidak berlaku atau tidak valid akan menghasilkan pengecualian dan akan mengurangi kuota operasi harian.
Permintaan yang diberi nomor halaman, seperti permintaan penelusuran, juga tunduk kepada
batasan Page size cannot exceed 10,000 rows
dan akan ditolak jika melanggar
batas ini, dengan error:
INVALID_PAGE_SIZE
.
Untuk detail selengkapnya tentang penomoran halaman, lihat Hasil Paging melalui.
Jenis permintaan lainnya
Permintaan yang bukan permintaan Get
, Mutate
, Search
, atau SearchStream
dihitung sebagai satu operasi terhadap kuota operasi harian pengguna.
Beberapa contoh permintaan tersebut mencakup:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
Permintaan yang menampilkan pengecualian API
Permintaan yang ditolak dengan
GoogleAdsFailure
tetap mengurangi
kuota operasi harian pengguna.
Permintaan yang gagal tetapi tidak menampilkan
GoogleAdsFailure
, seperti dari error di
tingkat jaringan, tidak akan mengurangi kuota operasi harian pengguna
karena permintaan tidak akan pernah mencapai layanan. Contohnya adalah
kegagalan konektivitas jaringan.
Layanan perencanaan
Karena biaya dan kompleksitas, metode layanan Perencanaan yang tercantum di bawah ini tunduk pada batasan yang terpisah dari jenis permintaan lainnya.
Dibatasi hingga 1 permintaan per detik per CID atau token developer:
KeywordPlanService.GetKeywordPlan
KeywordPlanService.GenerateHistoricalMetrics
KeywordPlanService.GenerateForecastMetrics
Permintaan yang melanggar batasan ini ditolak dengan error:
RESOURCE_EXHAUSTED
.1 QPS dihitung sebagai 60 permintaan per 60 detik.
Perhatikan batas ini saat membuat rencana kata kunci.
Objek Rencana Kata Kunci | Jumlah Maksimum |
---|---|
KeywordPlan per akun |
10.000 |
KeywordPlanAdGroup per KeywordPlan |
200 |
KeywordPlanAdGroupKeyword per KeywordPlan |
10.000 |
KeywordPlanCampaignKeyword (kata kunci negatif) |
1.000 |
KeywordPlanCampaign per KeywordPlan |
1 |
Layanan upload konversi
Dibatasi hingga 2.000 konversi panggilan atau klik per permintaan:
Permintaan yang melanggar batas ini akan ditolak dengan error:
TOO_MANY_CONVERSIONS_IN_REQUEST
.
Layanan upload penyesuaian konversi
Dibatasi hingga 2.000 penyesuaian konversi per permintaan:
Permintaan yang melanggar batas ini akan ditolak dengan error:
TOO_MANY_ADJUSTMENTS_IN_REQUEST
.
Layanan anggaran akun dan penagihan
Mutasi hanya dapat dilakukan terhadap akun yang dikonfigurasi untuk invoice bulanan.
Permintaan yang melanggar batasan ini ditolak dengan error:
MUTATE_NOT_ALLOWED
.Hanya operasi 1 yang diizinkan untuk mengubah permintaan.
Permintaan yang melanggar batasan ini ditolak dengan error:
TOO_MANY_MUTATE_OPERATIONS
.Anda harus menunggu minimal 12 jam sebelum terjadi perubahan instruksi anggaran ke akun yang sama. Melakukan perubahan sebelum 12 jam berlalu dapat mengakibatkan kegagalan yang tidak dapat dipulihkan yang hanya dapat diselesaikan oleh perwakilan akun Google Ads Anda.
Undangan ke akun pelanggan
Pengguna baru dapat diundang ke akun klien yang ada dengan
CustomerUserAccessService
. Karena fungsi ini mengirim email undangan ke pengguna lain, fungsi ini berpotensi disalahgunakan, sehingga terdapat batasan pada perilakunya:
Pengguna tidak dapat menerima lebih dari satu undangan tertunda untuk akun klien yang sama. Jika permintaan berikutnya dibuat untuk mengirim undangan ke pengguna yang sudah memiliki undangan tertunda, error ini akan ditampilkan:
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION
.Akun klien tidak boleh memiliki lebih dari 70 undangan yang tertunda pada satu waktu. Jika permintaan yang dikirim menyebabkan nilai ini terlampaui, error ini akan ditampilkan:
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED
.
Data pengguna
Data pengguna dikelola dengan
UserDataService
dan
OfflineUserDataJobService
.
Dalam operasi UserData
buat/hapus tertentu, setiap
kumpulan user_identifiers
harus dikhususkan untuk satu pengguna.
Untuk menerapkannya,
error OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
atau
UserDataError.TOO_MANY_USER_IDENTIFIERS
ditampilkan jika ada lebih dari 20 user_identifiers
dalam
kumpulan UserData
.
Jenis batas lainnya
Kolom berulang, seperti daftar operasi, yang memiliki terlalu banyak item dalam
permintaan dapat menyebabkan error:
REQUEST_SIZE_LIMIT_EXCEEDED
.
Pesan error yang sama ini juga dapat disebabkan oleh masalah lain.
Jika Anda mengalami batasan ini dan membuat permintaan yang menggunakan kolom berulang, coba kurangi jumlah item di kolom berulang dengan men-deploy daftar operasi dalam permintaan mutasi.
Saat membuat kueri GAQL, jumlah maksimum item dalam klausa IN
adalah 20.000. Jika Anda melebihi batas tersebut, error FILTER_HAS_TOO_MANY_VALUES
akan ditampilkan.