Halaman ini menunjukkan cara memulai Google Analytics Data API v1 menggunakan command line.
Langkah 1. Mengaktifkan API
Klik tombol ini untuk membuat project Cloud Platform baru, aktifkan Google Analytics Data API v1 secara otomatis, dan buat kredensial OAuth2 yang diperlukan untuk tutorial ini:
Mengaktifkan Google Analytics Data API v1Anda akan otomatis dialihkan ke dialog konfigurasi kredensial OAuth2. Pilih "Desktop" saat ditanya "Dari mana Anda menelepon?"
Pada dialog yang muncul, klik DOWNLOAD CLIENT CONFIGURATION dan simpan file
credentials.json
ke direktori kerja Anda.
Atau, Anda dapat mengikuti langkah-langkah untuk membuat Kredensial OAuth2 dalam project yang sudah ada secara manual.
Langkah 2: Menginstal dan melakukan inisialisasi Cloud SDK
Anda memerlukan alat command line gcloud yang terinstal di mesin pengembangan.
Langkah 3: Lakukan panggilan API
Sekarang Anda dapat menggunakan Google Analytics Data API untuk membuat kueri properti Google Analytics 4.
Pilih Entitas Pelaporan
Dalam tutorial ini, kita akan menggunakan variabel lingkungan GA4_PROPERTY_ID
untuk menyimpan ID properti yang akan digunakan dalam permintaan API.
Masukkan baris berikut pada command line untuk menetapkan variabel GA4_PROPERTY_ID
:
export GA4_PROPERTY_ID=[YOUR-GA4-PROPERTY-ID]
Ganti [YOUR-GA4-PROPERTI-ID] dengan ID properti Google Analytics 4 Anda. Contoh:
export GA4_PROPERTY_ID=1234567890
Membuat JSON Permintaan
File request.json
berikut menunjukkan cara membuat laporan sederhana.
Buat file permintaan JSON dengan teks berikut, dan simpan sebagai file teks biasa request.json di direktori kerja Anda:
request.json
{
"dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
"dimensions": [{ "name": "country" }],
"metrics": [{ "name": "activeUsers" }]
}
Autentikasikan
Untuk mendapatkan kredensial pengguna dalam contoh ini, jalankan perintah berikut dan gunakan jalur ke file JSON kredensial yang didownload pada Langkah 1:
gcloud auth application-default login \
--scopes=https://www.googleapis.com/auth/analytics.readonly \
--client-id-file=[PATH/TO/credentials.json]
Dialog izin pengguna OAuth akan terbuka di jendela browser baru.
Mengirim permintaan
Gunakan curl
dan konten isi dari request.json untuk mengirim permintaan ke Google Analytics Data API. Masukkan baris berikut pada command line Anda:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
https://analyticsdata.googleapis.com/v1beta/properties/$GA4_PROPERTY_ID:runReport -d @request.json
Perintah curl
menggunakan perintah gcloud auth application-default print-access-token
untuk mendapatkan token autentikasi.
Perhatikan bahwa untuk meneruskan nama file ke curl, gunakan opsi -d
(untuk "data") dan
awali nama file dengan tanda @. File ini harus berada di direktori yang sama dengan
tempat Anda menjalankan perintah curl.
Selamat! Anda telah mengirimkan permintaan pertama ke Google Analytics Data API.