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

निजी पासकोड पाना

शामिल होने के लिए उपलब्ध इंटरफ़ेस का इस्तेमाल करना

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

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

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

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

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

सेवा खाते को वाइटलिस्ट करना

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

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

लाइब्रेरी की सुविधा चालू करना

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

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

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

Google के साथ काम करने वाले तरीकों को ऐक्सेस करने की सुविधा की जांच करने के लिए:

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

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

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

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

  3. इस तरह टेस्ट कॉल करें. YOUR-ASN, इंटिग्रेशन की प्रोसेस के दौरान GTAF को कॉन्फ़िगर करते समय, हमें भेजे गए एएसएन में से एक होना चाहिए. 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"

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

Google के तरीकों को कॉल करने की अनुमति देने के लिए, निर्देशों का पालन करें. इसके लिए, OAuth का यह स्कोप इस्तेमाल करें:

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

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

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