एपीआई कुंजियों का इस्तेमाल करना

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा

शुरू करने से पहले

Places SDK for Android का इस्तेमाल शुरू करने से पहले, आपके पास एक ऐसा प्रोजेक्ट होना चाहिए जिसमें बिलिंग खाता और Places SDK for Android चालू हो. ज़्यादा जानने के लिए, Cloud कंसोल में सेट अप करना लेख पढ़ें.

एपीआई पासकोड बनाना

ध्यान दें: अगर मौजूदा Places SDK for Android और Places SDK for Android (नया) दोनों का इस्तेमाल किया जा रहा है, तो दोनों को एक ही एपीआई कुंजी पर चालू किया जा सकता है.

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

एपीआई पासकोड बनाने के लिए:

कंसोल Cloud SDK

1. Google Maps Platform > क्रेडेंशियल पेज पर जाएं.

   क्रेडेंशियल पेज पर जाएं

2. क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > एपीआई पासकोड पर क्लिक करें.
   एपीआई पासकोड बनाया गया डायलॉग बॉक्स में, आपका नया एपीआई पासकोड दिखता है.
3. बंद करें पर क्लिक करें.
   नई एपीआई पासकोड, क्रेडेंशियल पेज पर एपीआई पासकोड में दिखती है.
   (प्रोडक्शन में इस्तेमाल करने से पहले, एपीआई पासकोड पर पाबंदी लगाना न भूलें.)

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK , Cloud SDK टूल इंस्टॉल करने , और इन निर्देशों के बारे में ज़्यादा पढ़ें:

• gcloud services api-keys create

ध्यान दें: Android के लिए Maps SDK और Places SDK for Android ऐप्लिकेशन के लिए, एक ही एपीआई कुंजी का इस्तेमाल किया जा सकता है.

एपीआई पासकोड पर पाबंदी लगाना

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

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

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

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

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

हस्ताक्षर करने के लिए इस्तेमाल किए जाने वाले सर्टिफ़िकेट का फ़िंगरप्रिंट ढूंढने का तरीका जानने के लिए, यहां दिए गए रेफ़रंस देखें:

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

किसी एपीआई पासकोड पर पाबंदी लगाने के लिए:

कंसोलCloud SDK

1. Google Maps Platform > क्रेडेंशियल पेज पर जाएं.

   क्रेडेंशियल पेज पर जाएं

2. वह एपीआई कुंजी चुनें जिस पर आपको पाबंदी सेट करनी है. एपीआई कुंजी प्रॉपर्टी पेज दिखेगा.
3. मुख्य पाबंदियां में जाकर, ये पाबंदियां सेट करें:
• ऐप्लिकेशन से जुड़ी पाबंदियां:
1. Android ऐप्लिकेशन को चुनें.
2. + पैकेज का नाम और फ़िंगरप्रिंट जोड़ें पर क्लिक करें.
3. अपना पैकेज नाम और SHA-1 सर्टिफ़िकेट फ़िंगरप्रिंट डालें. उदाहरण के लिए:

   com.example.android.mapexample

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

• एपीआई से जुड़ी पाबंदियां:
1. कुंजी पर पाबंदी लगाएं पर क्लिक करें.
2. एपीआई चुनें ड्रॉपडाउन से, Places API या Places API (नया) में से किसी एक को चुनें, न कि दोनों को. अगर Places API सूची में नहीं है, तो आपको इसे चालू करना होगा.
   ध्यान दें: अगर मौजूदा Places API और Places API (नया) दोनों का इस्तेमाल किया जा रहा है, तो हमारा सुझाव है कि आप हर एपीआई वर्शन के लिए अलग-अलग एपीआई कुंजी बनाएं.
4. अपने बदलावों को लागू करने के लिए, सेव करें पर क्लिक करें.
   

Places SDK for Android (नया)Android के लिए Places SDK टूल

मौजूदा कुंजियों की सूची बनाएं.

gcloud services api-keys list --project="PROJECT"

मौजूदा पासकोड पर लगी पाबंदियां हटाएं.

gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

मौजूदा पासकोड पर नई पाबंदियां सेट करें.

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=places.googleapis.com
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Google Cloud SDK , Cloud SDK टूल इंस्टॉल करने , और इन निर्देशों के बारे में ज़्यादा पढ़ें:

• gcloud services api-keys update
• gcloud services api-keys lookup
• gcloud api-keys list

मौजूदा कुंजियों की सूची बनाएं.

gcloud services api-keys list --project="PROJECT"

मौजूदा पासकोड पर लगी पाबंदियां हटाएं.

gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

मौजूदा पासकोड पर नई पाबंदियां सेट करें.

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=places-backend.googleapis.com
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Google Cloud SDK , Cloud SDK टूल इंस्टॉल करने , और इन निर्देशों के बारे में ज़्यादा पढ़ें:

• gcloud services api-keys update
• gcloud services api-keys lookup
• gcloud api-keys list

आगे क्या करना है

अब आपके पास एपीआई पासकोड है. इसलिए, Android Studio प्रोजेक्ट सेट अप करना लेख में बताए गए तरीके से प्रोजेक्ट बनाएं और कॉन्फ़िगर करें.