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

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

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

Android के लिए जगहें SDK टूल का इस्तेमाल शुरू करने से पहले, आपके पास बिलिंग खाते वाला एक प्रोजेक्ट होना चाहिए. साथ ही, Android के लिए जगहें 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 का सुझाव है कि आप अपनी एपीआई कुंजियों के इस्तेमाल को सिर्फ़ उन एपीआई तक सीमित करें जो आपके ऐप्लिकेशन के लिए ज़रूरी हैं. API कुंजियों को प्रतिबंधित करने से आपके ऐप्लिकेशन को अनचाहे अनुरोधों से बचाकर उसे और भी सुरक्षित बनाया जाता है. ज़्यादा जानकारी के लिए, एपीआई की सुरक्षा से जुड़े सबसे सही तरीके देखें.

अपनी एपीआई पासकोड पर पाबंदी लगाते समय, आपको उस साइनिंग पासकोड का 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. एपीआई चुनें ड्रॉपडाउन से जगहें एपीआई चुनें. अगर जगहों का एपीआई सूची में नहीं है, तो आपको उसे चालू करना होगा.
  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="places-backend.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

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

आगे क्या

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