Kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Campaign Manager 360 API secara tidak tepat. Mereka memastikan bahwa tindakan satu developer tidak dapat berdampak negatif pada komunitas yang lebih besar.
Batas kuota
Batas kuota default berikut dibagikan oleh semua resource dan metode Campaign Manager 360 API.
- 50.000 permintaan per project per hari - dapat ditingkatkan.
- 1 kueri per detik (QPS) per project.
- Di Konsol Google API, kuota ini disebut sebagai Kueri per menit per pengguna, dan ditetapkan ke 60 secara default. Batas ini dapat ditingkatkan sesuai kebutuhan, hingga maksimum 600 (10 QPS).
Pembuat Laporan menerapkan batas kuota tambahan yang bervariasi menurut akun. Untuk mempelajari lebih lanjut, lihat artikel pusat bantuan ini dan tabel di bawah.
Melebihi batas kuota
Jika permintaan Anda gagal karena melebihi batas kuota, API akan menampilkan kode status HTTP dan alasan error. Selain itu, isi respons berisi deskripsi mendetail tentang penyebab error. Lihat panduan Pesan Error untuk contoh respons error.
Daftar berikut menunjukkan kemungkinan error dan tindakan yang direkomendasikan untuk kegagalan permintaan yang disebabkan oleh melampaui batas kuota.
| Kode | Alasan | Pesan | Tindakan yang Disarankan |
|---|---|---|---|
| 403 | dailyLimitExceeded | Batas Harian Terlampaui | Jangan mencoba lagi tanpa memperbaiki masalah. Periksa penggunaan Anda dari Konsol API Google dan ubah alur kerja Anda untuk membuat lebih sedikit permintaan. Anda dapat meminta kuota tambahan jika Anda yakin penggunaan Anda wajar. |
| 403 | quotaExceeded | Akun ini telah melampaui kuota x laporan per hari. | Jangan mencoba menjalankan laporan lagi untuk akun ini pada hari ini. Hubungi pengelola akun Anda untuk mendapatkan bantuan. |
| 403 | quotaExceeded | Profil pengguna ini telah melampaui kuota x laporan per hari. | Jangan mencoba menjalankan laporan lainnya untuk profil pengguna ini pada hari ini. Beralih ke profil pengguna lain atau hubungi pengelola akun Anda untuk mendapatkan bantuan. |
| 403 | quotaExceeded | Akun ini telah melampaui kuota x laporan terjadwal aktif. | Nonaktifkan laporan terjadwal yang tidak Anda perlukan sebelum mencoba lagi permintaan ini. |
| 403 | quotaExceeded | Profil pengguna yang memiliki laporan ini telah melampaui kuota x laporan terjadwal aktif. | Minta pemilik laporan ini menonaktifkan laporan terjadwal yang tidak diperlukan sebelum mencoba lagi permintaan ini. |
| 403 | quotaExceeded | Profil pengguna ini telah melampaui kuota x laporan terjadwal aktif. | Nonaktifkan laporan terjadwal yang tidak Anda perlukan sebelum mencoba lagi permintaan ini. |
| 403 | quotaExceeded | Tidak dapat menyelesaikan tindakan ini karena salah satu kuota Anda terlampaui. Hubungi pengelola akun Anda untuk meminta bantuan. | Hubungi pengelola akun Anda untuk mendapatkan bantuan. |
| 403 | userRateLimitExceeded | Batas Kapasitas Pengguna Terlampaui | Tingkatkan batas per pengguna di Konsol Google API atau perlambat kecepatan pengiriman permintaan menggunakan penundaan eksponensial. Tidak disarankan untuk membuat permintaan tulis serentak atau menggunakan batas kecepatan yang lebih tinggi dari 10 QPS dengan API ini. |
Meminta kuota harian tambahan
Jika merasa aplikasi Anda memerlukan kuota harian tambahan, Anda dapat meminta lebih banyak dengan mengikuti petunjuk di bawah.
Petunjuk berikut hanya berlaku untuk project yang mengalami error
dailyLimitExceeded. Tindakan yang direkomendasikan untuk error kuota lainnya tercakup dalam tabel di atas.
- Buka Campaign Manager 360 API di Konsol API Google.
- Tinjau statistik penggunaan Anda dari halaman Metrik untuk memastikan aplikasi Anda berperilaku seperti yang diharapkan. Perhatikan baik-baik metode yang telah dipanggil dan atasi penggunaan yang tidak terduga atau berlebihan sebelum melanjutkan.
- Jika penggunaan terlihat normal, buka halaman Kuota, klik ikon edit di samping Kueri per hari, lalu klik link "Ajukan permohonan kuota yang lebih tinggi".
Pastikan untuk meninjau informasi dan mengikuti petunjuk yang disertakan dalam formulir permintaan kuota sebelum mengirimkan permintaan penambahan.