Kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Campaign Manager 360 API dengan cara yang tidak tepat. Tag tersebut memastikan bahwa tindakan salah satu developer tidak dapat berdampak negatif pada komunitas yang lebih luas.
Batas kuota
Batas kuota default berikut digunakan bersama oleh semua resource Campaign Manager 360 API dan metode.
- 50.000 permintaan per project per hari - dapat ditingkatkan.
- 1 kueri per detik (QPS) per project.
- Di Konsol API Google, kuota ini disebut sebagai Kueri per menit per pengguna, dan disetel ke 60 secara default. Batas ini dapat dinaikkan sesuai kebutuhan, hingga maksimum 600 (10 QPS).
Pembuat Laporan menerapkan batas kuota tambahan yang bervariasi menurut akun. Untuk mempelajari selengkapnya, lihat artikel pusat bantuan ini dan tabel di bawah.
Melampaui batas kuota
Jika permintaan Anda gagal karena melebihi batas kuota, API menampilkan kode status HTTP beserta alasan error-nya. Selain itu, isi respons berisi deskripsi mendetail tentang penyebab error. Lihat panduan Pesan Error untuk mengetahui 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 Google API dan ubah alur kerja Anda untuk membuat lebih sedikit permintaan. Anda dapat meminta kuota tambahan jika Anda yakin bahwa 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 Account Manager Anda untuk mendapatkan bantuan. |
| 403 | quotaExceeded | Profil pengguna ini telah melampaui kuota x laporan per hari. | Jangan mencoba menjalankan laporan lagi untuk profil pengguna ini pada hari ini. Beralihlah ke profil pengguna lain atau hubungi Account Manager Anda untuk mendapatkan bantuan. |
| 403 | quotaExceeded | Akun ini telah melampaui kuota x laporan terjadwal aktif. | Nonaktifkan laporan terjadwal yang tidak diperlukan sebelum mencoba kembali permintaan ini. |
| 403 | quotaExceeded | Profil pengguna yang memiliki laporan ini telah melampaui kuota x laporan terjadwal yang aktif. | Minta pemilik laporan ini untuk menonaktifkan laporan terjadwal yang tidak diperlukan sebelum mencoba kembali 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 Account Manager Anda untuk mendapatkan bantuan. |
| 403 | userRateLimitExceeded | Batas Jumlah Pengguna Terlampaui | Tingkatkan batas per pengguna di Konsol API Google atau perlambat kecepatan pengiriman permintaan menggunakan backoff eksponensial. Sebaiknya jangan membuat permintaan tulis serentak atau menggunakan batas kapasitas yang lebih tinggi dari 10 QPS dengan API ini. |
Meminta kuota harian tambahan
Jika menurut Anda aplikasi memerlukan kuota harian tambahan, Anda dapat meminta lebih banyak dengan mengikuti petunjuk di bawah.
Petunjuk berikut hanya berlaku untuk project yang telah mengalami
dailyLimitExceeded error. Tindakan yang disarankan untuk error kuota lainnya
yang dibahas dalam tabel di atas.
- Buka Campaign Manager 360 API di Konsol Google API.
- Tinjau statistik penggunaan Anda dari halaman Metrics untuk memastikan aplikasi berperilaku seperti yang diharapkan. Perhatikan baik-baik metode yang telah dipanggil dan mengatasi penggunaan yang tidak terduga atau berlebihan sebelum melanjutkan.
- Jika penggunaan terlihat normal, buka halaman Quotas, klik ikon edit di samping Kueri per hari, lalu klik link "Ajukan kuota yang lebih tinggi".
Pastikan Anda meninjau informasi dan mengikuti petunjuk yang disertakan dalam formulir permintaan kuota sebelum mengirimkan permintaan penambahan kuota.