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