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
atauquotaUser
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):
- Batas Analytics 360 untuk mode impor waktu pemrosesan:
- 1 TB per properti
- 20 GB per set data
- Batas Analytics 360 untuk mode impor waktu kueri:
- 1 GB per properti
- 1 GB per set data
- Batas standar:
- 10 GB per properti
- 10 GB per set data
- Batas Analytics 360 untuk mode impor waktu pemrosesan:
- 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.
- 100 MB per tanggal (
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:
- Jumlah permintaan baca harian per project (50.000 default)
- Jumlah permintaan tulis harian per project (50 default)
Untuk melihat atau mengubah batas penggunaan untuk project Anda atau meminta penambahan kuota, lakukan hal berikut ini:
- Jika Anda belum memiliki akun penagihan untuk project, buat akun penagihan.
- Buka halaman API yang Diaktifkan dari library API di Konsol API, lalu pilih API dari daftar.
- 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.