Google Maps Platform की सुरक्षा से जुड़े दिशा-निर्देश

Google Maps Platform के एपीआई और एसडीके इस्तेमाल करने वाले ऐप्लिकेशन और प्रोजेक्ट को अपनी पहचान की पुष्टि करने के लिए, एपीआई पासकोड या OAuth 2.0 का इस्तेमाल करना होगा. हालांकि, OAuth 2.0 का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब वह काम करता हो.

इन सबसे सही तरीकों से आपको पता चलता है कि Maps Platform के ऐक्सेस को कैसे सुरक्षित रखा जाए.

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

अहम जानकारी: अपने एपीआई पासकोड पर पाबंदी लगाएं, ताकि कोई और उनका इस्तेमाल न कर सके. बिना पाबंदी वाले एपीआई पासकोड के गलत इस्तेमाल की वजह से लगने वाले शुल्क के लिए, आप ज़िम्मेदार हैं.

ऐप्लिकेशन और एपीआई पासकोड पर पाबंदियां लगाने के अलावा, Google Maps Platform के कुछ प्रॉडक्ट पर लागू होने वाली सुरक्षा से जुड़ी सभी ज़रूरी बातों का पालन करें. उदाहरण के लिए, ऐप्लिकेशन और एपीआई से जुड़ी पाबंदियों के सुझाव में, Maps JavaScript API देखें.

अगर आपके एपीआई पासकोड पहले से इस्तेमाल में हैं, तो अगर इस्तेमाल में मौजूद एपीआई पासकोड पर पाबंदी लगाई जा रही है सेक्शन में जाकर, नीचे दिए गए सुझाव देखें.

Maps Static API और Street View Static API के साथ काम करने वाले डिजिटल सिग्नेचर के बारे में ज़्यादा जानने के लिए, डिजिटल सिग्नेचर से जुड़ी गाइड देखें.

सबसे सही तरीके

ज़्यादा सुरक्षा के लिए और बिना अनुमति के इस्तेमाल के लिए बिल भेजे जाने से बचने के लिए, Google Maps Platform के सभी एपीआई, एसडीके या सेवाओं के लिए, एपीआई की सुरक्षा के इन सबसे सही तरीकों को अपनाएं:

एपीआई पासकोड के सभी इस्तेमाल के लिए सुझाया गया

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

हर ऐप्लिकेशन के लिए अलग-अलग एपीआई पासकोड इस्तेमाल करना

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

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

एपीआई पासकोड रोटेट करते समय सावधानी बरतें

क्लाइंट-साइड और सर्वर-साइड के इस्तेमाल को अलग-अलग प्रोजेक्ट में बांटना

इस्तेमाल न की जाने वाली सेवाएं बंद करना

क्लाइंट-साइड ऐप्लिकेशन के लिए अन्य सुझाव

क्लाइंट-साइड एसडीके इस्तेमाल करना

क्लाइंट-साइड वेब सर्विस कॉल को सुरक्षित करना

स्टैटिक वेब एपीआई का इस्तेमाल करने वाली वेबसाइटों या क्लाइंट-साइड ऐप्लिकेशन के लिए अन्य सुझाव

Static Web API के इस्तेमाल को सुरक्षित करना

वेब सेवाओं का इस्तेमाल करने वाले सर्वर-साइड ऐप्लिकेशन के लिए अन्य सुझाव

वेब सेवा के एपीआई पासकोड सुरक्षित रखना

सर्वर-साइड ऐप्लिकेशन के लिए OAuth का इस्तेमाल करना

अगर इस्तेमाल में मौजूद किसी एपीआई पासकोड पर पाबंदी लगाई जा रही है या उसे बदला जा रहा है, तो

• एपीआई पासकोड बदलने से पहले, एपीआई पासकोड के इस्तेमाल की जांच करें यह चरण खास तौर पर तब ज़रूरी होता है, जब किसी ऐसे पासकोड पर पाबंदियां जोड़ी जा रही हों जो पहले से ही किसी प्रोडक्शन ऐप्लिकेशन में इस्तेमाल किया जा रहा हो.

• पासकोड बदलने के बाद, ज़रूरत के हिसाब से अपने सभी ऐप्लिकेशन को नए एपीआई पासकोड के साथ अपडेट करें.

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

  ज़्यादा निर्देशों के लिए, एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना लेख पढ़ें.

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

• अगर आपके एपीआई पासकोड से छेड़छाड़ की गई है, तो आपको अपने एपीआई पासकोड को सुरक्षित करने और उसका गलत इस्तेमाल रोकने के लिए, जल्द से जल्द कार्रवाई करनी होगी. Android और iOS ऐप्लिकेशन में, कुंजियां तब तक नहीं बदली जातीं, जब तक ग्राहक अपने ऐप्लिकेशन अपडेट नहीं करते. वेबपेजों या सर्वर-साइड ऐप्लिकेशन में कुंजियों को अपडेट करना या बदलना बहुत आसान है. हालांकि, इसके लिए अब भी सावधानी से योजना बनाने और तेज़ी से काम करने की ज़रूरत पड़ सकती है.

  ज़्यादा जानकारी के लिए, एपीआई पासकोड के बिना अनुमति के इस्तेमाल को मैनेज करना लेख पढ़ें.

ज़्यादा जानकारी

ऐप्लिकेशन और एपीआई से जुड़ी पाबंदियों के लिए सुझाव

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

अहम जानकारी: अगर आपको पहले से इस्तेमाल किए जा रहे एपीआई पासकोड पर पाबंदी लगानी है, तो अगर आपको पहले से इस्तेमाल किए जा रहे एपीआई पासकोड पर पाबंदी लगानी है या उसे बदलना है सेक्शन भी देखें.

सबसे सही तरीका यह है कि आप अपने एपीआई पासकोड को हमेशा एक तरह के ऐप्लिकेशन से जुड़ी पाबंदियों और एक या उससे ज़्यादा एपीआई से जुड़ी पाबंदियों के साथ सीमित करें. एपीआई, एसडीके या JavaScript सेवा के लिए सुझाई गई पाबंदियों के बारे में जानने के लिए, नीचे दिए गए ऐप्लिकेशन और एपीआई के लिए सुझाई गई पाबंदियां देखें.

• ऐप्लिकेशन से जुड़ी पाबंदियां एपीआई पासकोड के इस्तेमाल को कुछ प्लैटफ़ॉर्म तक सीमित किया जा सकता है: Android या iOS ऐप्लिकेशन या क्लाइंट-साइड ऐप्लिकेशन के लिए कुछ वेबसाइटें या वेब सेवा REST API कॉल जारी करने वाले सर्वर-साइड ऐप्लिकेशन के लिए कुछ आईपी पते या सीआईडीआर सबनेट.

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

  ध्यान दें: अगर किसी एपीआई पासकोड पर ऐप्लिकेशन से जुड़ी पाबंदी लगाई जाती है, तो उसे अन्य प्लैटफ़ॉर्म पर इस्तेमाल नहीं किया जा सकता. उदाहरण के लिए, अगर आपने एपीआई पासकोड को सिर्फ़ Android ऐप्लिकेशन के लिए सीमित किया है, तो इसका इस्तेमाल iOS, वेब सेवाओं या JavaScript एपीआई के साथ नहीं किया जा सकता.

• एपीआई से जुड़ी पाबंदियां: आपके पास यह तय करने का विकल्प होता है कि आपके एपीआई पासकोड का इस्तेमाल, Google Maps Platform के किन एपीआई, एसडीके या सेवाओं के लिए किया जा सकता है. एपीआई से जुड़ी पाबंदियां, सिर्फ़ आपके चुने गए एपीआई और एसडीके के लिए अनुरोधों की अनुमति देती हैं. किसी भी एपीआई पासकोड के लिए, ज़रूरत के मुताबिक एपीआई से जुड़ी पाबंदियां तय की जा सकती हैं. उपलब्ध एपीआई की सूची में, किसी प्रोजेक्ट पर चालू किए गए सभी एपीआई शामिल होते हैं.

  अहम जानकारी: पक्का करें कि जिन एपीआई या एसडीके के लिए एपीआई पासकोड को प्रतिबंधित किया जा रहा है वे ऐप्लिकेशन पर लगाई गई पाबंदियों के टाइप के साथ काम करते हों. उदाहरण के लिए, अगर आपने पासकोड को iOS से जुड़ी पाबंदी के साथ कॉन्फ़िगर किया है, तो पक्का करें कि जिस एपीआई के साथ आपको पासकोड का इस्तेमाल करना है वह iOS पर उपलब्ध हो.

किसी एपीआई पासकोड के लिए, ऐप्लिकेशन से जुड़ी पाबंदी सेट करना

1. Google Cloud console में Google Maps Platform के क्रेडेंशियल पेज खोलें.

2. वह एपीआई पासकोड चुनें जिस पर आपको पाबंदी लगानी है.

3. एपीआई पासकोड में बदलाव करें पेज पर, पासकोड से जुड़ी पाबंदियां में जाकर, ऐप्लिकेशन से जुड़ी पाबंदी सेट करें को चुनें.

   

4. पाबंदी का कोई टाइप चुनें और पाबंदी की सूची के मुताबिक मांगी गई जानकारी दें.

   पाबंदी का टाइप	ब्यौरा
   वेबसाइटें	रेफ़रर के तौर पर एक या उससे ज़्यादा वेबसाइटें डालें. दुनिया भर में इस्तेमाल की जाने वाली रेफ़रर यूआरआई स्कीम, https और http हैं. इस बात की कोई गारंटी नहीं है कि अन्य स्कीम सही तरीके से काम करेंगी. इसकी वजह यह है कि निजता से जुड़ी वजहों से, आधुनिक वेब ब्राउज़र आउटगोइंग अनुरोधों में `Referer` हेडर नहीं भेजेंगे. हमेशा पूरी रेफ़रर स्ट्रिंग दें. इसमें प्रोटोकॉल स्कीम, होस्टनेम, और वैकल्पिक पोर्ट (जैसे, https://google.com) शामिल करें. सभी सबडोमेन को अनुमति देने के लिए, वाइल्डकार्ड वर्णों का इस्तेमाल किया जा सकता है. उदाहरण के लिए, https://*.google.com उन सभी साइटों को स्वीकार करता है जिनके आखिर में .google.com होता है. पूरे पाथ वाले रेफ़रर को अनुमति देते समय सावधानी बरतें. उदाहरण के लिए, https://google.com/some/path. ऐसा इसलिए, क्योंकि ज़्यादातर वेब ब्राउज़र, निजता की वजहों से क्रॉस-ऑरिजिन अनुरोधों से पाथ को हटा देंगे.
   आईपी पते	सीआईडीआर नोटेशन का इस्तेमाल करके, एक या उससे ज़्यादा IPv4 या IPv6 पते या सबनेट डालें. आईपी पते, उस सोर्स पते से मेल खाने चाहिए जो Google Maps Platform के सर्वर को दिखता है. नेटवर्क अड्रेस ट्रांसलेशन (एनएटी) का इस्तेमाल करने पर, यह पता आम तौर पर आपकी मशीन के सार्वजनिक आईपी पते से मेल खाता है.
   Android ऐप्लिकेशन	आपको जिस Android ऐप्लिकेशन को अनुमति देनी है उसके लिए, Android पैकेज का नाम (AndroidManifest.xml फ़ाइल से) और SHA-1 साइनिंग सर्टिफ़िकेट फ़िंगरप्रिंट जोड़ें. Android ऐप्लिकेशन को चुनें. + जोड़ें पर क्लिक करें. अपने पैकेज का नाम और SHA-1 सर्टिफ़िकेट फ़िंगरप्रिंट डालें. उदाहरण के लिए: com.example.android.mapexample BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75 सेव करें पर क्लिक करें. सर्टिफ़िकेट दो तरह के होते हैं: डीबग सर्टिफ़िकेट: इस तरह के सर्टिफ़िकेट का इस्तेमाल सिर्फ़ उन ऐप्लिकेशन के साथ करें जिन्हें टेस्ट किया जा रहा है. साथ ही, इसका इस्तेमाल नॉन-प्रोडक्शन कोड के साथ करें. ऐसे ऐप्लिकेशन को पब्लिश करने की कोशिश न करें जिस पर हस्ताक्षर करने के लिए डीबग सर्टिफ़िकेट का इस्तेमाल किया गया हो. जब डीबग के लिए बिल्ड चलाया जाता है, तो Android SDK के टूल इस सर्टिफ़िकेट को अपने-आप जनरेट करते हैं. रिलीज़ सर्टिफ़िकेट: इस सर्टिफ़िकेट का इस्तेमाल तब करें, जब आप अपने ऐप्लिकेशन को किसी ऐप स्टोर पर रिलीज़ करने के लिए तैयार हों. जब रिलीज़ के लिए तैयार बिल्ड को चलाया जाता है, तब Android SDK के टूल यह सर्टिफ़िकेट जनरेट करते हैं. Android ऐप्लिकेशन साइनिंग और सर्टिफ़िकेट के बारे में ज़्यादा जानने के लिए, अपने ऐप्लिकेशन को साइन करने से जुड़ी गाइड देखें. अगर Play ऐप्लिकेशन साइनिंग का इस्तेमाल किया जाता है, तो साइनिंग सर्टिफ़िकेट का फ़िंगरप्रिंट फ़ेच करने के लिए, एपीआई की सेवा देने वाली कंपनियों के साथ काम करना लेख पढ़ें. अगर आपको साइनिंग पासकोड खुद मैनेज करना है, तो अपने ऐप्लिकेशन पर खुद हस्ताक्षर करना देखें या अपने बिल्ड एनवायरमेंट के लिए दिए गए निर्देश पढ़ें.
   iOS ऐप्लिकेशन	हर उस iOS ऐप्लिकेशन का बंडल आइडेंटिफ़ायर जोड़ें जिसे आपको अनुमति देनी है. iOS ऐप्लिकेशन चुनें. + जोड़ें पर क्लिक करें. बंडल आईडी जोड़ें, ताकि उस आईडी वाले iOS ऐप्लिकेशन से अनुरोध स्वीकार किए जा सकें. सेव करें पर क्लिक करें.

   ऐप्लिकेशन पर पाबंदी लगाने के सुझावों के लिए, ऐप्लिकेशन पर पाबंदी लगाने के लिए सुझाए गए तरीके देखें.

5. सेव करें को चुनें.

किसी एपीआई पासकोड के लिए, एपीआई से जुड़ी पाबंदियां सेट करना

1. Google Cloud console में Google Maps Platform के क्रेडेंशियल पेज खोलें.

2. वह एपीआई पासकोड चुनें जिस पर आपको पाबंदी लगानी है.

3. एपीआई पासकोड में बदलाव करें पेज पर, एपीआई से जुड़ी पाबंदियां में जाकर:

   • कुंजी पर पाबंदी लगाएं को चुनें.

   • एपीआई चुनें को खोलें. इसके बाद, वे एपीआई या एसडीके चुनें जिन्हें आपको एपीआई पासकोड का इस्तेमाल करके ऐक्सेस करना है.

   अगर कोई एपीआई या SDK टूल सूची में नहीं है, तो आपको उसे चालू करना होगा. ज़्यादा जानकारी के लिए, एक या उससे ज़्यादा एपीआई या एसडीके चालू करना लेख पढ़ें.

   

4. सेव करें को चुनें.

   इस चरण के बाद, पाबंदी एपीआई पासकोड की परिभाषा का हिस्सा बन जाती है. पक्का करें कि आपने सही जानकारी दी है. इसके बाद, एपीआई पासकोड से जुड़ी पाबंदियों को सेव करने के लिए, सेव करें को चुनें. ज़्यादा जानकारी के लिए, आपको जिस एपीआई या SDK टूल में दिलचस्पी है उसके दस्तावेज़ में, एपीआई पासकोड पाएं गाइड देखें.

एपीआई पर सुझाई गई पाबंदियों के बारे में जानने के लिए, एपीआई पर सुझाई गई पाबंदियां देखें.

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

अगर आपको एपीआई पासकोड बनाने के बाद उन पर पाबंदी लगानी है या यह देखना है कि किसी पासकोड का इस्तेमाल किन एपीआई के लिए किया जा रहा है, ताकि उन पर पाबंदी लगाई जा सके, तो आपको एपीआई पासकोड के इस्तेमाल की जानकारी देखनी होगी. इन चरणों से आपको पता चलता है कि एपीआई पासकोड का इस्तेमाल, किन सेवाओं और एपीआई के तरीकों में किया जा रहा है. अगर आपको Google Maps Platform की सेवाओं के अलावा, किसी और सेवा का इस्तेमाल दिखता है, तो जांच करके पता लगाएं कि क्या आपको अनचाहे इस्तेमाल से बचने के लिए, ज़्यादा पाबंदियां जोड़ने की ज़रूरत है. Google Maps Platform Cloud Console में मौजूद मेट्रिक एक्सप्लोरर का इस्तेमाल करके, यह तय किया जा सकता है कि आपके एपीआई पासकोड पर, एपीआई और ऐप्लिकेशन से जुड़ी कौनसी पाबंदियां लागू करनी हैं:

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

• मेट्रिक एक्सप्लोरर का इस्तेमाल करके, ऐप्लिकेशन पर पाबंदी लगाने का सही टाइप चुनना

सलाह: अगर मेट्रिक एक्सप्लोरर खोलने पर आपको सभी चार्ट लेबल नहीं दिखते हैं, तो Google Maps Platform Cloud Console के मेट्रिक एक्सप्लोरर की मदद से जुड़े ये विषय देखें: चार्ट के पूरे लेजेंड को टॉगल करना और सभी लेजेंड कॉलम दिखाना.

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

यहां दी गई मेट्रिक रिपोर्ट से यह पता लगाया जा सकता है कि कौनसे एपीआई आपके एपीआई पासकोड इस्तेमाल कर रहे हैं. इन रिपोर्ट का इस्तेमाल करके, ये काम किए जा सकते हैं:

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

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

1. Google Cloud Console के मेट्रिक एक्सप्लोरर पर जाएं

2. साइन इन करें और उस प्रोजेक्ट को चुनें जिसके एपीआई पासकोड आपको देखने हैं.

3. अपने एपीआई के टाइप के हिसाब से, मेट्रिक एक्सप्लोरर पेज पर जाएं:

   • Maps Embed API को छोड़कर, किसी भी एपीआई का इस्तेमाल करने वाले एपीआई पासकोड के लिए: मेट्रिक एक्सप्लोरर पेज पर जाएं.

   • Maps Embed API का इस्तेमाल करने वाले एपीआई पासकोड के लिए: मेट्रिक एक्सप्लोरर पर जाएं.

4. हर एपीआई पासकोड की जांच करें:

   1. फ़िल्टर जोड़ें को चुनें.

   2. लेबल credential_id को चुनें.

   3. आपको जिस कुंजी की जांच करनी है उसके हिसाब से वैल्यू चुनें.

   4. ध्यान दें कि इस एपीआई पासकोड का इस्तेमाल किन एपीआई के लिए किया जा रहा है. साथ ही, पुष्टि करें कि इसका इस्तेमाल सही तरीके से किया जा रहा है.

   5. इसके बाद, अतिरिक्त फ़िल्टर को मिटाने के लिए, चालू फ़िल्टर लाइन के आखिर में मौजूद, फ़िल्टर हटाएं को चुनें.

5. बाकी बचे बटन के लिए भी यही तरीका अपनाएं.

6. अपने एपीआई पासकोड को सिर्फ़ उन एपीआई तक सीमित करें जिनका इस्तेमाल किया जा रहा है.

7. अगर आपको लगता है कि एपीआई पासकोड का इस्तेमाल बिना अनुमति के किया जा रहा है, तो एपीआई पासकोड के बिना अनुमति के इस्तेमाल को मैनेज करना लेख पढ़ें.

मेट्रिक एक्सप्लोरर का इस्तेमाल करके, ऐप्लिकेशन पर पाबंदी लगाने का सही तरीका चुनें

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

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

अगर आपके एपीआई पासकोड के लिए, पाबंदी लगाने के सुझाव नहीं हैं, तो तय करें कि ऐप्लिकेशन पर किस तरह की पाबंदी लगानी है. इसके लिए, मेट्रिक एक्सप्लोरर का इस्तेमाल करके, रिपोर्ट किए गए platform_type के आधार पर तय करें:

1. Google Cloud console के मेट्रिक एक्सप्लोरर पर जाएं

2. साइन इन करें और उस एपीआई के लिए प्रोजेक्ट चुनें जिसकी आपको जांच करनी है.

3. इस मेट्रिक एक्सप्लोरर पेज पर जाएं: मेट्रिक एक्सप्लोरर.

4. हर एपीआई पासकोड की जांच करें:

   1. फ़िल्टर जोड़ें को चुनें.

   2. लेबल credential_id को चुनें.

   3. आपको जिस कुंजी की जांच करनी है उसके हिसाब से वैल्यू चुनें.

   4. इसके बाद, अतिरिक्त फ़िल्टर को मिटाने के लिए, चालू फ़िल्टर लाइन के आखिर में मौजूद, फ़िल्टर हटाएं को चुनें.

5. बाकी बचे बटन के लिए भी यही तरीका अपनाएं.

6. एपीआई पासकोड के लिए प्लैटफ़ॉर्म टाइप मिलने के बाद, उस platform_type के लिए ऐप्लिकेशन से जुड़ी पाबंदी लागू करें:

   PLATFORM_TYPE_JS : कुंजी पर वेबसाइट से जुड़ी पाबंदियां लागू करें.

   PLATFORM_TYPE_ANDROID : कुंजी पर Android ऐप्लिकेशन से जुड़ी पाबंदियां लागू करें.

   PLATFORM_TYPE_IOS : कुंजी पर iOS ऐप्लिकेशन से जुड़ी पाबंदियां लागू करें.

   PLATFORM_TYPE_WEBSERVICE : आपको कुंजी पर आईपी पते से जुड़ी पाबंदियों पर निर्भर रहना पड़ सकता है, ताकि उस पर सही तरीके से पाबंदी लगाई जा सके.

   Maps Static API और Street View Static API के लिए सुझाव पाने के लिए, स्टैटिक वेब एपीआई के इस्तेमाल को सुरक्षित करना लेख पढ़ें.

   Maps Embed API के सुझावों के लिए, Maps Embed API का इस्तेमाल करने वाली वेबसाइटें देखें.

   मेरे एपीआई पासकोड का इस्तेमाल कई प्लैटफ़ॉर्म टाइप के लिए किया जा रहा है: सिर्फ़ एक एपीआई पासकोड से, आपके ट्रैफ़िक को ठीक से सुरक्षित नहीं किया जा सकता. आपको एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना होगा. ज़्यादा जानकारी के लिए, एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना लेख पढ़ें.

हर ऐप्लिकेशन के लिए अलग-अलग एपीआई पासकोड इस्तेमाल करें

इस तरीके से, हर कुंजी का दायरा सीमित हो जाता है. अगर किसी एपीआई पासकोड के साथ छेड़छाड़ की जाती है, तो आपके पास उस पासकोड को मिटाने या बदलने का विकल्प होता है. इसके लिए, आपको अपने अन्य एपीआई पासकोड अपडेट करने की ज़रूरत नहीं होती. हर प्रोजेक्ट के लिए, ज़्यादा से ज़्यादा 300 एपीआई पासकोड बनाए जा सकते हैं. ज़्यादा जानकारी के लिए, एपीआई पासकोड की सीमाएं लेख पढ़ें.

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

एपीआई पासकोड पर सुझाई गई पाबंदियां लागू करना

अहम जानकारी: एपीआई पासकोड पर अपने-आप लगने वाली पाबंदी के सुझावों के बारे में अहम अपडेट पाने के लिए, सार्वजनिक समस्या 286524779 को स्टार का निशान दें.

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

चेतावनी: अगर Google Maps Platform के अलावा, अन्य सेवाओं (जैसे, Cloud) पर भी एपीआई पासकोड का इस्तेमाल किया जाता है, तो आपको मैन्युअल तरीके से पूरी समीक्षा करने के बाद ही पाबंदियां लागू करनी चाहिए.

अगर सुझाव उपलब्ध हैं, तो वे Google Maps Platform क्रेडेंशियल पेज पर, ऑटोमैटिक तरीके से भरे गए विकल्पों के तौर पर दिखते हैं.

अहम जानकारी: ऐसा हो सकता है कि सुझावों की सूची अधूरी हो. Google Cloud Console के निर्देशों का पालन करके, अपने एपीआई पासकोड के इस्तेमाल की दोबारा जांच करें. साथ ही, सुझावों को लागू करने से पहले, अपने एपीआई पासकोड के इस्तेमाल की जांच करें.

Google Maps Platform के ऐसे एपीआई और SDK टूल जिनके लिए, अपने-आप मिलने वाले सुझावों की सुविधा उपलब्ध है

• Maps JavaScript API, जिसमें ये शामिल हैं: निर्देश देने वाली सेवा (लेगसी), दूरी का मैट्रिक्स बताने वाली सेवा (लेगसी), एलिवेशन सेवा, जियोकोडिंग सेवा जगह की जानकारी देने वाली क्लास, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट (नया), किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला Data API, जगहों की लाइब्रेरी, जगहों की जानकारी देने वाली सेवा, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट, और जगहों की जानकारी देने वाली यूआई किट

• Maps Static API और Street View Static API

• Maps एंबेड एपीआई

• Android के लिए Maps SDK, Android के लिए Navigation SDK, Android के लिए Places SDK, और Android पर जगहों की जानकारी देने वाली यूआई किट

• iOS के लिए Maps SDK, iOS के लिए Navigation SDK, iOS के लिए Places SDK, iOS के लिए Places Swift SDK, और iOS पर जगहों की जानकारी देने वाली यूआई किट.

आपको कोई सुझाव या अधूरा सुझाव न दिखने की वजहें

कोई सुझाव न दिखने की वजहें

• एपीआई पासकोड का इस्तेमाल, Google Maps Platform की सेवाओं के अलावा अन्य सेवाओं के लिए किया जा रहा है. इसके अलावा, Maps Platform की ऐसी सेवाओं के लिए किया जा रहा है जिनके लिए, अपने-आप मिलने वाले सुझावों की सुविधा अभी उपलब्ध नहीं है.

  अगर आपको अन्य सेवाओं पर इस्तेमाल दिखता है, तो सबसे पहले ये काम करें. इसके बिना, सुझाव लागू न करें:

  1. पुष्टि करें कि Google Cloud Console के मेट्रिक एक्सप्लोरर में दिखने वाला एपीआई का इस्तेमाल सही है.

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

  3. एपीआई की सूची में जोड़ी गई सेवाओं के लिए, ऐप्लिकेशन से जुड़ी पाबंदियों को मैन्युअल तरीके से जोड़ें. अगर आपके जोड़े गए अन्य एपीआई के लिए, ऐप्लिकेशन पर अलग-अलग तरह की पाबंदियां लगानी हैं, तो एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करें लेख पढ़ें.

• आपके एपीआई पासकोड का इस्तेमाल, क्लाइंट-साइड एसडीके या एपीआई में नहीं किया जाता है.

• एपीआई पासकोड का इस्तेमाल, कम ट्रैफ़िक वाले ऐसे ऐप्लिकेशन या वेबसाइट में किया जाता है जिसका इस्तेमाल पिछले 60 दिनों में नहीं किया गया है.

• आपने हाल ही में कोई नई कुंजी बनाई है या किसी नए ऐप्लिकेशन में कोई मौजूदा कुंजी डिप्लॉय की है. अगर ऐसा है, तो सुझावों के अपडेट होने के लिए कुछ और दिन इंतज़ार करें.

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

अधूरा सुझाव दिखने की वजहें

• एपीआई पासकोड का इस्तेमाल, कम वॉल्यूम वाले ऐसे ऐप्लिकेशन या वेबसाइट में किया जाता है जिसका इस्तेमाल पिछले 60 दिनों में नहीं किया गया है.

• आपने हाल ही में किसी नए एपीआई या सेवा पर, मौजूदा पासकोड का इस्तेमाल करना शुरू किया है. साथ ही, एपीआई पासकोड पर अपने-आप पाबंदी लगाने की सुविधा ने, इस्तेमाल से जुड़ी अपडेट की गई मेट्रिक को अब तक प्रोसेस नहीं किया है. इस्तेमाल की मेट्रिक को अपडेट होने में कुछ दिन लग सकते हैं.

  अगर आपको अन्य सेवाओं पर इस्तेमाल दिखता है, तो सबसे पहले ये काम करें. इसके बिना, सुझाव लागू न करें:

  1. पुष्टि करें कि Google Cloud Console के मेट्रिक एक्सप्लोरर में दिखने वाला एपीआई का इस्तेमाल सही है.

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

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

  4. अगर आपको किसी कुंजी पर तुरंत पाबंदी लगाने की ज़रूरत नहीं है, तो सुझावों के लागू होने के लिए एक या दो दिन इंतज़ार किया जा सकता है. उदाहरण के लिए, बिना अनुमति के इस्तेमाल की वजह से.

     सलाह: आपातकालीन स्थिति में, एपीआई पासकोड के बिना अनुमति के इस्तेमाल को मैनेज करना देखें.

चार्ट में नहीं दिखने वाले सुझावों को देखने की वजहें

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

• आपका ट्रैफ़िक, Maps Embed API से आ रहा है. निर्देशों के लिए, यह तय करना कि आपके एपीआई पासकोड का इस्तेमाल कौनसे एपीआई करते हैं लेख पढ़ें.

• ऐप्लिकेशन या वेबसाइट से मिलने वाला ट्रैफ़िक, Google Cloud Console के मेट्रिक एक्सप्लोरर में उपलब्ध तारीख की सीमा से बाहर है.

सुझाई गई पाबंदियां लागू करने के लिए

1. Google Cloud console में Google Maps Platform के क्रेडेंशियल पेज खोलें.

2. अगर उपलब्ध हो, तो सुझाई गई पाबंदियां लागू करें को चुनें.

   

   ध्यान दें: अगर आपको सुझाई गई कोई पाबंदी नहीं दिखती है, तो सही पाबंदियां सेट करने के लिए, एपीआई पासकोड के लिए एपीआई से जुड़ी पाबंदियां सेट करना लेख पढ़ें.

3. एपीआई के इस्तेमाल की जांच करें को चुनें. इससे यह पुष्टि की जा सकेगी कि एपीआई पासकोड का इस्तेमाल किन सेवाओं के लिए किया जा रहा है. अगर आपको Google Maps Platform की सेवाओं के अलावा अन्य सेवाएं दिखती हैं, तो ऊपर दिए गए सुझावों को मैन्युअल तरीके से देखने के लिए, रोकें. समस्या हल करने का तरीका जानने के लिए, एपीआई पासकोड पर सुझाई गई पाबंदियां लागू करें सेक्शन की शुरुआत में जाएं.

4. यह दोबारा जांच लें कि पहले से भरी गई पाबंदियां, उन वेबसाइटों और ऐप्लिकेशन से मेल खाती हों जहां आपको एपीआई पासकोड का इस्तेमाल करना है.

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

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

   • अगर आपको सुझाए गए सुझाव के बारे में ज़्यादा मदद चाहिए, तो सहायता टीम से संपर्क करें.

5. लागू करें चुनें.

अगर कोई सुझाव लागू करने के बाद आपका आवेदन अस्वीकार हो जाता है, तो क्या करें

अगर आपको लगता है कि कोई पाबंदी लगाने के बाद, किसी ऐप्लिकेशन या वेबसाइट को अस्वीकार कर दिया गया है, तो एपीआई से मिली जानकारी में गड़बड़ी के मैसेज में जाकर, ऐप्लिकेशन पर लगाई गई पाबंदी देखें.

क्लाइंट-साइड एसडीके और एपीआई

ब्राउज़र और वेबव्यू पर आधारित ऐप्लिकेशन

चेतावनी: रेफ़रर की यूआरआई स्कीम (जैसे, एचटीटीपीएस या एचटीटीपी नहीं) नहीं काम करती हैं. इसलिए, अगर हो सके, तो इनका इस्तेमाल करने से बचें. जब तक अलग से न बताया जाए, तब तक यह उम्मीद न करें कि Google Maps Platform की सेवा या एपीआई, एचटीटीपीएस या एचटीटीपी के अलावा, रेफ़रर यूआरआई की अन्य स्कीम के साथ काम करेंगे.

निजता की वजहों से, मॉडर्न ब्राउज़र आम तौर पर क्रॉस-ऑरिजिन अनुरोध में Referer हेडर को छिपा देते हैं. अक्सर, वे इसे Origin तक ही सीमित कर देते हैं. हालांकि, सटीक व्यवहार, होस्टिंग साइट के लागू किए गए referrer-policy पर निर्भर करता है. साथ ही, यह उपयोगकर्ता के ब्राउज़र और वर्शन के आधार पर भी अलग-अलग हो सकता है.

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

ज़्यादा जानकारी के लिए, ब्राउज़र पर आधारित ऐप्लिकेशन को सर्वर पर होस्ट करना लेख पढ़ें.

ब्राउज़र और वेबव्यू पर आधारित ऐप्लिकेशन के लिए, समस्या हल करने के निर्देश:

• Maps JavaScript API के लिए, ब्राउज़र डीबग कंसोल देखें. इसमें आपको अपने ऐप्लिकेशन को अनुमति देने के तरीके के बारे में जानकारी मिलेगी.

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

  अगर आपको यूआरआई स्कीम के बारे में मदद चाहिए, तो सहायता टीम से संपर्क करें.

• Maps Platform के अन्य एपीआई, आम तौर पर एपीआई से जुड़ी गड़बड़ी के जवाब में वह रेफ़रल दिखाते हैं जिसकी अनुमति आपको देनी होती है. ऐसा तब होता है, जब क्लाइंट ने अस्वीकार किए गए अनुरोध के साथ यह जानकारी भेजी हो.

  यूआरआई की ऐसी स्कीम जो आम तौर पर इस्तेमाल नहीं की जाती हैं, वे काम नहीं करतीं.

Android ऐप्लिकेशन

Android डीबग ब्रिज (adb) या Logcat का इस्तेमाल करें

iOS ऐप्लिकेशन

लॉग मैसेज देखना देखें

वेब सेवाओं को सीधे कॉल करने वाले ऐप्लिकेशन

अगर कोई ऐप्लिकेशन, क्लाइंट-साइड Google Maps Platform SDK का इस्तेमाल किए बिना, Maps Platform के एचटीटीपीएस REST API या gRPC एंडपॉइंट को सीधे कॉल करता है, तो यहां देखें:

Android और iOS ऐप्लिकेशन

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

अगर आपका ऐप्लिकेशन, Maps Platform API से जुड़ी गड़बड़ियों को लॉग करता है, तो क्लाइंट-साइड एसडीके के लिए ऊपर दिए गए निर्देश, पुष्टि से जुड़ी समस्याओं को हल करने में भी मददगार साबित हो सकते हैं.

सर्वर-साइड ऐप्लिकेशन

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

ब्राउज़र या वेबव्यू पर आधारित ऐप्लिकेशन

Maps Static API और Street View Static API जैसे Google Maps Platform के नए एपीआई, रेफ़रर से जुड़ी पाबंदियों के साथ काम करेंगे. हालांकि, ध्यान दें कि वेब ब्राउज़र या वेबव्यू, क्रॉस-ऑरिजिन अनुरोधों के लिए Referer हेडर को Origin तक सीमित कर सकते हैं. साथ ही, वे इसे पूरी तरह से हटा सकते हैं. उदाहरण के लिए, स्थानीय तौर पर ऐक्सेस किए गए संसाधनों या एचटीटीपी या एचटीटीपीएस के अलावा अन्य प्रोटोकॉल पर उपलब्ध कराए गए संसाधनों के लिए.

अगर आपके ऐप्लिकेशन में Maps JavaScript API का इस्तेमाल नहीं किया जा सकता और वेबसाइट से जुड़ी पाबंदियां काम नहीं करती हैं, तो क्लाइंट-साइड वेब सर्विस कॉल को सुरक्षित करना लेख पढ़ें. इसमें, ब्राउज़र पर आधारित क्लाइंट-साइड ऐप्लिकेशन से, Maps Platform की वेब सर्विस कॉल को सुरक्षित तरीके से जारी करने का तरीका बताया गया है.

एपीआई से जुड़ी पाबंदियों की जांच करने के लिए सलाह

एपीआई पर लागू होने वाली पाबंदियों के बारे में जानने के लिए, आपके एपीआई पासकोड का इस्तेमाल करने वाले एपीआई के बारे में जानकारी देखें.

अगर आपको यह तय करने में समस्या आ रही है कि कौनसी पाबंदियां लागू करनी हैं, तो:

1. आने वाले समय में रेफ़रंस के तौर पर इस्तेमाल करने के लिए, मौजूदा पाबंदियों को दस्तावेज़ में दर्ज करें.
2. समस्या की जांच करते समय, उन्हें कुछ समय के लिए हटा दें. एपीआई पासकोड के इस्तेमाल की जानकारी देखना में दिए गए चरणों का इस्तेमाल करके, समय के साथ अपने इस्तेमाल की जानकारी देखी जा सकती है.
3. अगर ज़रूरत हो, तो सहायता टीम से संपर्क करें.

इस्तेमाल नहीं किए गए एपीआई पासकोड मिटाना

अहम जानकारी: एपीआई पासकोड को मिटाने से पहले, देखें कि उसका इस्तेमाल कहां किया जा रहा है.

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

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

1. Google Cloud console में Google Maps Platform के क्रेडेंशियल पेज खोलें.

2. वह एपीआई पासकोड चुनें जिसे मिटाना है.

3. पेज पर सबसे ऊपर मौजूद, मिटाएं बटन को चुनें.

4. क्रेडेंशियल मिटाएं पेज पर, मिटाएं को चुनें.

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

अहम जानकारी: अगर आपने ऐसी कुंजी मिटा दी है जिसका इस्तेमाल अब भी प्रोडक्शन में किया जा रहा है और आपको उसे वापस लाना है, तो एपीआई कुंजी को वापस लाना लेख पढ़ें.

एपीआई पासकोड रोटेट करते समय सावधानी बरतें

अहम जानकारी: एपीआई पासकोड को रोटेट करने से पहले, एपीआई पासकोड के इस्तेमाल की जानकारी देखें.

एपीआई पासकोड को रोटेट करने पर, एक नया पासकोड बनता है. इसमें पुराने पासकोड की सभी पाबंदियां लागू होती हैं. इस दौरान, पुरानी और नई, दोनों कुंजियां स्वीकार की जाती हैं. इससे आपको अपने ऐप्लिकेशन को नई कुंजी का इस्तेमाल करने के लिए माइग्रेट करने का मौका मिलता है.

एपीआई पासकोड को रोटेट करने से पहले:

• सबसे पहले, एपीआई पासकोड पर पाबंदी लगाना लेख में बताए गए तरीके से, अपने एपीआई पासकोड पर पाबंदी लगाने की कोशिश करें.

• अगर ऐप्लिकेशन पर लगाई गई पाबंदियों के टाइप में अंतर होने की वजह से, एपीआई पासकोड पर पाबंदी लगाना मुमकिन नहीं है, तो एक से ज़्यादा नए (पाबंदी वाले) पासकोड पर माइग्रेट करें. इसके बारे में एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करें लेख में बताया गया है. माइग्रेट करने से, आपको माइग्रेशन को कंट्रोल करने और नई एपीआई पासकोड को रोल आउट करने की टाइमलाइन तय करने की सुविधा मिलती है.

अगर ऊपर दिए गए सुझावों को लागू करना मुमकिन नहीं है और आपको बिना अनुमति के इस्तेमाल को रोकने के लिए, एपीआई पासकोड को रोटेट करना है, तो यह तरीका अपनाएं:

1. Google Cloud console में Google Maps Platform के क्रेडेंशियल पेज खोलें.

2. वह एपीआई पासकोड खोलें जिसे आपको रोटेट करना है.

3. पेज पर सबसे ऊपर, कुंजी को रोटेट करें को चुनें.

4. अगर आप चाहें, तो एपीआई पासकोड का नाम बदलें.

5. बनाएं को चुनें.

6. नए पासकोड का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन अपडेट करें.

अपने ऐप्लिकेशन को नई कुंजी का इस्तेमाल करने के लिए अपडेट करने के बाद, पुरानी कुंजी को मिटा दें. इसके लिए, नए एपीआई पासकोड पेज के 'पिछली कुंजी' सेक्शन में जाकर, पिछली कुंजी मिटाएं बटन पर क्लिक करें.

अहम जानकारी: अपने पुराने पासकोड को मिटाने से पहले, एपीआई पासकोड के इस्तेमाल की जांच करें, ताकि यह पुष्टि की जा सके कि आपने अपने सभी ऐप्लिकेशन माइग्रेट कर लिए हैं.

एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना

अगर आपको कई ऐप्लिकेशन के लिए एक ही एपीआई पासकोड इस्तेमाल करने के बजाय, हर ऐप्लिकेशन के लिए एक यूनीक एपीआई पासकोड इस्तेमाल करना है, तो यह तरीका अपनाएं:

1. यह पता लगाना कि किन ऐप्लिकेशन को नई कुंजियों की ज़रूरत है:

   • वेब ऐप्लिकेशन को अपडेट करना सबसे आसान होता है, क्योंकि आपके पास सभी कोड का कंट्रोल होता है. अपने सभी वेब पर आधारित ऐप्लिकेशन की कुंजियों को अपडेट करने का प्लान बनाएं.
   • मोबाइल ऐप्लिकेशन के लिए ऐसा करना ज़्यादा मुश्किल होता है, क्योंकि नई कुंजियों का इस्तेमाल करने से पहले, आपके ग्राहकों को अपने ऐप्लिकेशन अपडेट करने होंगे.

2. नई कुंजियां बनाएं और उन पर पाबंदी लगाएं: ऐप्लिकेशन पर पाबंदी और कम से कम एक एपीआई पर पाबंदी, दोनों जोड़ें. ज़्यादा जानकारी के लिए, सुझाए गए सबसे सही तरीके देखें.

3. अपने ऐप्लिकेशन में नए पासकोड जोड़ना: मोबाइल ऐप्लिकेशन के लिए, इस प्रोसेस में कुछ महीने लग सकते हैं. ऐसा तब तक हो सकता है, जब तक आपके सभी उपयोगकर्ता नए एपीआई पासकोड वाले नए ऐप्लिकेशन पर अपडेट नहीं कर लेते.

अहम जानकारी: एपीआई पासकोड बनाने और इस्तेमाल करने के बाद, उन्हें सुरक्षित किया जा सकता है. हालांकि, मोबाइल ऐप्लिकेशन (Android और iOS) में, पासकोड तब तक नहीं बदले जाते, जब तक ग्राहक अपने ऐप्लिकेशन अपडेट नहीं करते. JavaScript या वेब सेवा ऐप्लिकेशन में कुंजियों को अपडेट करना या बदलना ज़्यादा आसान है. हालांकि, इसके लिए भी सावधानी से योजना बनाने और तेज़ी से काम करने की ज़रूरत पड़ सकती है. ज़्यादा जानकारी के लिए, इस्तेमाल किए जा रहे एपीआई पासकोड पर पाबंदी लगाने या उसे फिर से जनरेट करने के बारे में जानकारी देखें.

क्लाइंट-साइड और सर्वर-साइड के इस्तेमाल को अलग-अलग प्रोजेक्ट में बांटना

अगर आपको सर्वर-साइड ऐप्लिकेशन और असली उपयोगकर्ता के डिवाइसों पर चल रहे क्लाइंट-साइड ऐप्लिकेशन, दोनों से Google Maps Platform की सेवाओं को कॉल करना है, तो Google का सुझाव है कि आप अपने इस्तेमाल को दो अलग-अलग प्रोजेक्ट में बांट लें.

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

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

इस्तेमाल नहीं की जा रही सेवाओं को बंद करना

किसी प्रोजेक्ट पर ऐसी सेवाओं को चालू न रखें जिनका इस्तेमाल नहीं किया जा रहा है. ऐसा करने से, आपके प्रोजेक्ट का गलत इस्तेमाल हो सकता है. खास तौर पर तब, जब आपने अपने सभी सार्वजनिक एपीआई पासकोड पर पाबंदी न लगाई हो. सबसे सही तरीका यह है कि किसी प्रोजेक्ट पर कोई सेवा सिर्फ़ तब चालू करें, जब आपके ऐप्लिकेशन को उसकी ज़रूरत हो.

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

क्लाइंट-साइड एसडीके टूल इस्तेमाल करना

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

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

अगर आपके प्लैटफ़ॉर्म के लिए क्लाइंट-साइड एसडीके उपलब्ध नहीं हैं, तो क्लाइंट-साइड वेब सेवा कॉल को सुरक्षित करें देखें.

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

Static Web API के इस्तेमाल को सुरक्षित रखना

अहम जानकारी: अगर स्टैटिक वेब एपीआई पासकोड को आपके वेब पेज पर सार्वजनिक तौर पर दिखाया जाता है, तो उस पर वेबसाइट और एपीआई, दोनों से जुड़ी पाबंदियां लागू करें. उदाहरण के लिए, स्टैटिक मैप या Street View पैनोरमा दिखाने के लिए इस्तेमाल किए जाने वाले एचटीएमएल <img> टैग के अंदर.

Maps Static API और Street View Static API जैसे स्टैटिक वेब एपीआई, वेब सेवा एपीआई कॉल की तरह ही होते हैं.

दोनों को एचटीटीपीएस REST API का इस्तेमाल करके कॉल किया जाता है. आम तौर पर, एपीआई अनुरोध का यूआरएल सर्वर पर जनरेट किया जाता है. हालांकि, स्टैटिक वेब एपीआई, JSON रिस्पॉन्स देने के बजाय एक इमेज जनरेट करते हैं. इसे जनरेट किए गए एचटीएमएल कोड में एम्बेड किया जा सकता है. इससे भी ज़्यादा ज़रूरी बात यह है कि आम तौर पर, Google Maps Platform की सेवा को सर्वर नहीं, बल्कि असली उपयोगकर्ता का क्लाइंट कॉल करता है.

अहम जानकारी: स्टैटिक वेब एपीआई को सुरक्षित रखने के बारे में ज़्यादा जानने के लिए, स्टैटिक मैप और Street View एपीआई का इस्तेमाल करते समय एपीआई पासकोड को सुरक्षित रखना ब्लॉग पोस्ट पढ़ें.

डिजिटल हस्ताक्षर का इस्तेमाल करना

सबसे सही तरीका यह है कि एपीआई पासकोड के साथ-साथ, हमेशा डिजिटल सिग्नेचर का इस्तेमाल करें. साथ ही, यह भी देखें कि आपको हर दिन बिना हस्ताक्षर वाले कितने अनुरोधों की अनुमति देनी है. इसके बाद, बिना हस्ताक्षर वाले अनुरोधों के कोटे में बदलाव करें.

डिजिटल सिग्नेचर के बारे में ज़्यादा जानने के लिए, डिजिटल सिग्नेचर गाइड देखें.

साइनिंग सीक्रेट को सुरक्षित रखना

अहम जानकारी: अपने अनुरोधों को हमेशा सर्वर-साइड पर साइन करें, न कि क्लाइंट-साइड पर. उदाहरण के लिए, अगर आपने JavaScript में क्लाइंट-साइड पर हस्ताक्षर किया है, तो आपकी साइट पर आने वाले सभी लोगों को यह दिखेगा.

Static Web API को सुरक्षित रखने के लिए, एपीआई साइनिंग सीक्रेट को सीधे कोड या सोर्स ट्री में एम्बेड न करें. इसके अलावा, उन्हें क्लाइंट-साइड ऐप्लिकेशन में भी न दिखाएं. साइनिंग सीक्रेट को सुरक्षित रखने के लिए, यहां दिए गए सबसे सही तरीके अपनाएं:

• वेब पेज दिखाते समय या अपने मोबाइल ऐप्लिकेशन से मिले अनुरोध के जवाब में, सर्वर-साइड पर साइन किए गए Maps Static API और Street View Static API के अनुरोध वाले यूआरएल जनरेट करें.

  स्टैटिक वेब कॉन्टेंट के लिए, Cloud Console के Google Maps Platform क्रेडेंशियल पेज पर, यूआरएल पर अभी हस्ताक्षर करें विजेट का इस्तेमाल किया जा सकता है.

  डाइनैमिक वेब कॉन्टेंट के लिए, यूआरएल अनुरोध पर हस्ताक्षर करने के लिए उपलब्ध कोड सैंपल देखें.

  सलाह: मोबाइल डेवलपर, हस्ताक्षर किए गए अनुरोध जनरेट करने के लिए, सुरक्षित प्रॉक्सी सर्वर का इस्तेमाल कर सकते हैं.

• साइनिंग सीक्रेट को अपने ऐप्लिकेशन के सोर्स कोड और सोर्स ट्री से बाहर सेव करें. अगर आपने साइनिंग सीक्रेट या कोई अन्य निजी जानकारी, एनवायरमेंट वैरिएबल में डाली है या अलग से सेव की गई फ़ाइलों को शामिल किया है और फिर अपना कोड शेयर किया है, तो शेयर की गई फ़ाइलों में साइनिंग सीक्रेट शामिल नहीं होते. अगर आपको फ़ाइलों में साइनिंग सीक्रेट या कोई अन्य निजी जानकारी सेव करनी है, तो फ़ाइलों को अपने ऐप्लिकेशन के सोर्स ट्री से बाहर रखें. इससे आपके साइनिंग सीक्रेट, सोर्स कोड कंट्रोल सिस्टम से बाहर रहेंगे. यह सावधानी बरतना तब और भी ज़रूरी हो जाता है, जब GitHub जैसे किसी सार्वजनिक सोर्स कोड मैनेजमेंट सिस्टम का इस्तेमाल किया जा रहा हो.

वेब सेवा के एपीआई पासकोड सुरक्षित रखना

चेतावनी: वेब सेवा के एपीआई पासकोड, बिना अनुमति वाले उपयोगकर्ताओं, भरोसेमंद नहीं माने जाने वाले ऐप्लिकेशन या डिवाइसों के लिए सार्वजनिक तौर पर उपलब्ध नहीं होने चाहिए! इन कुंजियों को डेवलपर के सर्वर और Google के बीच शेयर किया जाने वाला सीक्रेट कोड माना जाता है.

क्लाइंट-साइड ऐप्लिकेशन से Google Maps Platform के एपीआई और सेवाओं का सुरक्षित तरीके से इस्तेमाल करने के लिए, क्लाइंट-साइड एसडीके टूल इस्तेमाल करना और क्लाइंट-साइड वेब सेवा कॉल को सुरक्षित करना लेख पढ़ें.

एपीआई पासकोड को अपने ऐप्लिकेशन के सोर्स कोड या सोर्स ट्री से बाहर सेव करें. अगर आपने अपने एपीआई पासकोड या कोई अन्य जानकारी एनवायरमेंट वैरिएबल में डाली है या अलग से सेव की गई फ़ाइलों को शामिल करके अपना कोड शेयर किया है, तो शेयर की गई फ़ाइलों में एपीआई पासकोड शामिल नहीं होते. यह खास तौर पर तब ज़रूरी होता है, जब GitHub जैसे किसी सार्वजनिक सोर्स कोड मैनेजमेंट सिस्टम का इस्तेमाल किया जा रहा हो.

Google का सुझाव है कि Maps Platform के लिए इस्तेमाल किए जाने वाले किसी भी पासकोड पर, एपीआई से जुड़ी पाबंदियां लागू करें. इससे, वेब सेवा के एपीआई पासकोड को गलती से इस्तेमाल होने से बचाया जा सकता है. इसके अलावा, अपनी वेब सेवा की कुंजी पर आईपी पते से जुड़ी पाबंदियां लागू करने से, उसे अन्य सोर्स के आईपी पतों से बिना अनुमति के इस्तेमाल किए जाने से बचाने में मदद मिलेगी. भले ही, कुंजी गलती से लीक हो जाए.

सर्वर-साइड ऐप्लिकेशन के लिए OAuth का इस्तेमाल करना

OAuth 2.0, ऐक्सेस देने के लिए एक ओपन स्टैंडर्ड है.

चेतावनी: भले ही, Maps Platform API, OAuth के साथ काम करता हो, लेकिन क्लाइंट-साइड ऐप्लिकेशन में सेवा खाते की कुंजियों को कभी भी सार्वजनिक न करें. ऐसा इसलिए, क्योंकि इस ऐप्लिकेशन को ऐसे असली उपयोगकर्ता चला सकते हैं जिन पर भरोसा नहीं किया जा सकता या इसे ऐसे असली उपयोगकर्ता के डिवाइसों पर चलाया जा सकता है जिन पर भरोसा नहीं किया जा सकता.

OAuth 2.0 प्रोटोकॉल का इस्तेमाल ऐसे मामलों में किया जाता है जहां असली उपयोगकर्ता, किसी ऐप्लिकेशन को अपनी ओर से निजी डेटा ऐक्सेस करने की अनुमति देता है. हालांकि, Maps Platform के साथ OAuth 2.0 का इस्तेमाल करने का मकसद यह है कि डेवलपर, कुछ समय के लिए मान्य ऐक्सेस टोकन का इस्तेमाल करके, अपने ऐप्लिकेशन को अपने Google क्लाउड प्रोजेक्ट के सेवा खाते की ओर से एपीआई को कॉल करने की अनुमति दे सके. इसके लिए, सेवा खाते की अनुमतियों का इस्तेमाल किया जाता है.

सेवा खाते के पास कई तरह की अनुमतियां हो सकती हैं. इसलिए, डेवलपर के भरोसेमंद सर्वर-साइड ऐप्लिकेशन और Google Maps Platform के सर्वर के बीच सर्वर-टू-सर्वर कॉल को अनुमति देने के लिए, OAuth 2.0 का इस्तेमाल करने का सुझाव दिया जाता है.

असली उपयोगकर्ता के डिवाइसों पर चलने वाले क्लाइंट-साइड ऐप्लिकेशन के लिए, पुष्टि करने के अन्य तरीकों का सुझाव दिया जाता है. जैसे, एपीआई पासकोड.

अगर आपको सर्वर-टू-सर्वर ट्रैफ़िक को अनुमति देने के लिए OAuth 2.0 का इस्तेमाल करना है, तो अपने एपीआई दस्तावेज़ में OAuth विषय देखें.

उदाहरण के लिए, यहां Address Validation API के लिए OAuth से जुड़ा विषय दिया गया है.

क्लाइंट-साइड वेब सेवा कॉल को सुरक्षित करना

अहम जानकारी: अगर आपके प्लैटफ़ॉर्म पर Maps Platform की सेवा के लिए क्लाइंट-साइड एसडीके उपलब्ध है, तो उसका इस्तेमाल करें! क्लाइंट-साइड एसडीके इस्तेमाल करना लेख पढ़ें.

अगर क्लाइंट-साइड एसडीके उपलब्ध नहीं हैं, तो नीचे दिए गए सुझाव देखें.

प्रॉक्सी सर्वर का इस्तेमाल करना

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

सलाह: Maps Static API और Street View Static API के लिए, आपके सर्वर को सिर्फ़ हस्ताक्षर किया गया अनुरोध यूआरएल जनरेट करना होगा. अगर अनुरोध पर हस्ताक्षर करने का लॉजिक किसी प्रॉक्सी सर्वर में लागू किया गया है, तो वह नए हस्ताक्षर वाले अनुरोध यूआरएल का इस्तेमाल करके, क्लाइंट को एचटीटीपी रीडायरेक्ट जारी कर सकता है.
उदाहरण के लिए, इस तरीके का इस्तेमाल ऐसे मोबाइल ऐप्लिकेशन के साथ किया जा सकता है जो स्टैटिक वेब एपीआई का इस्तेमाल करता है.

अहम जानकारी:

• प्रॉक्सी सर्वर पर Google Maps Platform के अनुरोध बनाएं. क्लाइंट को प्रॉक्सी का इस्तेमाल करके, एपीआई कॉल को रिले करने की अनुमति न दें.

• अपने प्रॉक्सी सर्वर पर, Google Maps Platform के रिस्पॉन्स को पोस्ट-प्रोसेस करें. उस डेटा को फ़िल्टर करें जिसकी क्लाइंट को ज़रूरत नहीं है.

अहम जानकारी: प्रॉक्सी सर्वर को क्लाइंट ऐक्सेस देने के लिए, हमेशा पुष्टि करना ज़रूरी है.

प्रॉक्सी सर्वर का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Living Vicariously: Using Proxy Servers with the Google Data API Client Libraries देखें.

सुरक्षित डायरेक्ट मोबाइल वेब सर्विस कॉल

अहम जानकारी: क्लाइंट-साइड वेब सेवा कॉल के लिए, अलग एपीआई पासकोड का इस्तेमाल करें. साथ ही, इसे सुरक्षित कीस्टोर में सेव करें! इस चरण को पूरा करने से, ऐप्लिकेशन से सीधे तौर पर एपीआई पासकोड और अन्य निजी डेटा को स्क्रैप करना मुश्किल हो जाता है.

अगर आपको क्लाइंट-साइड ऐप्लिकेशन के लिए, सुरक्षित प्रॉक्सी सर्वर सेट अप करने में समस्या आ रही है, तो यहां दिया गया तरीका अपनाकर अपने ऐप्लिकेशन को सुरक्षित करें:

1. एचटीटीपी हेडर का इस्तेमाल करना:

   • Android: X-Android-Package और X-Android-Cert एचटीटीपी हेडर का इस्तेमाल करें.

   • iOS: X-Ios-Bundle-Identifier एचटीटीपी हेडर का इस्तेमाल करें.

2. अपने Android या iOS पासकोड में, ऐप्लिकेशन से जुड़ी पाबंदियां जोड़ें.

   अहम जानकारी: ऐसा हो सकता है कि Android और iOS ऐप्लिकेशन से जुड़ी पाबंदियां, Google Maps Platform की पुरानी सेवाओं पर पूरी तरह से काम न करें.

3. अपने मोबाइल ऐप्लिकेशन से सीधे Google Maps Platform REST API वेब सेवा को कॉल करने से पहले, पुष्टि करें कि Android या iOS ऐप्लिकेशन के गलत आइडेंटिफ़ायर वाले अनुरोध अस्वीकार कर दिए गए हैं.

   अगर जांच किए गए एंडपॉइंट पर Android और iOS ऐप्लिकेशन से जुड़ी पाबंदियां काम नहीं करती हैं, तो Google आपको ज़ोर देकर सुझाव देता है कि आप अपने मोबाइल क्लाइंट और Google Maps Platform की वेब सेवा के एंडपॉइंट के बीच, सुरक्षित प्रॉक्सी सर्वर का इस्तेमाल करें.

Android ऐप्लिकेशन के लिए सलाह:

• अपने Android ऐप्लिकेशन को Google Maps Platform की सेवाओं के साथ इंटिग्रेट करने से पहले, पुष्टि करें कि आपके ऐप्लिकेशन आईडी (इसे पैकेज का नाम भी कहा जाता है) का फ़ॉर्मैट सही है. ज़्यादा जानकारी के लिए, Android दस्तावेज़ में ऐप्लिकेशन मॉड्यूल कॉन्फ़िगर करना लेख पढ़ें.

• अपने ऐप्लिकेशन से सीधे X-Android-Package पास करने के लिए, Context.getPackageName() का इस्तेमाल करके, प्रोग्राम के हिसाब से इसे खोजें.

• अपने ऐप्लिकेशन से सीधे X-Android-Cert पास करने के लिए, अपने ऐप्लिकेशन साइनिंग सर्टिफ़िकेट के ज़रूरी SHA-1 फ़िंगरप्रिंट का हिसाब लगाएं. इसे PackageInfo.signingInfo से ऐक्सेस किया जा सकता है.

  अहम जानकारी: पक्का करें कि आपने साइनिंग सर्टिफ़िकेट का SHA-1 डाइजेस्ट पास किया हो. साथ ही, हेडर सेट करते समय, नतीजे के तौर पर मिले 20 बाइट के डाइजेस्ट को Base16 (हेक्साडेसिमल) कोड वाली स्ट्रिंग में बदलें. इसमें कोई डीलिमिटर या प्रीफ़िक्स नहीं होना चाहिए. उदाहरण के लिए, 00112233445566778899AABBCCDDEEFF00112233.

• अगर आपने Google Cloud Console का इस्तेमाल करके, अपने Android ऐप्लिकेशन को अनुमति दी है, तो ध्यान दें कि यूज़र इंटरफ़ेस (यूआई) के लिए, SHA-1 फ़िंगरप्रिंट को कोलन से अलग की गई स्ट्रिंग होना चाहिए. उदाहरण के लिए, 00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33. हालांकि, gcloud टूल और एपीआई पासकोड एपीआई को हेक्साडेसिमल स्ट्रिंग, डीलिमिटर के बिना चाहिए होती है.

iOS ऐप्लिकेशन के लिए सलाह:

• अपने iOS ऐप्लिकेशन को Google Maps Platform की सेवाओं के साथ इंटिग्रेट करने से पहले, पुष्टि करें कि आपका बंडल आईडी सही तरीके से फ़ॉर्मैट किया गया है.

• अपने iOS ऐप्लिकेशन को अनुमति देते समय, आपको आम तौर पर X-Ios-Bundle-Identifier हेडर में अपने मुख्य बंडल का बंडल आईडी हमेशा पास करना चाहिए.

ज़्यादा जानकारी के लिए, एपीआई पासकोड मैनेज करना और एपीआई ऐक्सेस करने के लिए एपीआई पासकोड इस्तेमाल करना लेख पढ़ें.

ब्राउज़र पर आधारित अपने ऐप्लिकेशन को किसी सर्वर पर होस्ट करना

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

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

इसके अलावा, मोबाइल ऐप्लिकेशन के लिए, वेब पर आधारित SDK टूल का इस्तेमाल करने के बजाय, Google Maps Platform के Android और iOS SDK टूल का इस्तेमाल करें.

अपने एपीआई पासकोड को सुरक्षित रखने के लिए, App Check का इस्तेमाल करना

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

App Check को इंटिग्रेट करने के निर्देश:

• Places SDK for iOS
• Places SDK for Android
• Maps JavaScript API
• Place क्लास, Maps JavaScript API

एपीआई पासकोड के बिना अनुमति के इस्तेमाल को मैनेज करना

अगर आपको पता चलता है कि आपकी एपीआई कुंजी का इस्तेमाल बिना अनुमति के किया जा रहा है, तो समस्या को हल करने के लिए यह तरीका अपनाएं:

1. पासकोड पर पाबंदी लगाएं: अगर आपने एक ही पासकोड का इस्तेमाल कई ऐप्लिकेशन में किया है, तो कई एपीआई पासकोड पर माइग्रेट करें. साथ ही, हर ऐप्लिकेशन के लिए अलग-अलग एपीआई पासकोड इस्तेमाल करें. ज़्यादा जानकारी के लिए, यह देखें:

   • अपने एपीआई पासकोड पर पाबंदी लगाना
   • एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना
   • हर ऐप्लिकेशन के लिए अलग-अलग एपीआई पासकोड इस्तेमाल करना

2. अगर Places SDK या Maps Javascript API का इस्तेमाल किया जाता है, तो अपने एपीआई पासकोड को सुरक्षित रखने के लिए, App Check का इस्तेमाल भी किया जा सकता है.

3. कुंजियों को सिर्फ़ तब बदलें या रोटेट करें, जब:

   • आपको उन कुंजियों के बिना अनुमति के इस्तेमाल का पता चलता है जिन पर पाबंदी नहीं लगाई जा सकती या जिन पर पहले से ही पाबंदी लगी हुई है. साथ ही, उन पर App Check लागू नहीं होता.

   • आपको अपने एपीआई पासकोड को सुरक्षित करने और गलत इस्तेमाल को रोकने के लिए, तेज़ी से कार्रवाई करनी है. भले ही, इससे आपके ऐप्लिकेशन पर आने वाले मान्य ट्रैफ़िक पर असर पड़े.

   आगे बढ़ने से पहले, एपीआई पासकोड रोटेट करते समय सावधानी बरतें लेख को पढ़ें.

4. अगर आपको अब भी समस्याएं आ रही हैं या मदद चाहिए, तो सहायता टीम से संपर्क करें.

ऐप्लिकेशन और एपीआई से जुड़ी पाबंदियों के सुझाव

यहां दिए गए सेक्शन में, Google Maps Platform के हर एपीआई, एसडीके या सेवा के लिए, ऐप्लिकेशन और एपीआई से जुड़ी पाबंदियों के बारे में बताया गया है.

एपीआई पर पाबंदियां लगाने के लिए सुझाए गए तरीके

एपीआई से जुड़ी पाबंदियों के लिए, यहां दिए गए दिशा-निर्देश Google Maps Platform की सभी सेवाओं पर लागू होते हैं:

• अपने एपीआई पासकोड को सिर्फ़ उन एपीआई तक सीमित करें जिनके लिए इसका इस्तेमाल किया जा रहा है. हालांकि, इन पर यह पाबंदी लागू नहीं होती:

  • अगर आपका ऐप्लिकेशन, Places SDK for Android या Places SDK for iOS का इस्तेमाल करता है, तो Places API (नया वर्शन) या Places API को अनुमति दें. यह इस बात पर निर्भर करता है कि एसडीके के कौनसे वर्शन इस्तेमाल किए जा रहे हैं. ¹

  • अगर आपका ऐप्लिकेशन Maps JavaScript API का इस्तेमाल करता है, तो उसे हमेशा अपने पासकोड पर अनुमति दें.

  • अगर Maps JavaScript API की इनमें से किसी भी सेवा का इस्तेमाल किया जाता है, तो आपको इन एपीआई को भी अनुमति देनी होगी:

    सेवा	एपीआई पर पाबंदी
    Directions Service (लेगसी)	Directions API (लेगसी)
    दूरी का मैट्रिक्स सेवा (लेगसी)	Distance Matrix API (लेगसी)
    एलिवेशन सर्विस	ऊंचाई से जुड़ा एपीआई
    जियोकोडिंग सेवा	जियोकोडिंग एपीआई
    Place क्लास, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट (नया), और किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला डेटा एपीआई	Places API (नया प्रॉडक्ट)^2
    जगहों की लाइब्रेरी, जगहों की सेवा, और किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट	Places API^2

¹ ज़्यादा जानकारी के लिए, Places SDK for Android और Places SDK for iOS के दस्तावेज़ देखें.

² अगर आपको पक्के तौर पर नहीं पता है कि आपको Places API (नया) या Places API (लेगसी) को अनुमति देनी है, तो Maps JavaScript API का दस्तावेज़ देखें.

कुछ उदाहरण:

• Maps SDK for Android और Places SDK for Android का इस्तेमाल किया जा रहा है. इसलिए, एपीआई से जुड़ी पाबंदियों के तौर पर, Android के लिए Maps SDK और Places API (नया वर्शन) को शामिल किया जाता है.

• आपकी वेबसाइट, Maps JavaScript API की एलिवेशन सर्विस और Maps Static API का इस्तेमाल करती है. इसलिए, आपको इन सभी एपीआई के लिए, एपीआई से जुड़ी पाबंदियां जोड़नी होंगी:

  • Maps JavaScript एपीआई
  • ऊंचाई से जुड़ा एपीआई
  • Maps स्टैटिक एपीआई

सुझाए गए ऐप्लिकेशन पर पाबंदी लगाना

अहम जानकारी: एपीआई पासकोड पर पाबंदी लगाने से, बिना अनुमति के इस्तेमाल की वजह से होने वाले अतिरिक्त खर्च और बिलिंग को कम करने में मदद मिलती है. खास तौर पर, तब जब टेस्ट एनवायरमेंट सार्वजनिक तौर पर दिख रहा हो या दिखने वाला हो या जब कोई ऐप्लिकेशन, प्रोडक्शन एनवायरमेंट में इस्तेमाल के लिए तैयार हो.

वेबसाइटें

सलाह: Maps Embed API के लिए, Maps Embed API वाली वेबसाइटें देखें.

Maps JavaScript API की सेवाओं, Maps Static API या Street View Static API का इस्तेमाल करने वाली वेबसाइटों के लिए, वेबसाइटों पर ऐप्लिकेशन के इस्तेमाल से जुड़ी पाबंदी का इस्तेमाल करें. इसके अलावा, एचटीटीपीएस REST API या gRPC पर, Google Maps Platform की हाल ही की सेवाओं को सीधे कॉल करने वाली वेबसाइटों के लिए भी इस पाबंदी का इस्तेमाल करें:

Directions Service (लेगसी) दूरी का मैट्रिक्स सेवा (लेगसी) Elevation Service जियोकोडिंग सेवा

Maps JavaScript API^1 Places Library^2 Maps Static API^3 Street View Static API^3

¹ मोबाइल ऐप्लिकेशन के लिए, नेटिव Maps SDK for Android और Maps SDK for iOS का इस्तेमाल करें.

² मोबाइल ऐप्लिकेशन के लिए, नेटिव Places SDK for Android और Places SDK for iOS का इस्तेमाल करें.

³ Static Web API के इस्तेमाल को सुरक्षित रखने के बारे में भी जानें.

Maps Embed API का इस्तेमाल करने वाली वेबसाइटें

Maps Embed API का इस्तेमाल करने के लिए कोई शुल्क नहीं लिया जाता. हालांकि, आपको इस्तेमाल किए गए किसी भी एपीआई पासकोड पर पाबंदी लगानी चाहिए, ताकि अन्य सेवाओं पर गलत इस्तेमाल को रोका जा सके.

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

अगर आपको Maps Embed API के इस्तेमाल को किसी अलग एपीआई पासकोड से अलग करने में समस्या आ रही है, तो वेबसाइट ऐप्लिकेशन से जुड़ी पाबंदी का इस्तेमाल करके, अपने मौजूदा पासकोड को सुरक्षित करें.

वेब सेवाओं का इस्तेमाल करने वाले ऐप्लिकेशन और सर्वर

सलाह: सर्वर-साइड ऐप्लिकेशन के लिए, Google उन सेवाओं पर एपीआई पासकोड के बजाय OAuth 2.0 का इस्तेमाल करने का सुझाव देता है जो इसे सपोर्ट करती हैं. ज़्यादा जानकारी के लिए, यहां दी गई टेबल देखें.

एपीआई पासकोड के साथ वेब सेवाओं का इस्तेमाल करने वाले भरोसेमंद कॉर्पोरेट इंटरनल नेटवर्क के सर्वर और क्लाइंट-साइड ऐप्लिकेशन के लिए, IP addresses ऐप्लिकेशन पर पाबंदी का इस्तेमाल करें.

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

इन एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन और सर्वर के लिए इस्तेमाल करें:

Address Validation API Aerial View API Air Quality API Directions API (लेगसी)^4 Distance Matrix API (लेगसी)^4 Elevation API Geocoding API^5 Geolocation API^6 Map Tiles API

Maps Datasets API Places API (नया प्रॉडक्ट)^7 Places API (लेगसी)^6 Roads API Routes API^4 Pollen API Solar API Time Zone API^8 Weather API

⁴ मोबाइल ऐप्लिकेशन के लिए, Navigation SDK का इस्तेमाल करें.

⁵ मोबाइल का सुरक्षित तरीके से इस्तेमाल करने के लिए, सुरक्षित प्रॉक्सी सर्वर का इस्तेमाल करें.

⁶ क्लाइंट-साइड ऐप्लिकेशन के लिए, प्लैटफ़ॉर्म की ओर से उपलब्ध कराई गई नेटिव जियोलोकेशन सेवा का इस्तेमाल करें. उदाहरण के लिए, वेब ब्राउज़र के लिए W3C जियोलोकेशन, Android के लिए LocationManager या कई तरह से जांची गई सही जगह की जानकारी देने वाला एपीआई, या iOS के लिए Apple का Core Location फ़्रेमवर्क.

⁷ मोबाइल ऐप्लिकेशन के लिए, नेटिव Places SDK for Android और Places SDK for iOS का इस्तेमाल करें.

⁸ क्लाइंट-साइड पर सुरक्षित तरीके से इस्तेमाल करने के लिए, सुरक्षित प्रॉक्सी सर्वर का इस्तेमाल करें.

Android ऐप्लिकेशन

Android पर मौजूद ऐप्लिकेशन के लिए, Android apps ऐप्लिकेशन पर पाबंदी लगाने की सुविधा का इस्तेमाल करें. इन एसडीके का इस्तेमाल करने वाले ऐप्लिकेशन के लिए इस्तेमाल करें:

• Maps SDK for Android
• Places SDK for Android
• Android के लिए Navigation SDK टूल

अहम जानकारी: Google का सुझाव है कि ज़्यादा से ज़्यादा सुरक्षा के लिए, अपने Android ऐप्लिकेशन से Google Maps Platform की सेवाओं को ऐक्सेस करने के लिए, हमारे नेटिव एसडीके टूल का इस्तेमाल करें.
अगर आपको Google Maps Platform की ऐसी सेवाएं ऐक्सेस करनी हैं जिनके लिए नेटिव Android SDK उपलब्ध नहीं है, तो क्लाइंट-साइड वेब सेवा कॉल को सुरक्षित करना और Static Web API के इस्तेमाल को सुरक्षित करना लेख पढ़ें.

इसके अलावा, एपीआई पासकोड को Android मेनिफ़ेस्ट में सेव करने के बजाय, किसी लोकल फ़ाइल से सीक्रेट इंजेक्ट करने के लिए, सीक्रेट्स ग्रैडल प्लग इन का इस्तेमाल करें. इससे, एपीआई पासकोड को गलती से वर्शन कंट्रोल में चेक करने से रोका जा सकता है.

iOS ऐप्लिकेशन

iOS पर मौजूद ऐप्लिकेशन के लिए, iOS apps ऐप्लिकेशन पर पाबंदी लगाने की सुविधा का इस्तेमाल करें. इन एसडीके का इस्तेमाल करने वाले ऐप्लिकेशन और सर्वर के लिए:

• iOS के लिए Maps SDK
• Places SDK for iOS
• iOS के लिए Navigation SDK टूल

अहम जानकारी: ज़्यादा से ज़्यादा सुरक्षा के लिए, Google हमारा सुझाव है कि आप अपने iOS ऐप्लिकेशन से Maps Platform की सेवाओं को ऐक्सेस करने के लिए, हमारे नेटिव एसडीके टूल का इस्तेमाल करें.
अगर आपको Maps Platform की ऐसी सेवाओं को ऐक्सेस करना है जिनके लिए नेटिव iOS SDK उपलब्ध नहीं है, तो क्लाइंट-साइड वेब सेवा कॉल को सुरक्षित करना और Static Web API के इस्तेमाल को सुरक्षित करना देखें.

इस बारे में और पढ़ें

• एपीआई पासकोड मैनेज करना
• एपीआई ऐक्सेस करने के लिए, एपीआई पासकोड इस्तेमाल करना
• कोटा की मदद से, Google Maps Platform के इस्तेमाल को ऑप्टिमाइज़ करना (वीडियो)
• Google Maps Platform के लिए एपीआई पासकोड जनरेट करने और उन पर पाबंदी लगाने का तरीका (वीडियो)
• एपीआई पासकोड पर पाबंदी लगाना
• Static Maps और Street View API का इस्तेमाल करते समय, एपीआई पासकोड सुरक्षित करना
• Google Maps Platform इस्तेमाल करने के 15 सबसे सही तरीके