Batas dan Kuota pada Permintaan API

Dokumen ini menjelaskan batas dan kuota untuk meminta Management API dan Reporting API.

Google Analytics digunakan oleh jutaan situs. Kami menerapkan batasan dan kuota pada permintaan API untuk melindungi sistem agar tidak menerima lebih banyak data daripada yang dapat ditanganinya, dan untuk memastikan distribusi resource sistem yang setara. Batas dan kuota dapat berubah.

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, nilai 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 gagal berulang kali. Google Analytics memungkinkan:

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

Jika jumlah permintaan yang gagal melampaui kuota ini, Anda akan menerima 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 peluang error server permintaan, sederhanakan permintaan dengan: mengurangi rentang tanggal, mengurangi jumlah dimensi dalam permintaan, atau mengurangi jumlah metrik dalam permintaan.

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

Kuota tingkat error server diberlakukan selama periode waktu yang berkelanjutan untuk setiap kuota rasio error per jam dan harian. Satu jam setelah project dan melihat error server pertama pasangan, kuota akan direset. Jika pasangan project dan tampilan mengirimkan 10 error server dalam satu jam, project dan pasangan tampilan akan diblokir dari API hingga satu 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 kuotanya. Misalkan 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 pada hari berikutnya, kuota tingkat error server akan direset sepenuhnya untuk project dan tampilan ini.

Analytics Reporting API v4

Kuota ini hanya berlaku untuk Analytics Reporting API v4:

  • Jumlah permintaan per hari per project: 50.000
  • Jumlah permintaan per tampilan (profil) per hari: 10.000 (tidak dapat ditingkatkan)
  • Jumlah permintaan per 100 detik per project: 2.000
  • Jumlah permintaan per 100 detik per pengguna per project: 100 (dapat ditingkatkan di Konsol API Google menjadi 1.000).

Anda dapat melihat kuota project di Konsol API Google.

Kuota Berbasis Resource

Analytics Reporting API v4 juga diatur oleh Kuota Berbasis Resource opsional, yang memungkinkan penggunaan nilai minimum pengambilan sampel yang lebih tinggi untuk pelanggan Analytics 360.

Melebihi batas kuota

Jika kuota permintaan API Google Analytics terlampaui, API akan menampilkan kode error 403 atau 429 dan pesan bahwa akun telah melampaui kuota. Lihat persyaratan layanan untuk mengetahui 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 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 untuk meninjau informasi tersebut dan ikuti 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 (misalnya, Management API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) tercantum pada Analytics API di Konsol API Google.

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