Panduan Memulai API menggunakan command line

Halaman ini menunjukkan cara memulai Google Analytics Data API v1 menggunakan perintah garis.

Langkah 1. Mengaktifkan API

Klik tombol berikut untuk membuat project Google Cloud baru, secara otomatis mengaktifkan Google Analytics Data API v1 dan membuat kredensial OAuth2 yang diperlukan untuk tutorial:

Mengaktifkan Google Analytics Data API v1

Anda akan otomatis dialihkan ke konfigurasi kredensial OAuth2 dialog. Saat dialog menanyakan Dari mana Anda menelepon?, pilih Desktop.

Dalam dialog yang muncul, klik DOWNLOAD KONFIGURASI KLIEN, lalu simpan file. credentials.json ke direktori kerja Anda.

Atau, Anda dapat mengikuti langkah-langkah ini untuk membuat OAuth2 Kredensial dalam proyek secara manual.

Langkah 2. Menginstal dan menginisialisasi Cloud SDK

Anda memerlukan command line gcloud yang diinstal pada mesin pengembangan Anda.

Langkah 3: Lakukan panggilan API

Sekarang Anda dapat menggunakan Google Analytics Data API untuk mengkueri saat ini.

Pilih Entitas Pelaporan

Dalam tutorial ini, kita akan menggunakan variabel lingkungan GA_PROPERTY_ID untuk menyimpan ID properti yang akan digunakan dalam permintaan API.

Masukkan perintah berikut di command line untuk menetapkan variabel GA_PROPERTY_ID:

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

Ganti [YOUR_GA_PROPERTY_ID] dengan properti Google Analytics Anda ID. Contoh:

export GA_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 di 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.

Kirim permintaan

Gunakan curl dan isi isi dari request.json untuk mengirim permintaan ke Data API Google Analytics. Masukkan perintah 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/$GA_PROPERTY_ID:runReport -d @request.json

Perintah curl menggunakan gcloud auth application-default print-access-token untuk mendapatkan token otentikasi.

Perhatikan bahwa untuk meneruskan nama file ke curl, Anda menggunakan opsi -d (untuk "data") dan awali nama {i>file<i} dengan tanda @. File ini harus berada di direktori yang sama di mana Anda menjalankan perintah curl.