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

बंद होने की सूचना: Awareness API को बंद कर दिया गया है.

चेतावनी: Awareness API अब काम नहीं करता.

• Google Play services, आने वाले समय में Awareness API के साथ काम करना बंद कर देगा. ऐसा जनवरी 2027 से हो सकता है.
• इसकी जगह कोई दूसरा विकल्प नहीं है.

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

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

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

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

1. अपने ऐप्लिकेशन के सर्टिफ़िकेट के बारे में जानकारी पाना.
2. Google Developers Console में कोई प्रोजेक्ट रजिस्टर करें और प्रोजेक्ट के लिए सेवा के तौर पर User Context API जोड़ें.
3. कुंजी का अनुरोध करें.
4. अपने ऐप्लिकेशन में कुंजी जोड़ें. इसके लिए, अपने ऐप्लिकेशन मेनिफ़ेस्ट में कोई एलिमेंट जोड़ें.

अपने ऐप्लिकेशन के सर्टिफ़िकेट की जानकारी देखना

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

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

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

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

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

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

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

   • OS 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 Awareness API का इस्तेमाल शुरू करने के लिए, पासकोड पाएं बटन पर क्लिक करें. यह Google Developers Console से लिंक करता है. इससे आपको प्रोसेस के बारे में जानकारी मिलती है और Awareness API अपने-आप चालू हो जाता है.

डिजिटल बटन पाना

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

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

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 एपीआई पासकोड, आपके प्रोजेक्ट के एपीआई पासकोड की सूची में दिखता है. एपीआई पासकोड, वर्णों की एक स्ट्रिंग होती है. जैसे:

   AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
   

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

अतिरिक्त एपीआई चालू करना

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

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