Untuk mendiskusikan dan memberikan masukan tentang produk kami, bergabunglah ke channel Discord Google Ads resmi di server Komunitas Iklan dan Pengukuran Google.

Halaman ini diterjemahkan oleh Cloud Translation API.

Batas dan Kuota API

Google Ads API menerapkan batasan pada operasi API, seperti jumlah operasi yang dapat dikirim dalam satu permintaan perubahan. Tabel berikut merangkum beberapa batas dan kuota penting yang harus diperhatikan.

Jenis Permintaan, Batasan, dan Kode Error
Operasi dengan tingkat Akses Dasar	15.000 operasi API per hari	`RESOURCE_EXHAUSTED`
Permintaan perubahan	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 Penagihan dan Anggaran Akun	1 operasi per permintaan mutasi	`TOO_MANY_MUTATE_OPERATIONS`

Batas operasi API harian

Batas penggunaan API harian didasarkan pada jumlah operasi API yang dilakukan per token developer. Operasi API adalah total jumlah permintaan get dan operasi perubahan. Batas untuk operasi API harian bergantung pada tingkat 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 mencakup banyak kolom dapat menghasilkan respons yang ukurannya melebihi 64 MB. Untuk menghindari batas ini, Anda dapat mengurangi jumlah kolom yang dipilih, 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.

Permintaan perubahan

Selain dihitung terhadap kuota operasi harian pengguna, permintaan perubahan tidak boleh berisi lebih dari 10.000 operasi per permintaan.

Permintaan yang melanggar batasan ini akan ditolak dengan error: TOO_MANY_MUTATE_OPERATIONS.

Batasan dan pertimbangan tambahan untuk layanan dan jenis permintaan tertentu diuraikan di bagian berikutnya.

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 di-page (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 dihitung dalam kuota operasi harian.

Untuk mengetahui detail selengkapnya tentang penomoran halaman, lihat Melakukan paging melalui hasil.

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 meliputi:

Permintaan yang menampilkan pengecualian API

Permintaan yang ditolak dengan GoogleAdsFailure tetap diperhitungkan terhadap 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 kata kunci

Karena biaya dan kompleksitasnya, metode layanan Perencanaan Kata Kunci berikut tunduk pada batas terpisah dari jenis permintaan lainnya.

Dibatasi hingga 1 permintaan per detik per CID:
Permintaan yang melanggar batasan ini akan ditolak dengan error: RESOURCE_EXHAUSTED.
1 QPS dihitung sebagai 60 permintaan per 60 detik.
Dibatasi hingga 2 permintaan per detik per CID:
- KeywordPlanIdeaService.GenerateAdGroupTheme

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 analisis audiens

Metode berikut dalam AudienceInsightsService metode tunduk pada batas kuota tertentu.

Dibatasi hingga sekitar 200 permintaan per hari per CID:
- AudienceInsightsService.generateAudienceCompositionInsights
- AudienceInsightsService.generateSuggestedTargetingInsights
Dibatasi hingga 2 permintaan per detik per token developer:
- AudienceInsightsService.generateTargetingSuggestionMetrics

Layanan upload konversi

Dibatasi hingga 2.000 konversi panggilan atau klik per permintaan:
- ConversionUploadService.UploadCallConversions
- ConversionUploadService.UploadClickConversions
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:
- ConversionAdjustmentUploadService.UploadConversionAdjustments
Permintaan yang melanggar batas ini akan ditolak dengan error: TOO_MANY_ADJUSTMENTS_IN_REQUEST.

Layanan anggaran akun dan penagihan

Perubahan hanya dapat dilakukan pada akun yang dikonfigurasi untuk invoice bulanan.

Permintaan yang melanggar batasan ini akan ditolak dengan error: MUTATE_NOT_ALLOWED.
Hanya operasi 1 yang diizinkan untuk permintaan perubahan.

Permintaan yang melanggar batasan ini akan ditolak dengan error: TOO_MANY_MUTATE_OPERATIONS.
Anda harus menunggu setidaknya 12 jam di antara perubahan pesanan anggaran ke akun yang sama. Melakukan perubahan sebelum 12 jam berlalu dapat menyebabkan kegagalan yang tidak dapat dipulihkan dan 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 fitur ini mengirimkan email undangan kepada pengguna lain, fitur ini berpotensi disalahgunakan, sehingga ada batasan pada perilakunya:

Pengguna tidak dapat menerima lebih dari satu undangan yang menunggu keputusan untuk akun klien yang sama. Jika permintaan berikutnya dibuat untuk mengirim undangan kepada pengguna yang sudah memiliki undangan yang menunggu persetujuan, error ini akan ditampilkan: ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.
Akun klien tidak boleh memiliki lebih dari 70 undangan yang menunggu keputusan sekaligus. 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 pembuatan atau penghapusan UserData tertentu, setiap kumpulan user_identifiers harus spesifik untuk satu pengguna.

Untuk menerapkan hal ini, error OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS atau UserDataError.TOO_MANY_USER_IDENTIFIERS akan ditampilkan jika ada lebih dari 20 user_identifiers dalam set UserData.

Anda diizinkan hingga 100.000 ID pengguna,terlepas dari jumlah operasi.

Jenis batas lainnya

Kolom berulang, seperti daftar operasi, yang memiliki terlalu banyak item dalam permintaan dapat menimbulkan 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 dalam kolom berulang dengan men-deploy daftar operasi dalam permintaan perubahan.

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.