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.

API pengelolaan

Google Analytics menerapkan kuota pada permintaan ke Management API berikut:

API Tulis

Kuota ini berlaku untuk permintaan operasi tulis (insert, update, patch, dan delete):

  • 50 permintaan tulis per project per hari, yang dapat ditingkatkan
  • 1,5 kueri per detik (QPS) per ID Akun

Error permintaan tulis

Jika permintaan tulis gagal dan Anda mendapatkan kode respons 500 atau 503, Anda dapat mengirimnya ulang. Google Analytics memungkinkan:

  • 50 permintaan operasi tulis yang gagal per jam.

Jika Anda mencoba mengirimkan lebih dari 50 permintaan operasi tulis yang gagal per jam, Anda akan menerima error berikut:

Quota Error: The number of recent failed writes is too high.

Daripada terus mengirim ulang permintaan tulis yang gagal, terapkan backoff eksponensial untuk mengirim ulang permintaan tersebut.

API Impor Data

Kuota ini khusus untuk resource Uploads:

  • Batas penyimpanan sepanjang waktu untuk Impor Data yang Diperpanjang (tidak berlaku untuk data hit yang dikirim dari Collection API dan SDK):
  • 50 Set Data per properti
  • 50 operasi upload per properti per hari
  • 1 GB per file yang diupload
  • Batas khusus Data Biaya:
    • 100 MB per tanggal (ga:date) per set data. Misalnya, jika Anda mengimpor data 50 MB untuk tanggal 10-10-2014 dalam satu upload dan data 50 MB untuk tahun 10-10-2014 dalam upload kedua, Anda telah mencapai batas 100 MB untuk tanggal 10-10-2014 untuk set data tersebut.

API Eksperimen

Kuota ini hanya berlaku untuk Eksperimen:

  • 12 Eksperimen per tampilan (profil)

Eksperimen dengan salah satu statuses berikut memengaruhi kuota ini:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

Eksperimen berakhir (status = ENDED) selama lebih dari satu hari tidak dihitung terhadap kuota ini.

API Laporan Tanpa Sampel

Kuota ini hanya berlaku untuk Laporan Tanpa Sampel:

  • Permintaan API untuk membuat laporan tanpa sampel dihitung terhadap kuota Permintaan Tulis umum.
  • API ini menggunakan sistem token per properti, per hari yang sama dengan yang digunakan antarmuka web untuk membuat laporan tanpa sampel.
  • Jumlah maksimum laporan tanpa sampel yang diizinkan adalah 3.500. Saat batas ini tercapai, mencoba membuat laporan tanpa sampel lebih lanjut dengan hasil API akan dalam error berikut: 
    Error creating this entity. You have reached the maximum allowed entities of this type.

API Izin Pengguna

Kuota ini hanya berlaku untuk Izin Pengguna:

  • Pengguna dapat memiliki maksimal 100 akun Analytics. Menambahkan pengguna yang memiliki 100 akun Analytics ke akun baru akan menyebabkan error.

Kuota berikut berlaku untuk permintaan batch (delete, insert, update) ke izin pengguna:

  • 300 permintaan tulis izin pengguna per permintaan batch
  • 30 permintaan penulisan izin pengguna batch yang dihitung sebagai 1 permintaan tulis

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.