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 प्रोग्राम का इस्तेमाल करके भी यह सर्टिफ़िकेट जनरेट किया जा सकता है. जब आपका ऐप्लिकेशन पूरी दुनिया के लिए रिलीज़ करने के लिए तैयार हो, तब इस सर्टिफ़िकेट का इस्तेमाल करें.

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

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

डीबग सर्टिफ़िकेट का फ़िंगरप्रिंट दिखाना

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

    • 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 नहीं चुना है, तो बाइल्ड में आपके .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 कंसोल पर जाएं.
  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