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

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

Google Maps Platform से जुड़े प्रॉडक्ट, बिना अनुमति के इस्तेमाल किए जा सकते हैं. इसके लिए, एपीआई कॉल को ऐसे कॉल करने वालों तक सीमित रखें जो पुष्टि करने के सही क्रेडेंशियल देते हैं. ये क्रेडेंशियल, एपीआई कुंजी के रूप में होते हैं - यह अक्षरों और अंकों से बनी एक यूनीक स्ट्रिंग होती है जो आपके Google बिलिंग खाते को आपके प्रोजेक्ट से जोड़ती है. साथ ही, यह किसी खास एपीआई या SDK टूल से भी जुड़ी होती है.

इस गाइड में, Google Maps Platform के लिए अपनी एपीआई कुंजी बनाने, उस पर पाबंदी लगाने, और इस्तेमाल करने का तरीका बताया गया है.

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

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

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

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

एपीआई कुंजी बनाने के लिए:

कंसोल

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

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

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

Cloud SDK

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

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

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

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

एपीआई कुंजी को सीमित करने के लिए:

कंसोल

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

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

  2. वह एपीआई कुंजी चुनें जिस पर आप पाबंदी लगाना चाहते हैं. इसके बाद, एपीआई कुंजी की प्रॉपर्टी वाला पेज दिखेगा.
  3. मुख्य पाबंदियां में जाकर, ये पाबंदियां सेट करें:
    • ऐप्लिकेशन पर लगी पाबंदियां:
      1. आपकी दी गई वेबसाइटों की सूची से मिले अनुरोधों को स्वीकार करने के लिए, ऐप्लिकेशन से जुड़ी पाबंदियों की सूची से एचटीटीपी रेफ़रल देने वाले (वेबसाइटें) चुनें.
      2. एक या ज़्यादा रेफ़रर वेबसाइटों के बारे में बताएं. वाइल्डकार्ड वर्ण सभी सबडोमेन को अनुमति देने के लिए मान्य हैं (उदाहरण के लिए, *.google.com .google.com से खत्म होने वाली सभी साइटों को स्वीकार करता है). https:// और http:// को जैसा है वैसा ही बताएं. आपको अन्य तरह के रेफ़रर यूआरएल प्रोटोकॉल के लिए एक खास प्रज़ेंटेशन का इस्तेमाल करना होगा. उदाहरण के लिए, file:///path/to/ को __file_url__//path/to/* के तौर पर फ़ॉर्मैट करें. रेफ़रर को चालू करने के बाद, इस्तेमाल पर नज़र रखें और पक्का करें कि यह आपकी उम्मीदों से मेल खाता हो. ये रेफ़रर प्रोटोकॉल यहां काम करते हैं: about://, app://, applewebdata://, asset://, chrome://, content://, file://, ftp://, ionic://, local://, ms-appx://, ms-appx-web://, ms-local-stream://, prism://, qrc://, res://, saphtmlp://.
    • एपीआई की पाबंदियां:
      1. कुंजी पर पाबंदी लगाएं पर क्लिक करें.
      2. एपीआई चुनें ड्रॉपडाउन से Maps JavaScript API चुनें. अगर Maps JavaScript API सूची में नहीं है, तो आपको इसे चालू करना होगा.
      3. अगर आपका प्रोजेक्ट 'जगहें लाइब्रेरी' का इस्तेमाल करता है, तो जगह API भी चुनें. इसी तरह, अगर आपका प्रोजेक्ट JavaScript API में दूसरी सेवाओं का इस्तेमाल करता है (निर्देश सेवा, दूरी मैट्रिक्स सेवा, ऊंचाई सेवा, और/या जियोकोडिंग सेवा, तो आपको भी इस सूची में संबंधित एपीआई को चालू और चुनना होगा.
  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-backend.googleapis.com"
    --allowed-referrers="referer

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

अपने अनुरोध में एपीआई कुंजी जोड़ें

आपको हर 'Maps JavaScript API' अनुरोध के लिए एक एपीआई कुंजी शामिल करनी होगी. नीचे दिए गए उदाहरण में, YOUR_API_KEY को अपनी एपीआई कुंजी से बदलें. 

  <script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"></script>

एपीआई कुंजी का इस्तेमाल करने वाले अनुरोधों के लिए, एचटीटीपीएस ज़रूरी है.