Panduan Integrasi

Mendapatkan Kunci Pribadi

Menggunakan Antarmuka Aktivasi

Untuk berintegrasi dengan API, Anda harus membuat Project Google Cloud. Setelah itu, buat akun layanan dan dapatkan kunci pribadi. Untuk memulai, klik tombol berikut:

Buat Akun Layanan

Membuat Kunci Secara Manual

Jika antarmuka di atas gagal, coba langkah berikut:

  1. Buka Konsol Google Cloud.
  2. Pilih project yang akan digunakan untuk mengakses API.
  3. Di menu IAM & admin di sebelah kiri, temukan akun layanan dan buat Akun Layanan baru yang akan menjadi pemilik project.
  4. Setelah akun layanan dibuat, Anda akan menerima kunci pribadi.

Akun Layanan yang Disetujui

Setelah Anda membuat akun layanan:

  1. Hubungi tim GTAF di mdp-support@google.com dengan Akun Google yang merupakan pemilik project. Kami akan memasukkan Akun Google ke dalam daftar yang diizinkan untuk mengakses endpoint Mobile Data Plan Sharing API.
  2. Mengaitkan akun layanan dengan operator di Portal ISP Google. Operator dapat membuat hubungan ini dengan membuka Akses API.

Mengaktifkan Koleksi

Setelah pemberian izin selesai:

  1. Buka Konsol Google Cloud.
  2. Pastikan Anda telah memilih project yang benar di dropdown pada panel menu atas.
  3. Aktifkan Mobile Data Plan Sharing API di API Library.
  4. Aktifkan Preprod Mobile Data Plan Sharing API di API Library.

Menguji Akses API

Untuk menguji akses Anda ke metode sisi Google:

  1. Instal oauth2l.

  2. Dapatkan token akses untuk akun layanan Anda sebagai berikut. your-service-account-key-file.json adalah file kunci akun layanan Anda.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    Perhatikan bahwa masa berlaku token akses akan berakhir dalam waktu sekitar satu jam. Sebelum Anda menjalankan perintah di atas lagi untuk token akses baru, jalankan oauth2l reset untuk menghapus cache lokal.

  3. Lakukan panggilan pengujian masalah sebagai berikut. YOUR-ASN harus menjadi salah satu ASN yang Anda kirimkan kepada kami saat kami mengonfigurasi GTAF selama proses integrasi. ACCESS-TOKEN-OBTAINED adalah output dari perintah oauth2l fetch di atas. PLAN_STATUS adalah isi permintaan PlanStatus yang ingin Anda kirim ke GTAF.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

Panggilan API terprogram

Ikuti petunjuk untuk melakukan panggilan yang diizinkan ke metode sisi Google, dengan cakupan OAuth berikut:

https://www.googleapis.com/auth/dataplansharing

Membagikan Kepemilikan Project

Meskipun penyiapan awal melibatkan satu Akun Google, sebaiknya sekelompok pengguna yang diberi otorisasi memiliki kepemilikan project. Di Konsol Google Cloud, di menu IAM & admin, Anda dapat menambahkan anggota baru (termasuk akun grup Google) untuk menjadi pemilik project.