Panduan Integrasi

Dapatkan Kunci Pribadi

Menggunakan Antarmuka Orientasi

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

Membuat Akun Layanan

Membuat Kunci Secara Manual

Jika antarmuka di atas gagal, coba langkah berikut ini:

  1. Buka Google Cloud Console.
  2. Pilih project tempat API akan diakses.
  3. Pada menu admin &IAM di sebelah kiri, cari akun layanan dan buat Akun Layanan baru yang akan menjadi pemilik project.
  4. Setelah akun layanan dibuat, Anda akan menerima kunci pribadi.

Izinkan Akun Layanan

Setelah membuat akun layanan:

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

Aktifkan Koleksi

Setelah pemberian izin selesai dilakukan:

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

Akses API Uji

Untuk menguji akses Anda ke metode samping 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 menjalankan kembali perintah di atas untuk token akses baru, jalankan oauth2l reset untuk menghapus cache lokal.

  3. Lakukan panggilan uji coba sebagai berikut. YOUR-ASN harus merupakan salah satu ASN yang Anda kirim 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 sah ke metode samping Google, dengan cakupan OAuth berikut:

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

Berbagi Kepemilikan Project

Meskipun penyiapan awal melibatkan satu Akun Google, sebaiknya buat grup pengguna yang diotorisasi untuk memiliki kepemilikan project. Di Google Cloud Console, pada menu admin &IAM, Anda dapat menambahkan anggota baru (termasuk akun grup Google) untuk menjadi pemilik project.