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

ज़रूरी शर्तें

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

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

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

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

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

इसके अलावा, डीपीए को 200-OK जवाब देना होगा. अनुरोध स्वीकार किए जाने पर, EligibilityResponse का फ़ॉर्मैट यह होता है:

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

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

Android पर 5G की सुविधाएं

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

पुल एपीआई

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

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

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

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

client_id AndroidSystemInfo है

मीटर किए गए कॉन्टेंट का स्टेटस, ENUM के तौर पर दिया जाता है

DPA को 200 OK रिस्पॉन्स देना होगा और इसमें planInfoPerClient शामिल करना होगा DPA के लिए गड़बड़ी ठीक करने की प्रोसेस यहां बताई गई है

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

पुश एपीआई

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

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

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

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