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

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

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

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

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

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

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

कंसोल Cloud SDK

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

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

  2. क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > एपीआई पासकोड पर क्लिक करें.
    एपीआई पासकोड बनाया गया डायलॉग बॉक्स में, आपका नया एपीआई पासकोड दिखता है.
  3. बंद करें पर क्लिक करें.
    नई एपीआई पासकोड, क्रेडेंशियल पेज पर एपीआई पासकोड में दिखती है.
    (प्रोडक्शन में इस्तेमाल करने से पहले, एपीआई पासकोड पर पाबंदी लगाना मत भूलें.) 
gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

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

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

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

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

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

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

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

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

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

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=maps-android-backend.googleapis.com
    --allowed-application=sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME

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

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

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