खास जानकारी
Google Mobile Data Plan Sharing API की मदद से, ऑपरेटर किसी उपयोगकर्ता को सूचनाएं भी भेज सकता है. इसके लिए, उसे PlanStatus को पुश करना होगा.
फ़िलहाल, एपीआई इन सूचनाओं के साथ काम करता है:
- बैलेंस कम है: जब PlanModule.coarseBalanceLevel को LOW_QUOTA पर सेट किया जाता है
- डेटा खत्म हो गया है: जब PlanModule.coarseBalanceLevel को OUT_OF_DATA पर सेट किया जाता है. अगर इसके अलावा, PlanModule.overUsagePolicy को PAY_AS_YOU_GO पर सेट किया जाता है, तो उपयोगकर्ता को सूचना दी जाएगी कि वह पे ऐज़ यू गो मोड में जाने वाला है.
- डेटा खत्म होने की चेतावनी: जब PlanModule.planModuleState को EXPIRING_SOON पर सेट किया जाता है
- प्लान चालू करना: जब PlanModule.planModuleState को NEWLY_ACTIVE पर सेट किया जाता है
- इस्तेमाल के हिसाब से शुल्क चुकाने की सुविधा: जब AccountInfo.payAsYouGoCharge फ़ील्ड में, उपयोगकर्ता के खर्च की रकम भरी जाती है. अगर accountBalance फ़ील्ड में वैल्यू मौजूद है, तो सूचना में खाते में बचा हुआ बैलेंस दिखता है.
- खाते में टॉप अप किया गया: जब AccountInfo.accountTopUp और AccountInfo.accountBalance फ़ील्ड में वैल्यू मौजूद होती है. उपयोगकर्ता को खाते में टॉप अप करने की सूचना भेजने के लिए, इन दोनों फ़ील्ड की ज़रूरत होती है. अगर AccountInfo.accountTopUp में यूनिट और नैनो को शून्य पर सेट किया जाता है, तो सूचना में टॉप अप की रकम शामिल नहीं की जाती है.
- डेटा खत्म होने की तारीख: जब PlanModule.planModuleState को EXPIRED पर सेट किया जाता है. यह उन प्लान के लिए है जिनकी समयसीमा पहले ही खत्म हो चुकी है.
उपयोगकर्ता को हर फ़ील्ड सेट के लिए एक सूचना भेजी जाती है. अगर एक PlanStatus में कई coarseBalanceLevel या planModuleState फ़ील्ड सेट किए जाते हैं, तो उपयोगकर्ता को उतनी ही सूचनाएं भेजी जाएंगी.
सूचना ट्रिगर करने वाले प्लान की स्थिति को उपयोगकर्ता के डिवाइस पर भेजा जाता है, ताकि डिवाइस पर मौजूद कैश मेमोरी को अपडेट किया जा सके. इससे उपयोगकर्ता को बेहतर अनुभव मिलता है. ऐसा इसलिए, क्योंकि जब उपयोगकर्ता सूचना पर क्लिक करता है, तो उसे हाल ही के प्लान की स्थिति दिखती है. अगर सूचना भेजने के लिए इस्तेमाल किए गए प्लान का स्टेटस पूरा नहीं है और इसे उपयोगकर्ता को नहीं दिखाया जाना चाहिए, तो कैरियर को 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 |