Batas dan Kuota pada Permintaan API

Dokumen ini menjelaskan batas dan kuota permintaan Management API dan Reporting API.

Google Analytics digunakan oleh jutaan situs. Kami menetapkan batas dan kuota pada permintaan API untuk melindungi sistem agar tidak menerima lebih banyak data daripada yang dapat ditangani, dan untuk memastikan distribusi resource sistem yang setara. Batas dan kuota dapat berubah sewaktu-waktu.

Video ini membahas praktik terbaik untuk mengelola kuota permintaan Google Analytics API.

Batas kuota umum

Kuota berikut berlaku untuk Management API, Core Reporting API v3, MCF Reporting API, Metadata API, User Deletion API, dan Real Time Reporting API:

  • 50.000 permintaan per project per hari, yang dapat ditingkatkan.
  • 10 kueri per detik (QPS) per alamat IP.
    • Di Konsol API, ada kuota serupa yang disebut sebagai Permintaan per 100 detik per pengguna. Secara default, hal ini ditetapkan ke 100 permintaan per 100 detik per pengguna dan dapat disesuaikan ke nilai maksimum 1.000. Namun, jumlah permintaan ke API dibatasi hingga maksimum 10 permintaan per detik per pengguna.
    • Jika aplikasi Anda membuat semua permintaan API dari satu alamat IP (yaitu, atas nama pengguna), gunakan parameter userIP atau quotaUser dengan setiap permintaan untuk mendapatkan kuota QPS penuh untuk setiap pengguna. Lihat ringkasan parameter kueri standar untuk mengetahui detailnya.

Reporting APIs

Kuota berikut berlaku untuk semua Reporting API, termasuk Core Reporting API v3, Analytics Reporting API v4, Real Time API v3, dan Multi-channel Funnel API v3:

  • 10.000 permintaan per tampilan (profil) per hari (tidak dapat ditingkatkan)
  • 10 permintaan serentak per tampilan (profil) (tidak dapat ditingkatkan)

Error permintaan Reporting API

Jika permintaan ke Reporting API gagal dengan error server, Anda akan mendapatkan kode respons 500 atau 503. Anda dapat mengirim ulang permintaan. Namun, jangan mengirim ulang permintaan ini lebih dari sekali jika berulang kali gagal. Google Analytics memungkinkan:

  • 10 permintaan error server gagal per project per tampilan (profil) per jam
  • 50 permintaan error server gagal per project per tampilan (profil) per hari

Jika jumlah permintaan yang gagal melebihi kuota ini, Anda akan mendapatkan error berikut:

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

Untuk mengurangi kemungkinan error server permintaan, sederhanakan permintaan dengan: mengurangi rentang tanggal, mengurangi jumlah dimensi dalam permintaan, atau mengurangi jumlah metrik dalam permintaan.

Jangan terus mengirim ulang permintaan yang gagal. Sebagai gantinya, terapkan backoff eksponensial untuk mengirimnya ulang.

Kuota tingkat error server diterapkan berdasarkan periode waktu yang bergulir untuk setiap kuota tingkat error per jam dan harian. Satu jam setelah error server pertama pada pasangan project dan tampilan, kuota akan direset. Jika pasangan project dan tampilan mengirimkan 10 error server dalam satu jam, pasangan project dan tampilan diblokir dari API hingga jam setelah error server pertama berlalu.

Misalnya, jika pasangan project dan tampilan belum mengirim error server dalam 24 jam terakhir, project dan tampilan ini akan menggunakan 0 dari kuota 50-nya. Misalnya, project dan tampilan ini sekarang mengirim error server pada pukul 06.12. Jika project dan tampilan ini mengirimkan 49 error server tambahan sebelum pukul 06.12 di hari berikutnya, project dan tampilan ini akan diblokir hingga pukul 06.12 di hari berikutnya. Pada pukul 06.12 hari berikutnya, kuota tingkat error server akan direset sepenuhnya untuk project dan tampilan ini.

Melebihi batas kuota

Jika kuota permintaan Google Analytics API terlampaui, API akan menampilkan kode error 403 atau 429 dan pesan bahwa akun telah melampaui kuota. Lihat persyaratan layanan untuk informasi selengkapnya.

Meminta kuota tambahan

Anda hanya dapat meminta untuk meningkatkan:

Untuk melihat atau mengubah batas penggunaan untuk project Anda atau meminta penambahan kuota, lakukan hal berikut ini:

  1. Jika Anda belum memiliki akun penagihan untuk project, buat akun penagihan.
  2. Buka halaman API yang Diaktifkan dari library API di Konsol API, lalu pilih API dari daftar.
  3. Untuk melihat dan mengubah setelan terkait kuota, pilih Kuota. Untuk melihat statistik penggunaan, pilih Penggunaan.

Untuk meminta peningkatan jumlah kuota maksimum, gunakan formulir permintaan kuota Analytics API. Pastikan Anda meninjau informasi dan mengikuti petunjuk dalam formulir permintaan kuota sebelum mengirimkan permintaan. Untuk Reporting API v4, nama API di Konsol API Google adalah Google Analytics Reporting API. Semua API v3 lainnya (mis., Management API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) tercantum di bagian Analytics API di Konsol API Google.

Untuk mengetahui informasi selengkapnya tentang pengelolaan kuota dan cara menyesuaikan aplikasi untuk penggunaan kuota, lihat Memantau API dan membatasi penggunaan.