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

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 दस्तावेज़ देखें.

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

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

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

  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
रिलीज़ सर्टिफ़िकेट

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

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

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

    AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0

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

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

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

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