Panduan Memulai API menggunakan command line

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 v1

Anda 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.