Batas dan Kuota API

Google Ads API menerapkan batasan pada operasi API, seperti jumlah operasi yang dapat dikirim dalam satu permintaan mutasi. Tabel di bawah ini meringkas beberapa batasan dan kuota penting yang harus diperhatikan.

Jenis Permintaan, Batasan, dan Kode Error
Permintaan dengan penomoran halaman 10.000 baris per halaman INVALID_PAGE_SIZE
Operasi dengan Akses Dasar 15.000 operasi API per hari RESOURCE_EXHAUSTED
Mendapatkan permintaan 1.000 permintaan per hari RESOURCE_EXHAUSTED
Mutasi permintaan 10.000 operasi per permintaan TOO_MANY_MUTATE_OPERATIONS
Permintaan Jasa 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 jumlah total operasi get dan operasi mutasi. 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 melampaui batas ini. Misalnya, permintaan penelusuran yang menyertakan banyak kolom dapat menghasilkan respons yang berukuran lebih dari 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 pesan dan kode error gRPC.

Dapatkan permintaan (tidak digunakan lagi)

Dapatkan permintaan (misalnya, menggunakan metode GetCampaign pada CampaignService) memiliki batasan penggunaan harian yang terpisah dari batas operasi, yang diuraikan dalam panduan Tingkat Akses dan Penggunaan yang Diizinkan.

Tidak seperti operasi harian, batas permintaan mendapatkan tidak bervariasi menurut tingkat akses. Semua token developer, termasuk yang memiliki Akses Standar, dibatasi hingga 1.000 permintaan per hari.

Tidak seperti permintaan penelusuran, permintaan get mahal karena semua data atribut diambil. Oleh karena itu, sebaiknya gunakan penelusuran daripada mendapatkan hasil jika memungkinkan.

Permintaan yang melanggar batas ini akan ditolak dengan error: RESOURCE_EXHAUSTED.

Mutasi permintaan

Selain mengurangi kuota operasi harian pengguna, permintaan mutasi tidak boleh berisi lebih dari 10.000 operasi per permintaan.

Permintaan yang melanggar batasan ini akan 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 dengan penomoran halaman

Permintaan dengan penomoran halaman (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 habis masa berlakunya atau tidak valid akan menghasilkan pengecualian dan akan mengurangi kuota operasi harian.

Permintaan yang memiliki penomoran halaman, seperti permintaan penelusuran, juga tunduk pada pembatasan Page size cannot exceed 10,000 rows dan ditolak jika melanggar batas ini, dengan error: INVALID_PAGE_SIZE.

Untuk detail selengkapnya tentang penomoran halaman, lihat Paging melalui hasil.

Jenis permintaan lain

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 mengurangi kuota operasi harian pengguna.

Permintaan yang gagal tetapi tidak menampilkan GoogleAdsFailure, seperti dari error pada tingkat jaringan, tidak akan mengurangi kuota operasi harian pengguna karena permintaan tidak akan pernah mencapai layanan. Contohnya adalah kegagalan konektivitas jaringan.

Jasa perencanaan

Karena biaya dan kerumitan, metode layanan Perencanaan yang tercantum di bawah tunduk pada batas terpisah dari jenis permintaan lainnya.

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

Layanan upload penyesuaian konversi

Layanan penagihan dan anggaran akun

  • Mutasi hanya dapat dilakukan terhadap akun yang dikonfigurasi untuk invoice bulanan.

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

  • Hanya operasi 1 yang diizinkan untuk mengubah permintaan.

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

  • Anda harus menunggu setidaknya 12 jam antara perubahan urutan 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 mengirim email undangan kepada pengguna lain, fungsi ini berpotensi disalahgunakan, sehingga ada batasan perilakunya:

Data pengguna

Data pengguna dikelola dengan UserDataService dan OfflineUserDataJobService. Pada operasi buat/hapus UserData yang ditentukan, setiap kumpulan user_identifiers harus spesifik untuk satu pengguna.

Untuk menerapkan ini, 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 pembatasan ini dan membuat permintaan yang menggunakan kolom berulang, coba kurangi jumlah item di 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.