साइन अप और एपीआई कुंजियां

Google के एपीआई एपीआई का इस्तेमाल करने के लिए, आपको अपने ऐप्लिकेशन में Google API कुंजी जोड़नी होगी. आपको जिस एपीआई कुंजी की ज़रूरत है वह एक Android एपीआई कुंजी है.

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

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

ऐप्लिकेशन की कुंजी पाने के लिए, आपको यह तरीका अपनाना होगा. इस गाइड में इनके बारे में ज़्यादा जानकारी दी गई है, साथ ही इन्हें भी कम शब्दों में बताया गया है:

1. अपने ऐप्लिकेशन के सर्टिफ़िकेट के बारे में जानकारी पाएं.
2. Google Developers Console में कोई प्रोजेक्ट रजिस्टर करें और प्रोजेक्ट के लिए एक सेवा के तौर पर 'उपयोगकर्ता कॉन्टेक्स्ट एपीआई' जोड़ें.
3. कुंजी मांगें.
4. अपने ऐप्लिकेशन में कुंजी जोड़ें. ऐसा करने के लिए, अपने ऐप्लिकेशन मेनिफ़ेस्ट में कोई एलिमेंट जोड़ें.

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

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

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

keytool के बारे में ज़्यादा जानकारी के लिए, इसका Oracle दस्तावेज़ देखें.

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

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

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

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

   • ओएस X और Linux: ~/.android/
   • Windows Vista और Windows 7: C:\Users\your_user_name\.android\

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

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

     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

रिलीज़ सर्टिफ़िकेट

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

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

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

2. किसी कीस्टोर में दी गई सभी कुंजियों के उपनामों को सूचीबद्ध करने के लिए यह डालें:

   keytool -list -keystore your_keystore_name
         

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

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

         keytool -list -v -keystore your_keystore_name -alias your_alias_name
         

5. your_keystore_name को पूरी तरह क्वालिफ़ाइड पाथ और कीस्टोर के नाम से बदलें. .keystore एक्सटेंशन शामिल करें.
6. 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 हेक्साडेसिमल नंबर का क्रम होता है जिन्हें कोलन लगाकर अलग किया जाता है.

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

Google Developers Console से एपीआई कुंजी पाएं

Google अवेयरनेस एपीआई का इस्तेमाल शुरू करने के लिए, कुंजी देखें बटन पर क्लिक करें. यह Google Developers Console से लिंक होता है, जो प्रोसेस के बारे में जानकारी देता है और अवेयरनेस एपीआई को अपने-आप चालू करता है.

कुंजी पाना

इसके अलावा, एपीआई पासकोड पाने के लिए यह तरीका अपनाएं:

1. Google Developers Console पर जाएं.
2. कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं.
3. अवेयरनेस एपीआई को चालू करने के लिए, जारी रखें पर क्लिक करें.

4. "क्रेडेंशियल" पेज पर, Android कुंजी बनाएं और एपीआई क्रेडेंशियल सेट करें.

   ध्यान दें: अगर आपके पास पहले से Android कुंजी है, तो उसका इस्तेमाल करें.

5. 'कुंजी बनाएं' डायलॉग में, आपको Android ऐप्लिकेशन का इस्तेमाल करने पर पाबंदी लगानी होगी. ऐसा करने के लिए, अपने ऐप्लिकेशन के 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.awareness-example
   

6. बनाएं पर क्लिक करें. आपकी नई Android API कुंजी, आपके प्रोजेक्ट की एपीआई कुंजियों की सूची में दिखती है. एपीआई कुंजी, वर्णों की एक स्ट्रिंग होती है. उदाहरण के लिए:

   AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
   

अब जब आपके पास एक एपीआई पासकोड है, तो उसे अपने ऐप्लिकेशन के मेनिफ़ेस्ट में जोड़ा जा सकता है. इसकी जानकारी, शुरू करें गाइड में दी गई है.

अन्य एपीआई चालू करें

अवेयरनेस एपीआई की मदद से, कई तरह के संदर्भ वाले डेटा को ऐक्सेस किया जा सकता है, जैसे कि बीकन. इन टाइप का इस्तेमाल करने के लिए, आपको Google Developers Console में इससे जुड़े एपीआई चालू करने होंगे.

सेवा	अवेयरनेस एपीआई के तरीके	चालू करने के लिए एपीआई
बीकन	SnapshotApi.getBeaconState(), FenceApi.BeaconFence	Nearby Messages एपीआई