OAuth 2.0 क्लाइंट आईडी पाना

खास जानकारी

Android के लिए Google Fit का इस्तेमाल करने के लिए, आपको Android ऐप्लिकेशन के लिए OAuth 2.0 क्लाइंट आईडी की ज़रूरत होगी.

सभी Android ऐप्लिकेशन को डिजिटल सर्टिफ़िकेट से साइन किया जाता है. इस सर्टिफ़िकेट का निजी पासकोड आपके पास होता है. डिजिटल सर्टिफ़िकेट के बारे में ज़्यादा जानकारी के लिए, ऐप्लिकेशन साइन करने के लिए Android गाइड देखें.

Android OAuth क्लाइंट आईडी, सर्टिफ़िकेट/पैकेज के खास पेयर से लिंक होते हैं. आपको हर सर्टिफ़िकेट के लिए सिर्फ़ एक आईडी की ज़रूरत होती है. इससे कोई फ़र्क़ नहीं पड़ता कि आपके ऐप्लिकेशन के लिए कितने उपयोगकर्ता हैं.

अपने ऐप्लिकेशन के लिए आईडी पाने के लिए, आपको कई चरण पूरे करने होंगे. यहां दिए गए तरीके अपनाएं.

  1. अपने ऐप्लिकेशन के सर्टिफ़िकेट की जानकारी ढूंढें.
  2. Google API Console में कोई प्रोजेक्ट बनाएं या उसमें बदलाव करें.
  3. OAuth 2.0 क्लाइंट आईडी का अनुरोध करें.

अपने ऐप्लिकेशन के सर्टिफ़िकेट की जानकारी ढूंढना

एपीआई पासकोड, आपके ऐप्लिकेशन के डिजिटल सर्टिफ़िकेट के छोटे वर्शन पर आधारित होता है. इसे SHA-1 फ़िंगरप्रिंट कहा जाता है. अपने सर्टिफ़िकेट के लिए SHA-1 फ़िंगरप्रिंट दिखाने के लिए, पहले पक्का करें कि आपने सही सर्टिफ़िकेट का इस्तेमाल किया हो. आपके पास दो सर्टिफ़िकेट हो सकते हैं:

  • डीबग सर्टिफ़िकेट: Android SDK टूल, डीबग बिल्ड बनाने पर इस सर्टिफ़िकेट को अपने-आप जनरेट करते हैं. इस सर्टिफ़िकेट का इस्तेमाल सिर्फ़ उन ऐप्लिकेशन के साथ करें जिनकी आपको टेस्टिंग करनी है. डीबग सर्टिफ़िकेट से साइन किए गए ऐप्लिकेशन को पब्लिश करने की कोशिश न करें. डीबग सर्टिफ़िकेट के बारे में ज़्यादा जानकारी, Android डेवलपर के दस्तावेज़ में डीबग मोड में साइन करना लेख में दी गई है.
  • रिलीज़ सर्टिफ़िकेट: Android SDK टूल, रिलीज़ बिल्ड बनाने के दौरान इस सर्टिफ़िकेट को जनरेट करते हैं. keytool प्रोग्राम का इस्तेमाल करके भी यह प्रमाणपत्र जनरेट किया जा सकता है. जब आपको अपना ऐप्लिकेशन दुनिया भर के लोगों के लिए रिलीज़ करना हो, तब इस सर्टिफ़िकेट का इस्तेमाल करें.

keytool पैरामीटर के साथ keytool प्रोग्राम का इस्तेमाल करके, किसी सर्टिफ़िकेट के SHA-1 फ़िंगरप्रिंट को दिखाने के लिए, यहां दिया गया तरीका अपनाएं.-v Keytool के बारे में ज़्यादा जानकारी के लिए, Oracle का दस्तावेज़ देखें.

डीबग सर्टिफ़िकेट

डीबग सर्टिफ़िकेट फ़िंगरप्रिंट दिखाया जा रहा है

  1. अपनी डीबग कीस्टोर फ़ाइल ढूंढें. फ़ाइल का नाम debug.keystore है. यह फ़ाइल, प्रोजेक्ट बनाते समय पहली बार बनती है. डिफ़ॉल्ट रूप से, इसे उसी डायरेक्ट्री में सेव किया जाता है जिसमें आपके Android वर्चुअल डिवाइस (एवीडी) की फ़ाइलें सेव होती हैं:

    • macOS और Linux: ~/.android/
    • Windows Vista और Windows 7: C:\Users\your_user_name\.android\

  2. SHA-1 फ़िंगरप्रिंट की सूची बनाएं:

    • Linux या macOS के लिए, टर्मिनल विंडो खोलें और यह डालें:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

    • Windows Vista और Windows 7 के लिए, यह कमांड चलाएं:

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

आपको इससे मिलता-जुलता आउटपुट दिखेगा:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3
रिलीज़ सर्टिफ़िकेट

रिलीज़ सर्टिफ़िकेट का फ़िंगरप्रिंट दिखाया जा रहा है

  1. अपनी रिलीज़ सर्टिफ़िकेट की कीस्टोर फ़ाइल ढूंढें. रिलीज़ कीस्टोर के लिए, कोई डिफ़ॉल्ट जगह या नाम नहीं होता. अगर रिलीज़ के लिए ऐप्लिकेशन बनाते समय, आपने किसी हस्ताक्षर के बारे में नहीं बताया है, तो बिल्ड में .apk पर हस्ताक्षर नहीं किया जाएगा. इसलिए, आपको इसे पब्लिश करने से पहले हस्ताक्षर करना होगा. रिलीज़ सर्टिफ़िकेट के लिए, आपको सर्टिफ़िकेट का एलियास और कीस्टोर और सर्टिफ़िकेट के पासवर्ड भी चाहिए. किसी कीस्टोर में मौजूद सभी कुंजियों के लिए, उपनामों की सूची बनाने के लिए यह कमांड डालें:

    keytool -list -keystore your_keystore_name

    your_keystore_name की जगह, कीस्टोर का पूरी तरह क्वालिफ़ाइड पाथ और नाम डालें. इसमें .keystore एक्सटेंशन भी शामिल करें. इसके बाद, आपको कीस्टोर का पासवर्ड डालने के लिए कहा जाएगा. इसके बाद, keytool कीस्टोर में मौजूद सभी एलियास दिखाता है.

  2. टर्मिनल या कमांड प्रॉम्प्ट पर यह डालें:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    your_keystore_name की जगह, कीस्टोर का पूरी तरह क्वालिफ़ाइड पाथ और नाम डालें. इसमें .keystore एक्सटेंशन भी शामिल करें. your_alias_name को उस एलियास से बदलें जिसे आपने सर्टिफ़िकेट बनाते समय असाइन किया था.

आपको इससे मिलता-जुलता आउटपुट दिखेगा:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

SHA1 से शुरू होने वाली लाइन में, सर्टिफ़िकेट का SHA-1 फ़िंगरप्रिंट होता है. फ़िंगरप्रिंट, कोलन से अलग किए गए दो अंकों वाले 20 हेक्साडेसिमल नंबर का क्रम होता है.

Google API Console में OAuth 2.0 क्लाइंट आईडी का अनुरोध करना

Google API Console में अपने ऐप्लिकेशन के लिए कोई प्रोजेक्ट बनाने या उसमें बदलाव करने, Fitness API चालू करने, और OAuth 2.0 क्लाइंट आईडी का अनुरोध करने के लिए, यह तरीका अपनाएं.

अगर आपको इस प्रोसेस के बारे में निर्देश चाहिए और Fitness API को अपने-आप चालू करना है, तो

क्लाइंट आईडी पाना

इसके अलावा, Google API Console में Fitness API को चालू करने और OAuth 2.0 क्लाइंट आईडी पाने के लिए, यह तरीका अपनाएं.

  1. Google API Console पर जाएं.
  2. कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. अपने ऐप्लिकेशन के Android और REST वर्शन के लिए, एक ही प्रोजेक्ट का इस्तेमाल करें.
  3. Fitness API चालू करने के लिए, जारी रखें पर क्लिक करें.
  4. क्रेडेंशियल पर जाएं पर क्लिक करें.
  5. नए क्रेडेंशियल पर क्लिक करें. इसके बाद, OAuth क्लाइंट आईडी चुनें.
  6. ऐप्लिकेशन टाइप में जाकर, Android चुनें.

  7. इसके बाद दिखने वाले डायलॉग बॉक्स में, अपने ऐप्लिकेशन का SHA-1 फ़िंगरप्रिंट और पैकेज का नाम डालें. उदाहरण के लिए:

    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

    com.example.android.fit-example

  8. बनाएं पर क्लिक करें. आपका नया Android OAuth 2.0 क्लाइंट आईडी और सीक्रेट, आपके प्रोजेक्ट के आईडी की सूची में दिखता है. OAuth 2.0 क्लाइंट आईडी, वर्णों की एक स्ट्रिंग होती है. यह कुछ इस तरह की होती है:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com