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

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

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

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

एपीआई कुंजियां बनाई जा रही हैं

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

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

कंसोल

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

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

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

Cloud SDK

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

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

• gcloud alpha services api-keys create

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

एपीआई कुंजियों पर पाबंदी लगाना

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

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

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

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

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

अपने साइनिंग सर्टिफ़िकेट का फ़िंगरप्रिंट ढूंढने का तरीका जानने के लिए, नीचे दी गई जानकारी देखें:

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

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

कंसोल

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. एपीआई चुनें ड्रॉपडाउन से Android के लिए Maps SDK टूल चुनें. अगर Android के लिए Maps SDK टूल, सूची में नहीं है, तो आपको उसे enable करना होगा.
4. बदलावों को लागू करने के लिए, सेव करें पर क्लिक करें.
   

Cloud SDK

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

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

मौजूदा बटन पर लगी पाबंदियां हटाएं.

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

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

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="maps-android-backend.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

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

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

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

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