סקירה כללית
בנוסף, Google Mobile Data Plan Sharing API מאפשרת למפעיל לשלוח התראות למשתמש באמצעות שליחת PlanStatus.
ה-API תומך כרגע בהתראות הבאות:
- יתרה נמוכה: כש-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 מאוכלס בסכום שהמשתמש הוציא. אם השדה accountBalance מאוכלס, ההתראה מציגה את היתרה שנותרה בחשבון.
- טעינת יתרה בחשבון: כששדות AccountInfo.accountTopUp ו-AccountInfo.accountBalance מלאים. כדי לשלוח למשתמש את ההתראה על טעינת יתרה בחשבון, צריך למלא את שני השדות האלה. אם הערכים של יחידות וננו ב-AccountInfo.accountTopUp מוגדרים לאפס, סכום הטעינה לא נכלל בהתראה.
- תוקף הנתונים: כש-PlanModule.planModuleState מוגדר ל-EXPIRED. האפשרות הזו מיועדת לתוכניות שכבר פג תוקפן.
התראה אחת נשלחת למשתמש על כל קבוצת שדות. אם כמה שדות coarseBalanceLevel או planModuleState מוגדרים ב-PlanStatus אחד, יישלח למשתמש מספר שווה של התראות.
סטטוס התוכנית שמפעיל את ההתראה נשלח למכשיר של המשתמש כדי לעדכן את המטמון במכשיר. כך משפרים את חוויית המשתמש כי כשמשתמש לוחץ על ההתראה, מוצג לו סטטוס עדכני של התוכנית. אם סטטוס התוכנית שמשמש לשליחת התראה לא הושלם ולא צריך להציג אותו למשתמש, הספק חייב להגדיר את UiCompatibility לערך UI_INCOMPATIBLE.
דרישות
ההתראה PlanStatus צריכה להכיל כמה שיותר מידע על התוכנית הסלולרית של המשתמש. בנוסף, לכל סוג של התראה מוגדר ב-Data Plan Sharing API גם סט מינימלי של שדות שנדרשים כדי ליצור את טקסט ההתראה. המפעיל חייב לכלול את השדות האלה בהתראה PlanStatus.
| התראה | שדות חובה |
|---|---|
| יתרה נמוכה | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| אין נתונים | PlanModule.moduleName |
| אזהרה לגבי תפוגת נתונים | PlanModule.moduleName, PlanModule.expirationTime |
| הפעלת התוכנית | PlanModule.moduleName |
| שלם תוך כדי | AccountInfo.payAsYouGoCharge |
| הוספת כסף לחשבון | AccountInfo.accountTopUp |
| תפוגת נתונים | PlanModule.moduleName |