खास जानकारी
Google मोबाइल डेटा प्लान शेयर करने वाले एपीआई का इस्तेमाल करके ऑपरेटर, प्लान की स्थिति पुश करके, उपयोगकर्ता को सूचनाएं भेज सकता है.
एपीआई फ़िलहाल इन सूचनाओं के साथ काम करता है:
- कम बैलेंस: जब PlanModule.coarse BalanceLevel LOW_Dropbox पर सेट होता है
- डेटा खत्म हो गया है: जब PlanModule.coarse BalanceLevel OUT_OF_DATA पर सेट हो. अगर इसके अलावा, PlanModule.overUsagePolicy PAY_AS_you_GO पर सेट है, तो उपयोगकर्ता को सूचना दी जाएगी कि वह आपके 'इस्तेमाल के मुताबिक पैसे चुकाने वाले मोड' में जाने वाला है.
- डेटा खत्म होने की चेतावनी: जब PlanModule.planModuleState, expIRING_SOON पर सेट होता है
- प्लान ऐक्टिवेशन: जब PlanModule.planModuleState, NEWLY_ACTIVE पर सेट हो
- इस्तेमाल के मुताबिक पैसे चुकाएं: जब AccountInfo.payAsYouGoCharge को, उपयोगकर्ता के खर्च की गई रकम से भरा जाता है. अगर खाते का बैलेंस भर जाता है, तो सूचना में खाते का बचा हुआ बैलेंस दिखता है.
- खाता टॉप अप करें: जब AccountInfo.accountTopUp और AccountInfo.account Balance का नाम भर जाता है. उपयोगकर्ता को खाता टॉप अप करने की सूचना भेजने के लिए, ये दोनों फ़ील्ड ज़रूरी हैं. अगर AccountInfo.accountTopUp में यूनिट और नैनो सेट हैं, तो सूचना में टॉप अप की रकम शामिल नहीं की गई है.
- डेटा खत्म होने की तारीख: जब PlanModule.planModuleState, EXPIRED पर सेट होता है. यह उन प्लान के लिए है जिनकी समयसीमा पहले ही खत्म हो चुकी है.
उपयोगकर्ता को हर फ़ील्ड सेट के लिए एक सूचना भेजी जाती है. अगर एक ही PlanStatus में
coarseBalanceLevel या planModuleState फ़ील्ड सेट हैं, तो उपयोगकर्ता को उतनी ही सूचनाएं भेजी जाएंगी.
उपयोगकर्ता के डिवाइस पर सूचना ट्रिगर करने वाले प्लान की स्थिति,
डिवाइस की कैश मेमोरी अपडेट करने के लिए भेजी जाती है. जब उपयोगकर्ता सूचना पर क्लिक करता है, तो हाल की प्लान की स्थिति दिखाकर, यह उपयोगकर्ता अनुभव को बेहतर बनाता है. अगर सूचना भेजने के लिए इस्तेमाल किए गए प्लान की स्थिति
पूरी नहीं है और उसे उपयोगकर्ता को नहीं दिखाया जाना चाहिए, तो मोबाइल और इंटरनेट सेवा देने वाली कंपनी को
Uiability
UI_INCOMPATIBLE
सेट करना होगा.
ज़रूरी शर्तें
सूचना PlanStatus में, उपयोगकर्ता के मोबाइल प्लान से जुड़ी ज़्यादा से ज़्यादा जानकारी शामिल होनी चाहिए. हर तरह की सूचना के लिए, डेटा प्लान शेयर करने वाला एपीआई उन फ़ील्ड का कम से कम सेट भी तय करता है जिनकी ज़रूरत सूचना टेक्स्ट को बनाने के लिए होती है. ऑपरेटर को ये फ़ील्ड, नोटिफ़िकेशन के स्टेटस में शामिल करने होंगे.
| सूचना | ज़रूरी फ़ील्ड |
|---|---|
| बैलेंस कम है | PlanModule.moduleName, PlanModule.बाइट बैलेंस.remainingBytes |
| डेटा खत्म हो गया है | PlanModule.moduleName |
| डेटा खत्म होने की चेतावनी | PlanModule.moduleName, PlanModule.expirationTime |
| प्लान चालू करना | PlanModule.moduleName |
| जितना इस्तेमाल करें, सिर्फ़ उतने पैसे चुकाएं | AccountInfo.payAsYouGoCharge |
| खाता टॉप अप करें | खाता जानकारी.खाताटॉप अप |
| डेटा खत्म होने की तारीख | PlanModule.moduleName |