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.

API pengelolaan

Google Analytics menerapkan kuota untuk permintaan ke Management API ini:

API Penulisan

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

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

Error permintaan penulisan

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

  • 50 permintaan operasi tulis yang gagal per jam.

Jika Anda mencoba mengirimkan lebih dari 50 permintaan tulis yang gagal per jam, Anda akan mendapatkan 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 mengirimnya ulang.

API Impor Data

Kuota ini khusus untuk resource Uploads:

  • Batas penyimpanan Impor Data yang Diperpanjang sepanjang waktu (tidak berlaku untuk data hit yang dikirim dari Collection API dan SDK):
  • 50 Set Data per properti
  • 50 operasi upload per properti setiap harinya
  • 1 GB per file yang diupload
  • Batas spesifik Data Biaya:
    • 100 MB per tanggal (ga:date) per set data. Misalnya, jika Anda mengimpor 50 MB data untuk tanggal 10-10-2014 dalam satu upload dan 50 MB data untuk tanggal 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 diperhitungkan dalam kuota ini:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

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

API Laporan Tanpa Sampel

Kuota ini hanya berlaku untuk Laporan Tanpa Sampel:

  • Permintaan API untuk membuat laporan tanpa sampel dihitung dalam kuota Permintaan Tulis umum.
  • API 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 API akan menghasilkan 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 penulisan batch (delete, insert, update) untuk izin pengguna:

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

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.