Kasus Penggunaan Tambahan

Persyaratan

GTAF MUNGKIN 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 SHALL akan 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 Konflik 409 yang menunjukkan bahwa planId tidak kompatibel dengan paket data pengguna.

Jika tidak, DPA SHALL akan 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 tersebut menyertakan planId, respons hanya menyertakan paket tersebut. Jika tidak, daftar tersebut mencakup semua paket yang dapat dibeli oleh pengguna. Jika planId kosong dan DPA tidak mendukung pemberian daftar paket yang memenuhi syarat, DPA harus menampilkan error 400 BAD REQUEST.

Pengalaman 5G Android

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

API Pull

Perangkat dapat menarik informasi status berbayar melalui GTAF menggunakan kode berikut:

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

Perhatikan bahwa DPA (Agen Paket Data) merepresentasikan server GW atau Entitlement API di jaringan operator.

userKey adalah token autentikasi yang dibentuk selama fase autentikasi awal, seperti yang dijelaskan di sini.

client_id-nya adalah AndroidSystemInfo

Status Pengukuran disediakan sebagai ENUM

DPA akan menampilkan 200 respons OK dan mencakup planInfoPerClient Penanganan error untuk DPA didefinisikan di sini

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

Push API

Operator juga dapat mendorong informasi berbayar menggunakan berikut berdasarkan peristiwa pemicu, misalnya perubahan paket harga, dll.

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

DPA harus menyertakan planInfoPerClient dalam isi pesan. Respons error dari GTAF didefinisikan di sini

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