Genel Bakış
Google Mobil Veri Planı Paylaşımı API'si, operatörlerin PlanStatus göndererek kullanıcılara bildirim göndermesine de olanak tanır.
API şu anda aşağıdaki bildirimleri desteklemektedir:
- Düşük bakiye: PlanModule.coarseBalanceLevel, LOW_QUOTA olarak ayarlandığında
- Veri Yok: PlanModule.coarseBalanceLevel, OUT_OF_DATA olarak ayarlandığında. Buna ek olarak PlanModule.overUsagePolicy PAY_AS_YOU_GO olarak ayarlanırsa kullanıcı, kullandıkça öde moduna girmek üzere olduğu konusunda bilgilendirilir.
- Verilerin Geçerlilik Bitiş Tarihiyle İlgili Uyarı: PlanModule.planModuleState, EXPIRING_SOON olarak ayarlandığında
- Plan Etkinleştirme: PlanModule.planModuleState, NEWLY_ACTIVE olarak ayarlandığında
- Kullandıkça öde: AccountInfo.payAsYouGoCharge, kullanıcının harcadığı tutarla doldurulduğunda. accountBalance alanı doldurulursa bildirimde hesaptaki kalan bakiye gösterilir.
- Hesaba para yükleme: AccountInfo.accountTopUp ve AccountInfo.accountBalance alanları doldurulduğunda. Hesaba para yükleme bildiriminin kullanıcıya gönderilmesi için bu alanların her ikisi de gereklidir. AccountInfo.accountTopUp içindeki birimler ve nano birimler sıfır olarak ayarlanırsa yükleme tutarı bildirime dahil edilmez.
- Verilerin Geçerlilik Süresi: PlanModule.planModuleState EXPIRED olarak ayarlandığında. Bu seçenek, süresi dolmuş planlar için geçerlidir.
Her alan kümesi için kullanıcıya bir bildirim gönderilir. Tek bir PlanStatus içinde birden fazla coarseBalanceLevel veya planModuleState alanı ayarlanırsa kullanıcıya eşit sayıda bildirim gönderilir.
Bildirimi tetikleyen plan durumu, cihazdaki önbelleği güncellemek için kullanıcı cihazına gönderilir. Bu özellik, kullanıcı bildirimi tıkladığında son plan durumunu göstererek kullanıcı deneyimini iyileştirir. Bildirim göndermek için kullanılan plan durumu tamamlanmamışsa ve kullanıcıya gösterilmemesi gerekiyorsa operatör, UiCompatibility'yi UI_INCOMPATIBLE olarak ayarlamalıdır.
Şartlar
Bir bildirim PlanStatus, kullanıcının mobil planı hakkında mümkün olduğunca fazla bilgi içermelidir. Veri Planı Paylaşımı API'si, her bildirim türü için bildirim metnini oluşturmak üzere gereken minimum alan kümesini de tanımlar. Operatör, PlanStatus bildirimine bu alanları EKLEMELİDİR.
| Bildirim | Zorunlu Alanlar |
|---|---|
| Düşük bakiye | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Veri Kalmadı | PlanModule.moduleName |
| Verilerin Geçerlilik Süresinin Sona Ermesiyle İlgili Uyarı | PlanModule.moduleName, PlanModule.expirationTime |
| Plan Etkinleştirme | PlanModule.moduleName |
| Kullandıkça ödeme | AccountInfo.payAsYouGoCharge |
| Hesaba para ekleme | AccountInfo.accountTopUp |
| Verilerin Geçerlilik Süresi | PlanModule.moduleName |