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

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

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

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

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

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

Console

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

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

  2. वह एपीआई पासकोड चुनें जिस पर पाबंदी लगानी है. इसके बाद, एपीआई पासकोड प्रॉपर्टी का पेज दिखेगा.
  3. मुख्य पाबंदियां में जाकर, ये पाबंदियां सेट करें:
    • ऐप्लिकेशन के इस्तेमाल से जुड़ी पाबंदियां:
      1. आपकी दी गई वेबसाइटों की सूची से अनुरोध स्वीकार करने के लिए, ऐप्लिकेशन पाबंदियों की सूची में से एचटीटीपी रेफ़रर (वेबसाइटें) चुनें.
      2. रेफ़रल देने वाली एक या उससे ज़्यादा वेबसाइटें बताएं. सभी सबडोमेन की अनुमति देने के लिए, वाइल्डकार्ड वर्णों का इस्तेमाल किया जा सकता है (उदाहरण के लिए, एचटीटीपीएस पर ऐक्सेस करने पर, https://*.google.com उन सभी साइटों को स्वीकार करता है जिनके आखिर में .google.com आता है). ध्यान दें कि अगर www.domain.com के बारे में बताया जाता है, तो यह एक वाइल्डकार्ड www.domain.com/* की तरह काम करता है और उस होस्टनेम पर किसी भी सबपाथ को अनुमति देता है. सिर्फ़ https:// और http:// रेफ़रर स्कीम इस्तेमाल की जा सकती हैं.
    • एपीआई से जुड़ी पाबंदियां:
      1. बटन पर पाबंदी लगाएं पर क्लिक करें.
      2. एपीआई चुनें ड्रॉपडाउन से Maps Embed API चुनें. अगर Maps Embed API मौजूद नहीं है, तो आपको उसे enable करना होगा.
      3. अगर आपके प्रोजेक्ट में जगहें लाइब्रेरी का इस्तेमाल किया जाता है, तो Locations 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-embed-backend.googleapis.com"
    --allowed-referrers="referer"

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

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

आपको हर Maps Embed API अनुरोध के साथ एक एपीआई पासकोड शामिल करना होगा. यहां दिए गए उदाहरण में, YOUR_API_KEY को अपनी एपीआई पासकोड से बदलें. 

  https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&parameters