इंटिग्रेशन गाइड

निजी कुंजी पाएं

ऑनबोर्डिंग इंटरफ़ेस का इस्तेमाल करना

एपीआई के साथ इंटिग्रेट करने के लिए, आपको Google Cloud प्रोजेक्ट बनाना होगा. इसके बाद, सेवा खाता बनाएं और निजी कुंजी पाएं. शुरू करने के लिए, नीचे दिया गया बटन क्लिक करें:

सेवा खाता बनाएं

मैन्युअल तरीके से कुंजी जनरेट करना

अगर ऊपर दिया गया इंटरफ़ेस काम नहीं करता है, तो कृपया ये आज़माएं:

  1. Google Cloud Console पर जाएं.
  2. वह प्रोजेक्ट चुनें जिसका इस्तेमाल करके एपीआई को ऐक्सेस किया जाएगा.
  3. बाईं ओर IAM और एडमिन मेन्यू में जाकर, सेवा खाते ढूंढें और नया सेवा खाता बनाएं जो प्रोजेक्ट का मालिक होगा.
  4. सेवा खाता बन जाने के बाद, आपको एक निजी कुंजी मिलेगी.

सेवा खाते को अनुमति दें

सेवा खाता बनाने के बाद:

  1. Google खाते से mdp-support@google.com पर GTAF टीम से संपर्क करें. यह Google प्रोजेक्ट का मालिक है. हम मोबाइल डेटा प्लान शेयर करने वाले एपीआई एंडपॉइंट को ऐक्सेस करने के लिए, Google खाते को अनुमति देंगे.
  2. सेवा खाते को Google ISP पोर्टल पर कैरियर के साथ संबद्ध करें. मोबाइल और इंटरनेट सेवा देने वाली कंपनी एपीआई ऐक्सेस पर जाकर, इसे जोड़ सकती है.

लाइब्रेरी चालू करें

अनुमति मिल जाने के बाद:

  1. Google Cloud Console में जाएं.
  2. पक्का करें कि आपने सबसे ऊपर दिए गए मेन्यू बार के ड्रॉपडाउन मेन्यू में सही प्रोजेक्ट चुना हो.
  3. एपीआई लाइब्रेरी में मोबाइल डेटा प्लान शेयर करने वाला एपीआई चालू करें.
  4. एपीआई लाइब्रेरी में, पहले से मोबाइल डेटा प्लान शेयर करने वाला एपीआई चालू करें.

एपीआई ऐक्सेस की जांच करें

Google साइड मेथड के ऐक्सेस का टेस्ट करने के लिए:

  1. oauth2l इंस्टॉल करें.

  2. अपने सेवा खाते के लिए, इस तरह से ऐक्सेस टोकन पाएं. your-service-account-key-file.json, सेवा खाते की एक अहम फ़ाइल होती है.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    ध्यान दें कि ऐक्सेस टोकन की समयसीमा करीब एक घंटे में खत्म हो जाती है. नए ऐक्सेस टोकन के लिए, फिर से कमांड करने से पहले, oauth2l reset चलाएं. इससे, लोकल कैश मेमोरी मिट जाएगी.

  3. टेस्ट कॉल इस तरह से करें. इंटिग्रेशन प्रोसेस के दौरान GTAF को कॉन्फ़िगर करते समय, YOUR-ASN हमें वही ASN होना चाहिए जो आप हमें भेजते हैं. ACCESS-TOKEN-OBTAINED, ऊपर दिए गए oauth2l fetch निर्देश का आउटपुट है. PLAN_STATUS, PlanStatus अनुरोध का मुख्य हिस्सा है, जिसे आप GTAF पर भेजना चाहते हैं.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

प्रोग्रामेटिक एपीआई कॉल

नीचे दिए गए OAuth के दायरे के साथ, Google की ओर से कॉल करने की अनुमति पा चुके तरीकों को कॉल करने के लिए, निर्देशों का पालन करें:

https://www.googleapis.com/auth/dataplansharing

प्रोजेक्ट का मालिकाना हक शेयर करना

शुरुआती सेट अप में सिर्फ़ एक Google खाता शामिल होता है, लेकिन अनुमति वाले उपयोगकर्ताओं के ग्रुप के पास प्रोजेक्ट का मालिकाना हक होना अच्छा आइडिया है. Google Cloud Console में, IAM और एएमपी; एडमिन मेन्यू में, आप नए सदस्यों (Google ग्रुप के खाते) को प्रोजेक्ट का मालिक बना सकते हैं.