Ringkasan
Google Mobile Data Plan Sharing API juga memungkinkan operator mengirim notifikasi kepada pengguna dengan mengirimkan PlanStatus.
API saat ini mendukung notifikasi berikut:
- Saldo Rendah: saat PlanModule.coarseBalanceLevel disetel ke LOW_QUOTA
- Kehabisan Data: saat PlanModule.coarseBalanceLevel disetel ke OUT_OF_DATA. Jika selain itu, PlanModule.overUsagePolicy disetel ke PAY_AS_YOU_GO, pengguna akan diberi tahu bahwa mereka akan memasuki mode bayar sesuai penggunaan.
- Peringatan Masa Berlaku Data: saat PlanModule.planModuleState disetel ke EXPIRING_SOON
- Aktivasi Paket: saat PlanModule.planModuleState disetel ke NEWLY_ACTIVE
- Bayar sesuai penggunaan: saat AccountInfo.payAsYouGoCharge diisi dengan jumlah yang telah dibelanjakan pengguna. Jika accountBalance diisi, notifikasi akan menampilkan sisa saldo di akun.
- Isi ulang saldo akun: saat AccountInfo.accountTopUp dan AccountInfo.accountBalance diisi. Kedua kolom ini diperlukan untuk mengirimkan notifikasi pengisian saldo akun kepada pengguna. Jika unit dan nano di AccountInfo.accountTopUp, disetel ke nol, jumlah isi ulang tidak akan disertakan dalam notifikasi.
- Masa Berlaku Data: saat PlanModule.planModuleState disetel ke EXPIRED. Opsi ini untuk paket yang sudah habis masa berlakunya.
Satu notifikasi dikirim ke pengguna untuk setiap set kolom. Jika beberapa kolom
coarseBalanceLevel atau planModuleState ditetapkan dalam satu
PlanStatus, maka jumlah notifikasi yang sama akan dikirim kepada pengguna.
Status paket yang memicu notifikasi dikirim ke perangkat pengguna untuk memperbarui
cache di perangkat. Hal ini meningkatkan pengalaman pengguna dengan menampilkan status paket terbaru saat pengguna mengklik notifikasi. Jika status paket yang digunakan untuk
mengirim notifikasi belum selesai dan tidak boleh ditampilkan kepada pengguna, maka
operator HARUS menyetel
UiCompatibility
ke UI_INCOMPATIBLE.
Persyaratan
Notifikasi PlanStatus HARUS berisi sebanyak mungkin informasi tentang paket seluler pengguna. Untuk setiap jenis notifikasi, Data Plan Sharing API juga menentukan kumpulan minimum kolom yang diperlukan untuk membuat teks notifikasi. Operator HARUS menyertakan kolom ini dalam PlanStatus notifikasi.
| Notifikasi | Kolom Wajib Diisi |
|---|---|
| Saldo Rendah | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Kehabisan Data | PlanModule.moduleName |
| Peringatan Masa Berlaku Data | PlanModule.moduleName, PlanModule.expirationTime |
| Aktivasi Paket | PlanModule.moduleName |
| Bayar sesuai penggunaan | AccountInfo.payAsYouGoCharge |
| Isi ulang akun | AccountInfo.accountTopUp |
| Masa Berlaku Data | PlanModule.moduleName |