Batas dan kuota berikut berlaku untuk Data API.
Cara penerapan kuota
Semua permintaan ke Google Analytics Data API v1 memerlukan project Google Cloud dan tunduk pada kuota yang diuraikan di halaman ini. Kuota digunakan terlepas dari metode yang digunakan untuk mengidentifikasi project yang memanggil, termasuk:
- Permintaan yang diautentikasi dengan kredensial OAuth 2.0.
- Permintaan yang diautentikasi hanya menggunakan kunci API.
Kunci API digunakan untuk mengaitkan permintaan dengan project Google Cloud tertentu untuk tujuan kuota dan penagihan. Semua panggilan API yang dilakukan menggunakan kredensial atau kunci API dari project Anda akan dihitung berdasarkan kuota yang berlaku untuk project dan properti Google Analytics.
Kategori kuota
Data API memiliki tiga kategori kuota permintaan: Core, Realtime, dan Funnel. Permintaan API ke metode Core menagih kuota Core. Permintaan API ke metode Realtime menagih kuota Realtime. Setiap permintaan hanya menggunakan satu jenis kuota.
| Kategori kuota | Metode API |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| Realtime | runRealtimeReport |
| Funnel | runFunnelReport |
Kouta properti Analytics
Semua permintaan menggunakan kuota properti.
| Nama Kuota | Batas Properti Standar | Batas Properti Analytics 360 |
|---|---|---|
| Token Inti Per Properti Per Hari | 200.000 | 2.000.000 |
| Token Inti Per Properti Per Jam | 40.000 | 400.000 |
| Token Inti Per Project Per Property Per Jam | 14.000 | 140.000 |
| Permintaan Serentak Inti Per Properti | 10 | 50 |
| Error Server Inti Per Project Per Properti Per Jam | 10 | 50 |
| Token Real-time Per Properti Per Hari | 200.000 | 2.000.000 |
| Token Realtime Per Property Per Jam | 40.000 | 400.000 |
| Token Realtime Per Project Per Property Per Hour | 14.000 | 140.000 |
| Permintaan Serentak Real-time Per Properti | 10 | 50 |
| Realtime Server Errors Per Project Per Property Per Hour | 10 | 50 |
| Token Funnel Per Properti Per Hari | 200.000 | 2.000.000 |
| Token Corong Per Properti Per Jam | 40.000 | 400.000 |
| Token Funnel Per Project Per Property Per Hour | 14.000 | 140.000 |
| Permintaan Serentak Funnel Per Properti | 10 | 50 |
| Error Server Corong Per Project Per Properti Per Jam | 10 | 50 |
- Permintaan serentak diukur berdasarkan jumlah permintaan yang dieksekusi secara bersamaan. Untuk mengurangi serentak permintaan, tunggu hingga permintaan sebelumnya selesai sebelum mengirimkan permintaan tambahan.
- Error Server adalah kode 500 dan 503. Kuota Error Server hanya dikenai biaya jika permintaan menghasilkan error server. Jika kuota Error Server habis untuk pasangan project dan properti, semua permintaan ke properti dari project tersebut akan diblokir.
- Setiap permintaan menggunakan kuota untuk Token Per Properti Per Jam dan Token Per Project Per Properti Per Jam. Artinya, satu properti harus diakses oleh lebih dari 3 project sebelum kuota "Token Per Properti Per Jam" dapat habis sebelum kuota "Token Per Project Per Properti Per Jam".
Properti diizinkan untuk membuat 120 permintaan yang berpotensi mencapai nilai minimum per jam. Dimensi userAgeBracket, userGender, brandingInterest, audienceId, dan audienceName berpotensi memiliki nilai minimum. Nilai minimum diterapkan agar siapa pun yang melihat laporan tidak dapat menyimpulkan demografi atau minat setiap pengguna.
Kuota token properti
Token digunakan dengan setiap permintaan ke Google Analytics Data API v1. Jumlah token yang dikenakan biaya bergantung pada kompleksitas permintaan. Meskipun sebagian besar permintaan akan dikenai biaya 10 token atau kurang, permintaan yang lebih kompleks akan menggunakan lebih banyak token.
Faktor yang memengaruhi konsumsi token
Biaya token yang tepat untuk permintaan ditentukan pada saat eksekusi, sehingga pra-penghitungan yang tepat menjadi sulit. Biaya dipengaruhi oleh kombinasi faktor yang terkait dengan permintaan itu sendiri dan data pokok di properti Google Analytics. Faktor-faktor ini dapat menyebabkan biaya yang lebih tinggi:
- Jumlah baris: Meminta jumlah baris yang lebih besar.
- Jumlah dimensi dan metrik: Menyertakan lebih banyak dimensi dan metrik.
- Kompleksitas filter: Menggunakan ekspresi filter yang kompleks.
- Panjang rentang tanggal: Membuat kueri selama periode tanggal yang lebih lama.
- Kardinalitas data: Dimensi dengan kardinalitas tinggi (banyak nilai unik, seperti
pagePath, dimensi kustom) dapat meningkatkan biaya token secara signifikan. - Volume peristiwa properti: Kueri pada properti dengan volume peristiwa yang lebih tinggi dapat menggunakan lebih banyak token daripada kueri yang sama pada properti dengan lebih sedikit data.
Memantau penggunaan token
Cara paling efektif untuk menentukan biaya token untuk panggilan API tertentu adalah dengan menyertakan parameter "returnPropertyQuota": true dalam isi permintaan.
Respons API kemudian akan menyertakan objek PropertyQuota, yang menjelaskan
token yang digunakan oleh permintaan tertentu tersebut dan saldo kuota yang tersisa.