बदलावों का लॉग

Data Plan Agent API

दिसंबर 2019

  1. डीपीए को लागू करने के लिए, register CPID एपीआई की परिभाषा जोड़ी गई.
  2. जब क्लाइंट नए CPID का अनुरोध करता है, तब CPID जनरेट करने और उसे सेव करने के तरीके के बारे में सुझाव जोड़े गए.
  3. सूचनाएं भेजने के लिए, इस्तेमाल किया जाने वाला सीपीआईडी चुनने के तरीके के बारे में दस्तावेज़ जोड़ा गया.
  4. यह साफ़ तौर पर बताया गया है कि जब GTAF, DPA को कॉल करता है और जब DPA, GTAF को कॉल करता है, तब उपयोगकर्ता की भाषा की प्राथमिकताओं का पता कैसे लगाया जाता है.

अक्टूबर 2019

  1. सीपीआईडी एंडपॉइंट से संपर्क करने पर, हर बार एक नए सीपीआईडी की ज़रूरत होती है. सीपीआईडी जनरेट करने के एल्गोरिदम में टाइमस्टैंप जोड़कर, ऐसा किया जा सकता है.
  2. Offer से planLanguage एट्रिब्यूट की वैल्यू हटाने का विकल्प जोड़ा गया है. अब तक, इसे ज़रूरी फ़ील्ड के तौर पर मार्क किया गया था.

सितंबर 2019

  1. डेटा के खत्म होने की सूचनाओं के लिए सहायता जोड़ी गई. ये सूचनाएं, डेटा के खत्म होने की चेतावनी वाली सूचनाओं से अलग होती हैं.

जुलाई 2019

  1. क्लाइंट आइडेंटिफ़ायर की संभावित वैल्यू के बारे में ज़्यादा जानकारी दी गई है.
  2. खाते में टॉप अप करने की सूचनाओं के लिए सहायता जोड़ी गई.
  3. सीपीआईडी जनरेट करने की ज़रूरी शर्तों में ढील दी गई है. अब सीपीआईडी एंडपॉइंट को कॉल करने पर, हर बार नया सीपीआईडी जनरेट करने की ज़रूरत नहीं है.
  4. Mobile Data Plan Sharing API को कॉल करते समय, GTAF से मिलने वाली अलग-अलग गड़बड़ी की प्रतिक्रियाओं के लिए दस्तावेज़ जोड़ा गया.

जून 2019

  1. डीपीए एपीआई स्पेसिफ़िकेशन को अपडेट किया गया है. इसके तहत, कैरिअर को _clientid को क्वेरी पैरामीटर के तौर पर स्वीकार करना होगा.
  2. Mobile Data Plan Sharing API को अपडेट किया गया है. इससे मोबाइल और इंटरनेट सेवा देने वाली कंपनियां, किसी क्लाइंट के लिए उपयोगकर्ता के प्लान की जानकारी Google के साथ शेयर कर सकती हैं.
  3. यह ज़रूरी नहीं कि उपयोगकर्ता को ऑफ़र उसी क्रम में दिखें जिस क्रम में GTAF को ऑफ़र दिए गए हैं.
  4. GTAF, मोबाइल डेटा प्लान के यूज़र इंटरफ़ेस (यूआई) के साथ 10 से ज़्यादा प्लान शेयर कर सकता है.

मई 2019

  1. अगर प्लान की समयसीमा खत्म नहीं होती है, तो ExpirationTime की वैल्यू देना ज़रूरी नहीं है.
  2. RFC 6749 के मुताबिक, OAuth सर्वर के जवाब में token_type को ज़रूरी के तौर पर मार्क करें.
  3. उन सूचनाओं के टाइप दिखाएं जो उपयोगकर्ता को तब भेजी गई थीं, जब कैरियर ने GTAF को प्लान की स्थिति भेजी थी.

अप्रैल 2019

  1. प्रीपेड सदस्यता लेने वाले लोगों के लिए, AccountInfo ज़रूरी है.
  2. सीपीआईडी जनरेट करने के सुझाए गए तरीके को अपडेट किया गया है. इससे सीपीआईडी जनरेट करते समय, सादे टेक्स्ट में भाषा शामिल की जा सकेगी.
  3. ऑफ़र से, moreInfoUrl, operatorLogoUrl, और purchaseUrl के लिए सहायता हटा दी गई है. ये फ़ील्ड, मोबाइल डेटा प्लान के यूज़र इंटरफ़ेस (यूआई) के साथ काम नहीं करते थे. यह बदलाव, पुराने सिस्टम के साथ काम करता है.
  4. जब कोई उपयोगकर्ता, इस्तेमाल के हिसाब से शुल्क चुकाने की सुविधा के तहत डेटा का इस्तेमाल करके खाते में मौजूद बैलेंस खर्च करता है, तब सूचनाएं भेजने की सुविधा जोड़ी गई है.
  5. प्लान मॉड्यूल से, फ़्लेक्सिबल टाइम विंडो की सुविधा हटा दी गई है. यह बदलाव, पुराने सिस्टम के साथ काम करता है. इसलिए, अगर कोई ऑपरेटर हमें फ़्लेक्स टाइम विंडो भेजता है, तो जवाब स्वीकार कर लिया जाएगा.

मार्च 2019

  1. ज़रूरी फ़ील्ड के सेट से offerInfo.promoMessage को हटाएं. उपयोगकर्ताओं को ऑफ़र दिखाते समय, एमडीपी इस फ़ील्ड का इस्तेमाल नहीं करता.
  2. दस्तावेज़ में मौजूद गड़बड़ी को ठीक किया गया है. इसमें बताया गया था कि CPID को कोड में बदलना ज़रूरी है. इसके बजाय, GTAF RFC2396 के हिसाब से सीपीआईडी को कोड में बदलता है.
  3. पुश नोटिफ़िकेशन के लिए ज़रूरी शर्तें जोड़ी गईं.

फ़रवरी 2019

  1. डेटा प्लान शेयर करने वाले एपीआई का इस्तेमाल करके, Google के साथ PlanOffer शेयर करने की सुविधा हटा दी गई है.

जनवरी 2019

  1. इंटरनेट सेवा देने वाली कंपनी के पोर्टल का इस्तेमाल करके, मोबाइल और इंटरनेट सेवा देने वाली कंपनी के कॉन्फ़िगरेशन को अपडेट करने के लिए गाइड जोड़ी गई है.
  2. डेटा प्लान एजेंट एपीआई के लिए, OAuth लागू करने की गाइड जोड़ी गई.
  3. Mobile Data Plan Sharing API इंटिग्रेशन गाइड का नाम बदला गया है और इसे फिर से व्यवस्थित किया गया है.

नवंबर 2018

  1. प्लान चालू करने की सूचनाओं के लिए सहायता जोड़ी गई.
  2. APP_STORE प्लान मॉड्यूल की ट्रैफ़िक कैटगरी के लिए सहायता जोड़ी गई.

सितंबर 2018

  1. ऑपरेटर को उपयोगकर्ता की सहमति की जानकारी देने के लिए, एपीआई जोड़ा गया.
  2. ऐसे प्लान के लिए सहायता जोड़ी गई है जो समय-समय पर PlanModule और Offer के लिए अपना कोटा रीफ़्रेश करते हैं.
  3. एक्सपायरी की सूचनाओं के लिए सहायता जोड़ी गई.
  4. PlanModuleState का नाम बदलकर PlanState कर दिया गया है. यह बदलाव सिर्फ़ दस्तावेज़ में किया गया है. इससे ऑपरेटरों पर कोई असर नहीं पड़ेगा.

अगस्त 2018

  1. कैरियर के लिए, PlanStatus के हिस्से के तौर पर खाते में मौजूद बैलेंस की जानकारी देने की सुविधा जोड़ी गई है.

जून 2018

  1. अपडेट हटा दिया गया है. प्लान के स्टेटस और प्लान के ऑफ़र पाने के तरीके जानें.
  2. बाइट बैलेंस या टाइम बैलेंस की जानकारी के साथ-साथ, अनुमानित बैलेंस लेवल की जानकारी भी दिखाई जा सकती है.
  3. ऑफ़र में कनेक्शन टाइप जोड़ा गया.
  4. PlanModule में plan module state फ़ील्ड जोड़ा गया है, ताकि ऑपरेटर उन प्लान के बारे में बता सके जिन्हें उपयोगकर्ता ने खरीदा है, लेकिन वे अब तक चालू नहीं हुए हैं. यह फ़ील्ड भरना ज़रूरी नहीं है.
  5. DataPlan का नाम बदलकर Plan कर दिया गया है. यह दस्तावेज़ में किया गया बदलाव है. इससे ऑपरेटर पर कोई असर नहीं पड़ना चाहिए.
  6. PlanOffer में formOfPayment फ़ील्ड जोड़ा गया है. इससे ऑपरेटर यह तय कर सकता है कि उपयोगकर्ता से खरीदारी के लिए शुल्क कैसे लिया जाएगा. यह डिफ़ॉल्ट रूप से, प्लान के बैलेंस से काटा जाता है.

मई 2018

  1. CPID रिस्पॉन्स को अपडेट किया गया है, ताकि रिस्पॉन्स पुराने सिस्टम के साथ काम कर सके.
  2. PlanStatus के लिए टाइटल जोड़ा गया. टाइटल का इस्तेमाल, सेटिंग के यूज़र इंटरफ़ेस (यूआई) में हेडर की जानकारी अपने-आप भरने के लिए किया जाएगा.
  3. PlanModule के लिए, मॉड्यूल का नाम और इस्तेमाल किए गए बाइट जोड़े गए.
  4. GTAF में खरीदारी के जवाब के लिए कॉल बैक की सुविधा जोड़ी गई.

मार्च 2018

इस अपडेट में, Data Plan Agent API में ये बदलाव किए गए हैं. ये बदलाव, Data Plan API v4.2 के हिसाब से किए गए हैं. यह एपीआई यहां होस्ट किया गया है.

  1. इन एपीआई कॉल को बंद कर दिया गया है:
    1. उपयोगकर्ता खाते से क्वेरी करना (DPA_URL/{data_plan_key_string}/account).
    2. खरीदे गए प्लान के बारे में क्वेरी करना (DPA_URL/{data_plan_key_string}/purchasedPlans).
  2. यह कुकी, डेटा प्लान की स्थिति के लिए कॉल किए जाने वाले यूआरएल को बदलती है. नए यूआरएल के बारे में यहां बताया गया है. डीपीए से PlanStatus का इंस्टेंस वापस मिलने की उम्मीद है.
  3. यह कुकी, प्लान के ऑफ़र के लिए कॉल किए जाने वाले यूआरएल को बदलती है. नए यूआरएल के बारे में यहां बताया गया है. डीपीए से PlanOffer का इंस्टेंस मिलने की उम्मीद है.
  4. यह कुकी, प्लान खरीदते समय डीपीए को भेजे गए अनुरोध के मुख्य हिस्से में बदलाव करती है. ध्यान दें कि एपीआई कॉल एक ही है. अनुरोध के मुख्य हिस्से में अब TransactionRequest का एक इंस्टेंस शामिल है. ध्यान दें कि एपीआई के पिछले वर्शन की तुलना में, नेस्टिंग का एक लेवल हटा दिया गया है.
  5. खरीदारी के अनुरोध का जवाब बदल गया है. हम Google protobuf की ओर से तय किए गए currency type का इस्तेमाल करते हैं. खरीदारी पूरी होने के बाद, हमें जवाब के मुख्य हिस्से में TransactionResponse का एक इंस्टेंस मिलना चाहिए.
  6. अगर plan_id तय नहीं किया गया है, तो ज़रूरी है कि Eligibility API, उन सभी डेटा प्लान की जानकारी दे जिनके लिए उपयोगकर्ता ज़रूरी शर्तें पूरी करता है. पहले यह ज़रूरी नहीं था.
  7. GTAF के लिए MSISDN रजिस्ट्रेशन एंडपॉइंट जोड़ता है, ताकि DPA के साथ सूचनाएं पाने के लिए MSISDN रजिस्टर किए जा सकें.

Google Mobile Data Plan Sharing API

मार्च 2018

इस अपडेट में, Google Mobile Data Plan Sharing API में ये बदलाव किए गए हैं:

  1. इसमें नए एपीआई कॉल जोड़े गए हैं. इनकी मदद से ऑपरेटर, GTAF को अपसेल ऑफ़र की जानकारी भेज सकता है. इसके बाद, GTAF इस जानकारी को उपयोगकर्ता के डिवाइसों पर भेज सकता है. इन नए कॉल की मदद से, ऑपरेटर Google को ऑफ़र भेज सकता है.
  2. इस फ़ील्ड की मदद से, PlanGroup में आखिरी बार अपडेट किए जाने का समय पता चलता है.
  3. यह फ़ंक्शन, फ़्लेक्स टाइम विंडो से डेटा क्रेडिट प्रतिशत फ़ील्ड को हटाता है.