סקירה כללית
בנוסף, Google Mobile Data Plan Sharing API מאפשרת למפעיל לשלוח התראות למשתמש באמצעות שליחת PlanStatus.
בשלב הזה ה-API תומך ב-7 סוגים של התראות.
- יתרה נמוכה: כש-PlanModule.coarseBalanceLevel מוגדר ל-LOW_QUOTA
- Out of Data: כש-PlanModule.coarseBalanceLevel מוגדר ל-OUT_OF_DATA. אם בנוסף לכך, הערך של PlanModule.overUsagePolicy מוגדר כ-PAY_AS_YOU_GO, המשתמש יקבל הודעה שהוא עומד להיכנס למצב של תשלום לפי שימוש.
- Data Expiration Warning: when PlanModule.planModuleState is set to EXPIRING_SOON
- Plan Activation: when PlanModule.planModuleState is set to NEWLY_ACTIVE
- תשלום לפי שימוש: כששדה AccountInfo.payAsYouGoCharge מאוכלס בסכום שהמשתמש הוציא.
- Account top up: when AccountInfo.accountTopUp and AccountInfo.accountBalance are populated. כדי לשלוח למשתמש את ההתראה על טעינת יתרה בחשבון, צריך למלא את שני השדות האלה. אם הערכים של יחידות וננו ב-AccountInfo.accountTopUp מוגדרים לאפס, סכום הטעינה לא יופיע בהתראה.
- תוקף הנתונים: כש-PlanModule.planModuleState מוגדר ל-EXPIRED. האפשרות הזו מיועדת לתוכניות שכבר פג תוקפן.
התראה אחת נשלחת למשתמש על כל קבוצת שדות. אם כמה שדות coarseBalanceLevel או planModuleState מוגדרים ב-PlanStatus אחד, יישלח למשתמש מספר שווה של התראות.
דרישות
ההתראה PlanStatus צריכה להכיל כמה שיותר מידע על התוכנית הסלולרית של המשתמש. בנוסף, לכל סוג של התראה מוגדר ב-Data Plan Sharing API גם סט מינימלי של שדות שנדרשים כדי ליצור את טקסט ההתראה. המפעיל חייב לכלול את השדות האלה בהתראה PlanStatus.
| התראה | שדות חובה |
|---|---|
| יתרה נמוכה | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| אין נתונים | PlanModule.moduleName |
| אזהרה לגבי תפוגת נתונים | PlanModule.moduleName, PlanModule.expirationTime |
| הפעלת התוכנית | PlanModule.moduleName |
| תפוגת נתונים | PlanModule.moduleName |