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

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

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

शुरू करने से पहले: Places Insights API का इस्तेमाल शुरू करने से पहले, आपको बिलिंग खाते और जगहों की अहम जानकारी का एपीआई चालू किया गया. हमारा सुझाव है कि आप एक से ज़्यादा प्रोजेक्ट के मालिक और बिलिंग एडमिन बनाएं, ताकि आपकी टीम के पास इन भूमिकाओं के लिए हमेशा कोई व्यक्ति उपलब्ध रहे. इस बारे में ज़्यादा जानने के लिए, यह देखें Cloud Console में सेट अप करें.

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

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

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

कंसोल

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

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

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

Cloud SDK

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

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

• gcloud alpha services api-keys create

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

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

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

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

कंसोल

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

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

2. वह एपीआई कुंजी चुनें जिस पर आपको पाबंदी सेट करनी है. आपको एपीआई पासकोड प्रॉपर्टी पेज दिखेगा.
3. मुख्य पाबंदियां में जाकर, इन पाबंदियों को सेट करें:
• ऐप्लिकेशन से जुड़ी पाबंदियां:
1. आपने जो वेब सर्वर आईपी पते दिए हैं उनकी सूची से अनुरोधों को स्वीकार करने के लिए, सूची में से IP पते (वेब सर्वर, क्रॉन जॉब वगैरह) ऐप्लिकेशन से जुड़ी पाबंदियां. एक या उससे ज़्यादा आईपीवी4 या आईपीवी6 पता बताएं, या सबनेट का इस्तेमाल सीआईडीआर नोटेशन का इस्तेमाल करके किया जा सकता है. IP पते, Google Maps Platform के सर्वर निगरानी करते हैं. अगर आपको नेटवर्क पते का अनुवाद (NAT), यह आम तौर पर आपकी मशीन के सार्वजनिक आईपी पते से जुड़ा होता है.
• एपीआई से जुड़ी पाबंदियां:
1. कुंजी पर पाबंदी लगाएं पर क्लिक करें.
2. एपीआई चुनें ड्रॉपडाउन से, Places Insights API चुनें. यदि Places Insights 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="areainsights.googleapis.com"
    --allowed-ips="IP_ADDRESS"

यहां दी गई, Google Cloud SDK टूल , Cloud SDK टूल इंस्टॉल करना , और ये निर्देश दिए जा सकते हैं:

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

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

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

https://areainsights.googleapis.com/v1:computeInsights?key=YOUR_API_KEY

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

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