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

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

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

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

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

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

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

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

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

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

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

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

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

  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 फ़िंगरप्रिंट दिखाने के लिए, keytool प्रोग्राम का इस्तेमाल करें. इसके लिए, -v पैरामीटर का इस्तेमाल करें. इसके लिए, यह तरीका अपनाएं:

  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 हेक्साडेसिमल नंबर की सीक्वेन्स होती है.

Google Developers Console से एपीआई पासकोड पाना

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

पासकोड पाएं

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

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

  4. "क्रेडेंशियल" पेज पर, 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

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

दूसरे एपीआई चालू करना

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

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