Kasus Penggunaan Tambahan

Kelayakan

GTAF DAPAT mengeluarkan permintaan kelayakan berikut untuk memeriksa apakah pengguna memenuhi syarat untuk membeli paket.

GET DPA/{userKey}/Eligibility/{planId}?key_type={CPID,MSISDN}

Perhatikan bahwa planId adalah ID unik untuk paket yang dapat digunakan untuk membeli paket atas nama pengguna (Lihat Pembelian Data). Jika planId tidak ditentukan, DPA HARUS menampilkan semua paket yang dapat dibeli oleh pengguna tersebut.

Kasus error mencantumkan respons yang diharapkan dari DPA jika terjadi error. Selain itu, DPA HARUS menampilkan error dalam kasus error berikut:

• DPA menampilkan kode error 400 BAD REQUEST yang menunjukkan kepada GTAF bahwa planId tidak valid.
• DPA menampilkan kode error 409 CONFLICT yang menunjukkan bahwa planId tidak kompatibel dengan paket data pengguna.

Jika tidak, DPA HARUS menampilkan respons 200-OK. Format EligibilityResponse yang berhasil adalah:

{
  "eligiblePlans":
  [
   {
    "planId": string,   // Plan identifier. Can be used to
                        // refer to the plan during
                        // offers, etc. (req.)
   }
  ]
}

Jika permintaan menyertakan planId, respons hanya menyertakan paket tersebut. Jika tidak, daftar akan menyertakan semua paket yang dapat dibeli pengguna. Jika planId kosong dan DPA tidak mendukung penampilan daftar paket yang memenuhi syarat, DPA HARUS menampilkan error 400 BAD REQUEST.

Pengalaman 5G Android

GTAF memungkinkan operator membagikan status penggunaan terukur per jenis koneksi untuk pelanggan. Informasi dapat ditarik secara berkala oleh GTAF atau operator dapat mengirimkan informasi berdasarkan pemicu internal.

Pull API

Perangkat dapat menarik informasi penggunaan data melalui GTAF menggunakan cara berikut:

GET DPA/{userKey}/planStatus?key_type={userKey}&client_id=AndroidSystemInfo

Perhatikan bahwa DPA (Data Plan Agent) mewakili server GW atau Hak dalam jaringan operator.

userKey adalah token autentikasi yang dibuat selama fase autentikasi awal seperti yang ditentukan di sini.

client_id adalah AndroidSystemInfo

Status Koneksi berbayar diberikan sebagai ENUM

DPA akan menampilkan respons 200 OK dan menyertakan planInfoPerClient Penanganan error untuk DPA ditentukan di sini

Dalam model pull, GTAF bertindak sebagai klien dan memvalidasi sertifikat SSL DPA. GTAF mengautentikasi dirinya ke DPA menggunakan prosedur OAuth yang ditentukan di sini.

Push API

Operator juga dapat mengirimkan informasi penggunaan terukur menggunakan berikut berdasarkan peristiwa pemicu, misalnya perubahan paket harga, dll.

POST https://mobiledataplansharing.googleapis.com/v1/operators/12345/clients/AndroidSystemInfo/users/abcdef/planStatus

DPA akan menyertakan planInfoPerClient dalam isi pesan. Respons error dari GTAF ditentukan di sini

Dalam mode push, GTAF mengautentikasi permintaan masuk dari DPA menggunakan server OAuth2 Google Cloud. Permintaan masuk harus diautentikasi sebagai akun layanan yang telah dimasukkan dalam daftar yang diizinkan di ISP Portal untuk ASN yang diwakili oleh DPA. Selain itu, lihat panduan integrasi di sini untuk mengetahui detail selengkapnya.