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

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

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

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

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

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

कंसोल

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

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

  2. वह एपीआई कुंजी चुनें जिस पर आपको पाबंदी लगाना है. इसके बाद, एपीआई कुंजी की प्रॉपर्टी वाला पेज दिखेगा.
  3. खास पाबंदियां में, ये पाबंदियां सेट करें:
    • ऐप्लिकेशन के लिए पाबंदियां:
      1. दिए गए वेब सर्वर आईपी पतों की सूची से अनुरोध स्वीकार करने के लिए, ऐप्लिकेशन पाबंदियों की सूची में से आईपी पते (वेब सर्वर, क्रॉन जॉब वगैरह) चुनें. सीआईडीआर नोटेशन का इस्तेमाल करके, IPv4 या IPv6 पता या सबनेट बताएं (उदाहरण के लिए, 192.168.0.0/22). वेब सर्विस अनुरोध, बाहरी आईपी पते की जांच करता है और उसकी तुलना एपीआई कुंजी की पाबंदी के साथ करता है. इसलिए, सर्वर के सार्वजनिक आईपी पते का इस्तेमाल करें.
    • एपीआई से जुड़ी पाबंदियां:
      1. कुंजी पर पाबंदी लगाएं पर क्लिक करें.
      2. एपीआई चुनें ड्रॉपडाउन से टाइम ज़ोन एपीआई चुनें. अगर समय क्षेत्र एपीआई सूची में नहीं है, तो आपको इसे चालू करना होगा.
  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="timezone-backend.googleapis.com"
    --allowed-ips="IP_ADDRESS"

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

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

आपको हर समय क्षेत्र एपीआई के अनुरोध के साथ एपीआई कुंजी को शामिल करना होगा. यहां दिए गए उदाहरण में, YOUR_API_KEY को अपनी एपीआई कुंजी से बदलें.

https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY

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