एपीआई पासकोड का इस्तेमाल करना

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

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

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

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

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

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

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

कंसोल

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

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

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

Cloud SDK

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

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

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

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

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

कंसोल

  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 सूची में नहीं है, तो आपको इसे चालू करना होगा.
      3. अगर आपका प्रोजेक्ट Places लाइब्रेरी का इस्तेमाल करता है, तो Places API भी चुनें. इसी तरह, अगर आपका प्रोजेक्ट JavaScript API की अन्य सेवाओं (निर्देश देने वाली सेवा, दूरी का मैट्रिक्स बताने वाली सेवा, ऊंचाई बताने वाली सेवा, और/या जियोकोडिंग सेवा) का इस्तेमाल करता है, तो आपको इस सूची में मौजूद उससे जुड़े एपीआई को भी चालू करना होगा और चुनना होगा.
  4. अपने बदलावों को लागू करने के लिए, सेव करें पर क्लिक करें.

Cloud SDK

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

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-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