Kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Campaign Manager 360 API dengan cara yang tidak pantas. Mereka memastikan bahwa tindakan satu developer tidak dapat berdampak negatif pada komunitas yang lebih besar.
Batas kuota
Batas kuota default berikut digunakan bersama 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 API Google, kuota ini disebut sebagai Kueri per menit per pengguna, dan ditetapkan ke 60 secara default. Batas ini dapat ditambahkan 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 memuat deskripsi mendetail tentang penyebab error tersebut. Lihat panduan Pesan Error untuk contoh respons error.
Daftar berikut menunjukkan kemungkinan error dan tindakan yang disarankan untuk kegagalan permintaan yang disebabkan oleh melebihi batas kuota.
| Kode | Alasan | Pesan | Tindakan yang Disarankan |
|---|---|---|---|
| 403 | Batas Harian terlampaui | Batas Harian Terlampaui | Jangan mencoba lagi tanpa memperbaiki masalah. Periksa penggunaan Anda dari Konsol API Google dan ubah alur kerja Anda untuk membuat permintaan yang lebih sedikit. Anda dapat meminta kuota tambahan jika yakin bahwa penggunaan Anda wajar. |
| 403 | Kuota terlampaui | Akun ini telah melampaui kuota x laporan per hari. | Jangan coba jalankan laporan lainnya untuk akun ini pada hari ini. Hubungi Account Manager Anda untuk mendapatkan bantuan. |
| 403 | Kuota terlampaui | Profil pengguna ini telah melampaui kuota x laporan per hari. | Jangan coba jalankan laporan lagi untuk profil pengguna ini pada hari ini. Beralih ke profil pengguna lain atau hubungi Account Manager Anda untuk mendapatkan bantuan. |
| 403 | Kuota terlampaui | Akun ini telah melampaui kuota x laporan terjadwal aktif. | Nonaktifkan laporan terjadwal yang tidak diperlukan sebelum mencoba lagi permintaan ini. |
| 403 | Kuota terlampaui | 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 kembali permintaan ini. |
| 403 | Kuota terlampaui | Profil pengguna ini telah melampaui kuota x laporan terjadwal aktif. | Nonaktifkan laporan terjadwal yang tidak diperlukan sebelum mencoba lagi permintaan ini. |
| 403 | Kuota terlampaui | Tidak dapat menyelesaikan tindakan ini karena salah satu kuota Anda terlampaui. Harap hubungi pengelola akun Anda untuk mendapatkan bantuan. | Hubungi Account Manager Anda untuk mendapatkan bantuan. |
| 403 | penggunaRateLimitMelebihi | Batas Kapasitas Pengguna Terlampaui | Tingkatkan batas per pengguna di Konsol API Google atau perlambat laju pengiriman permintaan menggunakan backoff eksponensial. Sebaiknya jangan membuat permintaan tulis serentak atau menerapkan batas kapasitas yang lebih tinggi dari 10 QPS dengan API ini. |
Meminta kuota harian tambahan
Jika Anda merasa bahwa aplikasi memerlukan kuota harian tambahan, Anda dapat meminta lebih banyak dengan mengikuti petunjuk di bawah ini.
Petunjuk berikut hanya berlaku pada project yang mengalami error dailyLimitExceeded. Tindakan yang disarankan untuk error kuota lainnya dibahas dalam tabel di atas.
- Buka Campaign Manager 360 API di Konsol API Google.
- Tinjau statistik penggunaan dari halaman Metrics untuk memastikan aplikasi Anda berperilaku seperti yang diharapkan. Perhatikan 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 permintaan kuota yang lebih tinggi".
Pastikan untuk meninjau informasi dan ikuti petunjuk yang disertakan dalam formulir permintaan kuota sebelum mengirimkan permintaan peningkatan.