Kuota Berbasis Resource

Dokumen ini menjelaskan sistem Kuota Berbasis Resource untuk Google Analytics Reporting API v4, yang hanya tersedia untuk pelanggan Analytics 360. Lihat Batas dan Kuota API untuk mengetahui kumpulan batas lengkap yang diterapkan pada API.

Pengantar

Untuk memastikan ketersediaan dan keandalan resource bersama, setiap project yang mengakses Analytics Reporting API akan tunduk pada batas dan kuota. Saat membuat kueri untuk set data yang besar, pengambilan sampel dapat digunakan oleh Analytics Reporting API, yang dapat memengaruhi hasil data Anda.

Sistem kuota berbasis resource adalah sistem kuota baru yang akan memungkinkan akun Analytics 360 memiliki nilai minimum pengambilan sampel yang lebih tinggi saat menggunakan Analytics Reporting API. Sistem ini bersifat opsional dan tidak bergantung pada batas yang diterapkan pada tampilan dan project, seperti yang dilaporkan di halaman kuota Konsol Google API.

Kuota berbasis resource

Tidak semua permintaan dibuat sama; sebagian permintaan secara komputasi jauh lebih mahal daripada yang lainnya. Sistem kuota berbasis resource dirancang untuk mendukung nilai minimum pengambilan sampel sekaligus tetap melindungi infrastruktur Pelaporan Analytics.

Setiap properti akan dialokasikan sejumlah token resource kueri. Klien API dapat menambahkan kolom opsional ke permintaan API untuk mendapatkan nilai minimum pengambilan sampel yang lebih besar sebagai pengganti token resource kueri relatif. Permintaan yang lebih mahal secara komputasi akan memerlukan lebih banyak token.

Nilai minimum pengambilan sampel

Permintaan data yang menggunakan Google Analytics API v4 tunduk pada nilai minimum pengambilan sampel umum berikut berdasarkan jumlah sesi untuk rentang tanggal yang diminta (di tingkat properti):

  • Analytics Standar: 500 ribu sesi
  • Analytics 360: 1 juta sesi
  • Analytics 360 menggunakan kuota berbasis resource: 100 juta sesi

Aktifkan Kuota Berbasis Resource

Untuk mengaktifkan kuota berbasis resource untuk permintaan tertentu, panggilan API harus menyertakan kolom opsional useResourceQuotas dalam metode batchGet.

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

Contoh:

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

Kolom respons biaya resource kueri

Untuk setiap panggilan ke metode batchGet, respons akan memiliki kolom queryCost.

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

Kolom queryCost adalah bilangan bulat yang mewakili total biaya resource dari semua ReportRequests dalam permintaan batchGet. Contoh:

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

Alokasi kuota

Kuota properti Analytics 360

  • 100.000 unit biaya kueri per hari per properti.
  • 25.000 unit biaya kueri per jam per properti.

Jika Anda melebihi batas kuota, Anda akan menerima pesan error RESOURCE_EXHAUSTED. Lihat Respons Error untuk mengetahui detailnya.

Penghitungan biaya

Biaya permintaan sebanding dengan:

  • Ukuran rentang tanggal.
  • Jumlah klik dalam tampilan.
  • Kardinalitas dimensi yang diminta.
  • Jumlah dimensi dan metrik yang diminta.
  • Kompleksitas definisi segmen dan filter.
  • Status pemrosesan informasi yang diminta (meminta data hari ini lebih mahal daripada meminta data kemarin).
  • Kehadiran dimensi dan metrik Impor Waktu Kueri.

Batas dan penggunaan API

Selain sistem kuota berbasis resource, API juga diatur oleh batas dan kuota di Analytics API v4.

Catatan

  • Kolom respons queryCost mewakili biaya komputasi permintaan. Ini bukan biaya dan API bebas digunakan.
  • Laporan data harian dan data historis tertentu (1+ tahun) mungkin masih dapat diambil sampelnya, terlepas dari setelan useResourceQuotas.
  • Jika nilai minimum pengambilan sampel yang lebih tinggi tidak dapat dipenuhi untuk permintaan, token kuota resource tidak akan dipotong (respons sampel selalu memiliki biaya kuota resource nol).
  • Laporan berisi data sampel jika kolom samplesReadCounts, samplingSpaceSizes ada dalam respons.

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.