Batas dan kuota Data API

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 empat kategori kuota permintaan: Core, Realtime, Funnel, dan Chat.

Permintaan API ke metode Core menagih kuota Core. Permintaan API ke metode Realtime menagih kuota Realtime. Permintaan API ke metode Funnel menagih kuota Funnel. Permintaan API ke metode Chat menagih kuota Chat. Setiap permintaan hanya menggunakan satu jenis kuota.

Kategori kuota Metode API
Core runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports
Realtime runRealtimeReport
Funnel runFunnelReport
Chat properties.chat

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 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 Real-time Per Property Per Jam 40.000 400.000
Realtime Tokens Per Project Per Property Per Hour 14.000 140.000
Permintaan Serentak Real-time 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 Property Per Hour 14.000 140.000
Funnel Concurrent Requests Per Property 10 50
Error Server Funnel Per Project Per Property Per Hour 10 50
Token Chat Per Properti Per Hari 3.750.000 3.750.000
Token Chat Per Properti Per Jam 500.000 500.000
  • Permintaan serentak diukur berdasarkan jumlah permintaan yang dieksekusi secara bersamaan. Untuk mengurangi konkurensi 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 akan diblokir. Untuk mengetahui daftar lengkap respons error, lihat Respons Error.
  • 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 mengirimkan 120 permintaan yang berpotensi mencapai nilai minimum per jam. Dimensi userAgeBracket, userGender, brandingInterest, audienceId, dan audienceName berpotensi dikenai nilai minimum. Volume minimum data 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 dikenai biaya bergantung pada kompleksitas permintaan. Meskipun sebagian besar permintaan akan dikenai biaya 10 token atau kurang, permintaan yang lebih kompleks (seperti kueri chat Ask Advisor) akan menggunakan lebih banyak token.

Faktor yang memengaruhi konsumsi token

Biaya token yang tepat untuk permintaan ditentukan pada saat eksekusi, sehingga pra-penghitungan yang akurat menjadi sulit. Biaya dipengaruhi oleh kombinasi faktor yang terkait dengan permintaan itu sendiri dan data pokok dalam properti Google Analytics. Faktor-faktor berikut 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.

Pemantauan dan konsumsi token chat

Untuk permintaan chat Ask Advisor, token mewakili komputasi model, penalaran, dan biaya pengambilan data yang mendasarinya. Konsumsi token chat dipengaruhi oleh:

  • Cakupan kueri dan analisis: Kompleksitas dan luasnya analisis yang diminta.
  • Token input dan output model: Volume data kontekstual yang diproses dan narasi respons yang dihasilkan.
  • Token pemikiran: Langkah-langkah penalaran model yang diperlukan untuk menyintesis temuan.
  • Latensi eksekusi: Waktu pemrosesan yang diperlukan untuk eksplorasi data multi-langkah.

Untuk memantau penggunaan token chat, tetapkan "returnPropertyQuota": true di ChatRequest Anda. Respons akan menyertakan objek PropertyChatQuota yang berisi kolom tokensPerDay dan tokensPerHour dengan saldo yang digunakan dan tersisa.