Setiap permintaan API memverifikasi bahwa kuota belum habis dan telah menggunakan kuota. Jika kuota habis, permintaan akan gagal dengan pesan error yang relevan. Setiap permintaan Data API akan memeriksa beberapa bucket kuota.
Kategori Kuota
Untuk tujuan kuota, Data API memiliki tiga kategori permintaan: Core, Realtime, dan Funnel. Permintaan API ke metode Core menagih kuota Core. Permintaan API ke metode Realtime menagih kuota Realtime. Satu permintaan tidak akan menggunakan kuota Core & Realtime. Berikut adalah metode dan kategori API:
| Kategori Kuota | Metode API |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| Realtime | runRealtimeReport |
| Funnel | runFunnelReport |
Kuota 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 Properti 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 Realtime Per Properti Per Hari | 200.000 | 2.000.000 |
| Token Realtime Per Properti Per Jam | 40.000 | 400.000 |
| Token Realtime Per Project Per Properti Per Jam | 14.000 | 140.000 |
| Permintaan Serentak Realtime Per Properti | 10 | 50 |
| Error Server Realtime Per Project Per Properti Per Jam | 10 | 50 |
| Token Funnel Per Properti Per Hari | 200.000 | 2.000.000 |
| Token Funnel Per Properti Per Jam | 40.000 | 400.000 |
| Token Funnel Per Project Per Properti Per Jam | 14.000 | 140.000 |
| Permintaan Serentak Funnel Per Properti | 10 | 50 |
| Error Server Funnel Per Project Per Properti Per Jam | 10 | 50 |
- Permintaan serentak diukur dengan jumlah permintaan yang dijalankan secara bersamaan. Untuk mengurangi permintaan serentak, tunggu permintaan sebelumnya selesai sebelum mengirim permintaan tambahan.
- Error Server adalah kode 500 dan 503. Kuota Error Server hanya dikenai biaya saat terjadi Error Server permintaan. 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 120 permintaan yang berpotensi mencapai nilai minimum per jam. Dimensi
userAgeBracket, userGender, brandingInterest, audienceId,
dan audienceName berpotensi mencapai nilai minimum. Batas diterapkan agar orang yang melihat laporan tidak dapat menyimpulkan demografi atau minat setiap pengguna.
Kuota Token Properti
Token dihitung dengan setiap permintaan, bergantung pada kerumitan permintaan yang harus diselesaikan. Sebagian besar permintaan akan mengenakan biaya 10 token atau kurang. Saat sejumlah besar token kuota digunakan oleh permintaan, faktor-faktor berikut sering kali menjadi penyebab:
- Sejumlah besar baris
- Sejumlah besar kolom
- Kriteria filter kompleks
- Rentang tanggal yang panjang
Dengan setiap permintaan API, Anda dapat menentukan "returnPropertyQuota": true dalam isi permintaan untuk menampilkan status token kuota properti saat ini. Status ini
berisi jumlah yang terpakai oleh permintaan ini dan jumlah yang tersisa
untuk setiap grup kuota. Misalnya, pertimbangkan untuk menentukan parameter ini di
RunReportRequest.