Kuota Berbasis Resource

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

Pengantar

Untuk memastikan ketersediaan dan keandalan resource bersama, setiap project yang mengakses Analytics Reporting API memiliki batasan dan kuota. Saat membuat kueri set data 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 ditetapkan pada tampilan dan project, seperti yang dilaporkan di halaman kuota Konsol API Google.

Kuota berbasis resource

Tidak semua permintaan dibuat sama; beberapa permintaan komputasi jauh lebih mahal daripada yang lain. Sistem kuota berbasis resource dirancang untuk mendukung nilai minimum pengambilan sampel yang lebih tinggi sambil tetap melindungi infrastruktur Pelaporan Analytics.

Jumlah token resource kueri yang ditetapkan akan ditetapkan ke setiap properti. Klien API dapat menambahkan kolom opsional ke permintaan API untuk mendapatkan batas sampling yang lebih tinggi sebagai imbalan atas token resource kueri relatif. Permintaan yang lebih mahal secara komputasi akan membutuhkan lebih banyak token.

Nilai minimum pengambilan sampel

Permintaan data 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

Guna 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, responsnya akan memiliki kolom queryCost.

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

Kolom queryCost adalah bilangan bulat yang mewakili total biaya resource 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 melebihi batas kuota, Anda akan menerima 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).
  • Keberadaan 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 merepresentasikan biaya komputasi permintaan. Ini bukan biaya, dan API ini gratis untuk digunakan.
  • Laporan data historis tertentu dan data intrahari (lebih dari 1 tahun) mungkin masih dapat diambil sampelnya, terlepas dari setelan useResourceQuotas.
  • Jika nilai minimum pengambilan sampel yang lebih tinggi tidak dapat dipenuhi untuk sebuah permintaan, token kuota resource tidak akan dikurangi (respons sampel selalu memiliki biaya kuota resource nol).
  • Laporan berisi sampel data 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.