एपीआई सुरक्षा के सबसे सही तरीके

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

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

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

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

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

सुझाए गए सबसे सही तरीके

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

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

अपनी एपीआई कुंजियों पर पाबंदी लगाना

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

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

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

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

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

स्टैटिक वेब एपीआई का इस्तेमाल करके ऐप्लिकेशन की सुरक्षा करना

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

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

iOS और Android मोबाइल ऐप्लिकेशन के लिए अतिरिक्त सुझाव

वेब सर्विस या स्टैटिक वेब एपीआई का इस्तेमाल करके, मोबाइल ऐप्लिकेशन की सुरक्षा करना

अगर इस्तेमाल की जा रही एपीआई पासकोड को सीमित किया जा रहा है या फिर से जनरेट किया जा रहा है, तो

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

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

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

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

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

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

अपनी एपीआई कुंजियों पर पाबंदी लगाएं

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

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

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

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

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

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

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

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

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

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

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

   

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

   पाबंदी किस तरह की है	ब्यौरा
   वेबसाइट	रेफ़रल देने वाली एक या उससे ज़्यादा वेबसाइट चुनें. दुनिया भर में काम करने वाली रेफ़रर यूआरआई स्कीम https और http हैं. हमेशा पूरा रेफ़रर यूआरआई दें. इसमें प्रोटोकॉल स्कीम, होस्टनेम, और वैकल्पिक पोर्ट (उदाहरण के लिए, https://google.com). सभी सबडोमेन को अनुमति देने के लिए, वाइल्डकार्ड वर्णों का इस्तेमाल किया जा सकता है. उदाहरण के लिए, https://*.google.com उन सभी साइटों को स्वीकार करता है जिनके आखिरी अंक .google.com हैं. ध्यान दें कि अगर www.domain.com की जानकारी दी जाती है, तो यह एक वाइल्डकार्ड www.domain.com/* की तरह काम करता है. साथ ही, उस होस्टनेम पर किसी भी सबपाथ को अनुमति देता है. फ़ुल-पाथ रेफ़रर की अनुमति देते समय सावधानी बरतें. उदाहरण के लिए, https://google.com/some/path, डिफ़ॉल्ट रूप से, ज़्यादातर मौजूदा ब्राउज़र, पाथ को क्रॉस-ऑरिजिन अनुरोधों से हटा देते हैं.
   आईपी पते	सीआईडीआर नोटेशन का इस्तेमाल करके एक या एक से ज़्यादा IPv4 या IPv6 पते या सबनेट बताएं. आईपी पते, Google Maps Platform के सर्वर में बताए गए सोर्स पते से मेल खाने चाहिए. अगर नेटवर्क एड्रेस ट्रांसलेशन (एनएटी) का इस्तेमाल किया जाता है, तो आम तौर पर यह पता आपकी मशीन के सार्वजनिक आईपी पते से जुड़ा होता है.
   Android ऐप्लिकेशन	आपको जिस Android ऐप्लिकेशन को अनुमति देनी है उसके लिए, Android पैकेज का नाम (AndroidManifest.xml फ़ाइल से) और SHA-1 साइनिंग सर्टिफ़िकेट का फ़िंगरप्रिंट जोड़ें. अगर आपने साइनिंग सर्टिफ़िकेट का फ़िंगरप्रिंट फ़ेच करने के लिए, Play ऐप्लिकेशन साइनिंग का इस्तेमाल किया है, तो एपीआई की सेवा देने वाली कंपनियों के साथ काम करना लेख पढ़ें. अगर आपका साइनिंग पासकोड खुद मैनेज किया जाता है, तो ऐप्लिकेशन पर खुद से हस्ताक्षर करना देखें या अपने बिल्ड एनवायरमेंट के लिए दिए गए निर्देश देखें.
   iOS ऐप्लिकेशन	हर उस iOS ऐप्लिकेशन के लिए बंडल आइडेंटिफ़ायर जोड़ें जिसे आपको अनुमति देनी है.

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

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

एपीआई पासकोड के लिए एपीआई की पाबंदियां सेट करें

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

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

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

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

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

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

   

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

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

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

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

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

• उन एपीआई को तय करना जो आपके एपीआई पासकोड का इस्तेमाल करते हैं

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

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

उन एपीआई की पहचान करना जो आपके एपीआई पासकोड का इस्तेमाल करते हैं

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

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

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

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

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

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

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

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

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

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

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

   3. उस कुंजी से जुड़ी value चुनें जिसकी जांच करनी है.

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

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

5. बची हुई किसी भी कुंजी के लिए, यही तरीका दोहराएं.

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

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

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

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

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

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

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

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

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

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

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

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

   3. उस कुंजी से जुड़ी value चुनें जिसकी जांच करनी है.

   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 Console, कुछ प्रोजेक्ट मालिकों और एडिटर को Google Maps Platform पर की गई उनकी गतिविधि और इस्तेमाल के आधार पर, बिना पाबंदी वाली एपीआई कुंजियों के लिए खास एपीआई पासकोड से जुड़ी पाबंदियों का सुझाव देता है.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

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

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

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

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

क्लाइंट-साइड SDK टूल के लिए यहां देखें:

• Maps JavaScript API ऐप्लिकेशन: ब्राउज़र डीबग कंसोल देखें
• Android ऐप्लिकेशन: Android डीबग ब्रिज (adb) या Logcat का इस्तेमाल करें
• iOS ऐप्लिकेशन: लॉग मैसेज देखना देखें

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

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

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

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

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

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

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

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

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

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

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

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

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

अपनी एपीआई कुंजियां फिर से जनरेट करते समय सावधानी बरतें

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

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

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

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

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

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

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

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

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

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

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

4. कुंजी बदलें को चुनें.

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

फिर से जनरेट की गई कुंजी को रोल बैक करने के लिए

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

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

3. पिछली कुंजी पर वापस जाएं चुनें.

4. वापस लाएं डायलॉग में, वापस लाएं चुनें.

वापस रोल बैक करने पर, कुंजी का पिछला "नया" वर्शन, पिछला वर्शन बन जाता है और उसके लिए, 24 घंटे का नया ऐक्टिवेशन टाइमर सेट कर दिया जाता है. इन दो मुख्य वैल्यू के बीच तब तक बदलाव किया जा सकता है, जब तक कि कुंजी को फिर से जनरेट न कर लिया जाए.

कुंजी को फिर से जनरेट करने पर, यह पुरानी बंद कुंजी की वैल्यू को बदल देती है.

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

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

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

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

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

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

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

स्टैटिक वेब एपीआई का इस्तेमाल करके ऐप्लिकेशन सुरक्षित रखें

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

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

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

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

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

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

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

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

• अपने अनुरोधों पर हस्ताक्षर करें, क्लाइंट पर नहीं. अगर JavaScript में क्लाइंट-साइड पर हस्ताक्षर किया जाता है, तो आपकी साइट पर आने वाले लोगों को यह पता चल जाता है. इसलिए, डाइनैमिक तौर पर जनरेट की गई इमेज के लिए, वेब पेज दिखाते समय हमेशा अपने साइन किए गए Maps स्टैटिक एपीआई और Street View स्टैटिक एपीआई के अनुरोध यूआरएल सर्वर साइड जनरेट करें. स्टैटिक वेब कॉन्टेंट के लिए, Cloud Console के Google Maps Platform के क्रेडेंशियल पेज पर मौजूद, अभी यूआरएल साइन करें विजेट का इस्तेमाल किया जा सकता है.

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

वेब सेवाओं का इस्तेमाल करके ऐप्लिकेशन में अपनी एपीआई कुंजी सुरक्षित रखें

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

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

मोबाइल ऐप्लिकेशन को सुरक्षित रखने के लिए, सुरक्षित कीस्टोर या सुरक्षित प्रॉक्सी सर्वर का इस्तेमाल करें:

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

• सुरक्षित प्रॉक्सी सर्वर का इस्तेमाल करें. प्रॉक्सी सर्वर सही Google Maps Platform API से इंटरैक्ट करने के लिए एक मज़बूत सोर्स उपलब्ध कराता है. प्रॉक्सी सर्वर का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, Living Vicariously: Google Data API क्लाइंट लाइब्रेरी के साथ प्रॉक्सी सर्वर इस्तेमाल करना देखें.

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

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

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

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

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

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

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

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

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

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

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

सुझाए गए एपीआई की पाबंदियां

एपीआई पाबंदियों के लिए नीचे दिए गए दिशा-निर्देश पूरे Google Maps Platform पर लागू होते हैं:

• नीचे दिए गए अपवादों के साथ अपनी एपीआई कुंजी को सिर्फ़ उन एपीआई तक सीमित करें जिनके लिए आप उसका इस्तेमाल कर रहे हैं:

  • अगर आपका ऐप्लिकेशन Android के लिए Places SDK टूल या iOS के लिए Places SDK टूल का इस्तेमाल करता है, तो Places API को अनुमति दें.

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

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

  सेवा	एपीआई से जुड़ी पाबंदी
  दिशा बताने वाली सेवा, Maps JavaScript एपीआई	निर्देश से जुड़ा एपीआई
  दूरी का मैट्रिक्स बताने वाली सेवा, Maps JavaScript एपीआई	दूरी के मैट्रिक्स का एपीआई
  ऊंचाई बताने वाली सेवा, Maps JavaScript एपीआई	ऊंचाई से जुड़ा एपीआई
  जियोकोडिंग सेवा, Maps JavaScript एपीआई	जियोकोडिंग एपीआई
  Places लाइब्रेरी, Maps JavaScript एपीआई	Places API

कुछ उदाहरण:

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

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

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

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

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

Maps JavaScript API या स्टैटिक वेब एपीआई वाली वेबसाइटें

Maps JavaScript सेवाओं या स्टैटिक वेब एपीआई का इस्तेमाल करने वाली वेबसाइटों के लिए, Websites ऐप्लिकेशन पाबंदी का इस्तेमाल करें.

इन JavaScript सेवाओं और एपीआई का इस्तेमाल करने वाली वेबसाइटों के लिए इस्तेमाल करें:

निर्देश देने वाली सेवा डिस्टेंस मैट्रिक्स सेवा ऊंचाई पर जाने से जुड़ी सेवा जियोकोडिंग सेवा

Maps JavaScript API^1 जगहों की लाइब्रेरी Maps स्टैटिक एपीआई^2 Street View स्टैटिक एपीआई^2

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

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

Maps Embed API वाली वेबसाइटें

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

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

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

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

वेब सेवाओं का इस्तेमाल करने वाले ऐप्लिकेशन और सर्वर के लिए, IP addresses ऐप्लिकेशन पाबंदी का इस्तेमाल करें.

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

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

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

भौगोलिक स्थान एपीआई मैप टाइल एपीआई जगहें एपीआई ^3 रोड एपीआई रूट एपीआई पोलन एपीआई सोलर एपीआई टाइम ज़ोन एपीआई

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

Android ऐप्लिकेशन

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

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

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

iOS ऐप्लिकेशन

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

• iOS के लिए Maps SDK टूल
• iOS के लिए प्लैटफ़ॉर्म SDK टूल

यूआरएल के बारे में जानकारी

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