סקירה כללית
בנוסף, ה-API של שיתוף הנתונים לנייד של Google מאפשר למפעיל לשלוח התראות למשתמש על ידי דחיפה של PlanStatus.
כרגע יש תמיכה ל-7 סוגי התראות בממשק ה-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 מוגדרים לאפס, סכום החידוש לא יופיע בהתראה.
- התוקף של נתונים: כאשר PlanModule.planModuleState מוגדר לערך EXPIRED. הכוונה היא לתוכניות שכבר פגו.
הודעה אחת נשלחת למשתמש עבור כל קבוצת שדות. אם מוגדרים כמה שדות coarseBalanceLevel או planModuleState בשורה אחת PlanStatus, מספר זהה של הודעות יישלח למשתמש.
דרישות
הודעה בנושא PlanStatus צריכה לכלול כמה שיותר מידע על חבילת הגלישה של המשתמש. לכל סוג של התראה, ה-API של שיתוף הנתונים מגדיר גם קבוצה מינימלית של שדות שנדרשים כדי ליצור את הטקסט של ההתראות. האופרטור חייב לכלול את השדות האלה בסטטוס Plan Status של התראה.
| התראה | שדות חובה |
|---|---|
| יתרה נמוכה | PlanModule.moduleName, PlanModule.בייטBalance.remainingBytes |
| אין נתונים | PlanModule.moduleName |
| אזהרה לגבי פקיעת תוקף של נתונים | PlanModule.moduleName, PlanModule.expirationTime |
| הפעלת התוכנית | PlanModule.moduleName |
| תפוגה של נתונים | PlanModule.moduleName |