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, kebijakan ini disetel ke 100 permintaan per 100 detik per pengguna dan dapat disesuaikan dengan 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 bagi 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)
Panggilan Analytics Real Time Reporting API dihitung secara terpisah dari Analytics API lainnya, yang berarti Anda dapat melakukan 10.000 panggilan per hari per tampilan (profil) menggunakan Analytics Real Time Reporting API DAN melakukan 10.000 panggilan lain per hari per tampilan (profil) menggunakan API Analytics lainnya.

Perilaku ini memberikan pendekatan yang lebih terperinci dan aman untuk pengelolaan kuota, sehingga panggilan yang sering dilakukan menggunakan Analytics Real Time Reporting API tidak akan secara tidak sengaja memblokir semua panggilan Analytics API lainnya sepanjang sisa hari itu untuk tampilan individual (profil).

Error permintaan Reporting API

Jika permintaan ke Reporting API gagal dengan menampilkan 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, implementasikan backoff eksponensial untuk mengirim ulang.

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

Misalnya, jika pasangan project dan tampilan belum mengirimkan error server dalam 24 jam terakhir, project dan tampilan ini akan menggunakan 0 dari 50 kuotanya. Anggap project dan tampilan ini sekarang mengirimkan 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 melebihi 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 informasi selengkapnya tentang pengelolaan kuota dan cara menyesuaikan aplikasi untuk penggunaan kuota, lihat Memantau API dan membatasi penggunaan.