इस्तेमाल के दूसरे उदाहरण

लाइव रीडायरेक्ट की सुविधा से जुड़ी ज़रूरी शर्तें

GTAF को यह अनुरोध करने के लिए, इन ज़रूरी शर्तों को जारी करना पड़ सकता है कि उपयोगकर्ता प्लान खरीदने के लिए ज़रूरी शर्तें पूरी करता है या नहीं.

GET DPA/{userKey}/Eligibility/{planId}?key_type={CPID,MSISDN}

ध्यान रखें कि planId उस प्लान का यूनीक आइडेंटिफ़ायर होता है जिसका इस्तेमाल उपयोगकर्ता की ओर से प्लान खरीदने के लिए किया जा सकता है. डेटा खरीदारी देखें. अगर planId के बारे में नहीं बताया गया है, तो डीपीए को उस उपयोगकर्ता से खरीदे जा सकने वाले सभी प्लान वापस करने होंगे.

गड़बड़ी के मामले में, किसी गड़बड़ी के मामले में डीपीए से अपेक्षित जवाब की सूची दिखाई जाती है. साथ ही, डीपीए को गड़बड़ी के इन मामलों में गड़बड़ी दिखेगी:

• बाद में, डीपीए ने GTAF के लिए, 400 BID अनुरोध अनुरोध कोड दिखाया. इसमें बताया गया था कि planId अमान्य है.
• डीपीए ने 409 गड़बड़ी का गड़बड़ी कोड दिखाया. इससे यह पता चलता है कि planId, उपयोगकर्ता के डेटा प्लान के साथ काम नहीं करता है.

ऐसा न करने पर, डीपीए 200-ठीक जवाब दिखाएगा. एक सफल ज़रूरी रिस्पॉन्स का फ़ॉर्मैट है:

{
  "eligiblePlans":
  [
   {
    "planId": string,   // Plan identifier. Can be used to
                        // refer to the plan during
                        // offers, etc. (req.)
   }
  ]
}

जब अनुरोध में planId शामिल होता है, तो जवाब में सिर्फ़ वही प्लान शामिल होता है. अगर आप ऐसा नहीं करते हैं, तो इस सूची में वे सभी प्लान शामिल होते हैं जिन्हें उपयोगकर्ता खरीद सकता है. अगर planId खाली है और डीपीए के पास मंज़ूरी वाले प्लान की सूची नहीं है, तो 400 'अनुरोध के लिए गड़बड़ी' का मैसेज दिखना ज़रूरी है.

Android 5G वर्शन

GTAF, मोबाइल और इंटरनेट सेवा देने वाली कंपनियों को सदस्यों की संख्या के हिसाब से मीटरिंग का स्टेटस शेयर करने की सुविधा देता है. GTAF या मोबाइल और इंटरनेट सेवा देने वाली कंपनियां, समय-समय पर इस जानकारी को ट्रिगर कर सकती हैं.

पुल एपीआई

डिवाइस, GTAF के ज़रिए इस जानकारी को इकट्ठा कर सकता है:

GET DPA/{userKey}/planStatus?key_type={userKey}&client_id=AndroidSystemInfo

ध्यान दें कि डीपीए (डेटा प्लान एजेंट), मोबाइल और इंटरनेट सेवा देने वाली कंपनी के नेटवर्क में एपीआई GW या एनटाइटलमेंट सर्वर को दिखाता है.

userKey, पुष्टि करने का शुरुआती टोकन होता है. इसे शुरुआती चरण के दौरान बनाया गया है, जैसा कि यहां बताया गया है.

client_id AndroidSystemInfo है

रखरखाव की स्थिति ENUM के तौर पर दी गई है

डीपीए 200 OK जवाब दिखाएगा और planInfoPerClient शामिल करेगा. डीपीए के लिए गड़बड़ी को हैंडल करने के बारे में यहां बताया गया है

पुल मॉडल में GTAF, क्लाइंट के तौर पर काम करता है और डीपीए के एसएसएल सर्टिफ़िकेट की पुष्टि करता है. GTAF, यहां दी गई OAuth प्रोसेस का इस्तेमाल करके, डीपीए की पुष्टि करता है.

पुश एपीआई

मोबाइल और इंटरनेट सेवा देने वाली कंपनी, ट्रिगर इवेंट के आधार पर नीचे दी गई जानकारी का इस्तेमाल करके, सीमित जानकारी को भी पुश कर सकती है. जैसे, कीमत में बदलाव वगैरह.

POST https://mobiledataplansharing.googleapis.com/v1/operators/12345/clients/AndroidSystemInfo/users/abcdef/planStatus

डीपीए को मैसेज के मुख्य हिस्से में, planInfoPerClient शामिल करना होगा. GTAF के गड़बड़ी वाले जवाबों के बारे में यहां बताया गया है

पुश मोड में, GTAF, Google Cloud OAuth2 सर्वर का इस्तेमाल करके, डीपीए से आने वाले अनुरोधों की पुष्टि करता है. आने वाले अनुरोधों की पुष्टि उस सेवा खाते के तौर पर की जानी चाहिए जिसे डीएसपी ने ASN के लिए, ISP पोर्टल में अनुमति दी है. साथ ही, ज़्यादा जानकारी के लिए यहां इंटिग्रेशन गाइड देखें.