Directions API (लेगसी) के साथ एपीआई पासकोड इस्तेमाल करना

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

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

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

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

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

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

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

कंसोल

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

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

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

Cloud SDK

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

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

• gcloud services api-keys create

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

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

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

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

कंसोल

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

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

2. वह एपीआई पासकोड चुनें जिस पर आपको पाबंदी लगानी है. इसके बाद, एपीआई पासकोड की प्रॉपर्टी वाला पेज दिखेगा.
3. मुख्य पाबंदियां में जाकर, ये पाबंदियां सेट करें:
• ऐप्लिकेशन पर पाबंदियां:
1. आपने वेब सर्वर के आईपी पतों की जो सूची दी है उससे अनुरोध स्वीकार करने के लिए, ऐप्लिकेशन से जुड़ी पाबंदियों की सूची में से आईपी पते (वेब सर्वर, क्रॉन जॉब वगैरह) चुनें. एक या उससे ज़्यादा IPv4 या IPv6 पते डालें या सीआईडीआर नोटेशन का इस्तेमाल करके सबनेट डालें. आईपी पते, उस सोर्स पते से मेल खाने चाहिए जो Google Maps Platform के सर्वर को दिखता है. नेटवर्क अड्रेस ट्रांसलेशन (NAT) का इस्तेमाल करने पर, यह आम तौर पर आपकी मशीन के सार्वजनिक आईपी पते से मेल खाएगा.
• एपीआई से जुड़ी पाबंदियां:
1. कुंजी पर पाबंदी लगाएं पर क्लिक करें.
2. एपीआई चुनें ड्रॉपडाउन से, Directions API (लेगसी) चुनें. अगर Directions API (लेगसी) सूची में नहीं है, तो आपको इसे चालू करना होगा.
4. बदलावों को सेव करने के लिए, सेव करें पर क्लिक करें.
   

Cloud SDK

चेतावनी: gcloud alpha services api-keys update कमांड को चलाने से, एपीआई पासकोड पर लगी मौजूदा पाबंदियां बदल जाती हैं. यह कमांड को पास की गई नई पाबंदियों को मौजूदा पाबंदियों में नहीं जोड़ता.

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

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=directions-backend.googleapis.com
    --allowed-ips="IP_ADDRESS"

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

• gcloud services api-keys update
• gcloud services api-keys lookup
• gcloud services api-keys list

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

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

https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY

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

ध्यान दें: वेब सेवाओं का इस्तेमाल करते समय, आपको पैरामीटर में मौजूद सभी खास वर्णों को कोड में बदलना होगा. मान्य होने के लिए, यूआरएल को सही तरीके से कोड में बदला जाना चाहिए. साथ ही, सभी वेब सेवाओं के लिए, यूआरएल में 2,048 से ज़्यादा वर्ण नहीं होने चाहिए. यूआरएल बनाते समय इस सीमा का ध्यान रखें. अलग-अलग ब्राउज़र, प्रॉक्सी, और सर्वर के लिए, यूआरएल में वर्णों की सीमा भी अलग-अलग हो सकती है.