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

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

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

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

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

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

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

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 इंस्टॉल करने का तरीका , और इन निर्देशों के बारे में ज़्यादा जानें:

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

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

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

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

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

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

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

Console

  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 इंस्टॉल करने का तरीका , और इन निर्देशों के बारे में ज़्यादा जानें:

आगे क्या

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