סקירה כללית
בנוסף, ה-API של שיתוף הנתונים לנייד של Google מאפשר למפעיל לשלוח התראות למשתמש על ידי דחיפה של PlanStatus.
בשלב זה, ה-API תומך בהתראות הבאות:
- יתרה נמוכה: כאשר PlanModule.coarse BalanceLevel מוגדר ל- LOW_QUOTA
- מחוץ לנתונים: כאשרPlanModule.coarseBalanceLevel מוגדר כ-OUT_OF_DATA. אם הוא מתווסף, הערך ב-PlanModule.overUsagePolicy מוגדר ל-PAY_AS_YOU_GO, ולאחר מכן המשתמש יקבל הודעה על כך שהוא עומד להיכנס למצב תשלום בעת השימוש.
- אזהרה לגבי פקיעת תוקף הנתונים: כאשר PlanModule.planModuleState מוגדר לערך EXPIRING_SOON
- הפעלת תוכנית: כאשר PlanModule.planModuleState מוגדר כ- NEWLY_ACTIVE
- תשלום לפי שימוש: AccountInfo.payAsYouGoCharge מאוכלס בסכום שהמשתמש הוציא. אם השדה יתרה ביתרה מאוכלס, ההתראה תציג את היתרה שנותרה בחשבון.
- הארכת החשבון: כאשר מאוכלסים AccountInfo.accountTopUp ו-AccountInfo.accountיתרה. שני השדות האלה נדרשים לשלוח את ההודעה להוספת החשבון למשתמש. אם יחידות ו-nanos ב-AccountInfo.accountTopUp, מוגדרים לערך 0, הסכום להוספת כסף לא ייכלל בהתראה.
- התוקף של נתונים: כאשר PlanModule.planModuleState מוגדר לערך EXPIRED. הכוונה היא לתוכניות שכבר פגו.
הודעה אחת נשלחת למשתמש עבור כל קבוצת שדות. אם מוגדרים כמה שדות coarseBalanceLevel או planModuleState בשורה אחת PlanStatus, מספר זהה של הודעות יישלח למשתמש.
סטטוס התוכנית שמפעיל את ההתראה נשלח למכשיר המשתמש כדי לעדכן את המטמון של המכשיר. כדי לשפר את חוויית המשתמש, המערכת מציגה את הסטטוס של התוכנית האחרונה כשמשתמש לוחץ על ההודעה. אם סטטוס התוכנית המשמש לשליחת התראה אינו מלא ואין להציג אותו למשתמש, הספק חייב להגדיר את Uibility כ-UI_INCOMPATIBLE.
דרישות
הודעה בנושא PlanStatus צריכה לכלול כמה שיותר מידע על חבילת הגלישה של המשתמש. לכל סוג של התראה, ה-API של שיתוף הנתונים מגדיר גם קבוצה מינימלית של שדות שנדרשים כדי ליצור את הטקסט של ההתראות. האופרטור חייב לכלול את השדות האלה בסטטוס Plan Status של התראה.
| התראה | שדות חובה |
|---|---|
| יתרה נמוכה | PlanModule.moduleName, PlanModule.בייטBalance.remainingBytes |
| אין נתונים | PlanModule.moduleName |
| אזהרה לגבי פקיעת תוקף של נתונים | PlanModule.moduleName, PlanModule.expirationTime |
| הפעלת התוכנית | PlanModule.moduleName |
| תשלום לפי שימוש | AccountInfo.payAsYouGoCharge |
| הוספת חשבונות לחשבון | AccountInfo.accountTopUp |
| תפוגה של נתונים | PlanModule.moduleName |