क्लाइंट आईडी को माइग्रेट करने से जुड़ी गाइड

खास जानकारी

शुरू करने के लिए इन तरीकों का पालन करें:

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

मौजूदा क्लाइंट आईडी के इस्तेमाल की जानकारी देखना

माइग्रेशन की प्रोसेस शुरू करने से पहले, इन चीज़ों की सूची बनाएं:

• Maps Platform की वे सेवाएँ जिनके लिए क्लाइंट आईडी का इस्तेमाल किया जा रहा है.
• ऐसे ऐप्लिकेशन, साइटें या सिस्टम जिनके साथ क्लाइंट आईडी का इस्तेमाल किया जा रहा है.

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

Cloud Console में, Google Maps के मेट्रिक पेज पर जाकर, क्लाइंट आईडी के इस्तेमाल की मौजूदा स्थिति देखी जा सकती है

Maps Platform की सेवाओं की सूची के लिए:

1. Cloud Console पर, मेट्रिक पेज खोलें.
2. इन सेटिंग का इस्तेमाल करके, अपने इस्तेमाल को फ़िल्टर करें:
   • क्रेडेंशियल: सिर्फ़ "project_number:<numerical identifier>" चुनें.
3. यह फ़िल्टर सेट करें.
   • इसके हिसाब से ग्रुप बनाया गया है: एपीआई

ऐप्लिकेशन, साइटों या सिस्टम के बारे में जानकारी पाने के लिए:

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

1. Cloud Console पर, मेट्रिक पेज खोलें.
2. ड्रॉप-डाउन से Maps Platform की कोई सेवा चुनें.
3. इन सेटिंग की मदद से, इस्तेमाल के डेटा को फ़िल्टर करें:
   • क्रेडेंशियल: सिर्फ़ "project_number:<numerical identifier>" चुनें.
4. यह फ़िल्टर सेट करें.
   • इसके हिसाब से ग्रुप बनाएं: प्लैटफ़ॉर्म या डोमेन
5. Maps Platform की हर उस सेवा के लिए दूसरे चरण से लेकर आगे तक की प्रोसेस दोहराएं जिसके लिए आपको ट्रैफ़िक की जांच करनी है.

एपीआई पासकोड तैयार करना

सभी क्लाइंट आईडी, Google Cloud प्रोजेक्ट से जुड़े होते हैं. साथ ही, उस प्रोजेक्ट के एपीआई पासकोड का इस्तेमाल करने पर, आपको वही सुविधाएं मिलेंगी जिन्हें आपने पहले अपने क्लाइंट आईडी से ऐक्सेस किया था. हमारा सुझाव है कि आप इससे जुड़े प्रोजेक्ट पर माइग्रेट करें, ताकि कोटा से जुड़ी समस्याओं या सुविधाओं के न होने से बचा जा सके.

1. वह Cloud Project ढूंढें जिससे आपका क्लाइंट आईडी लिंक है:
   • पोर्टल माइग्रेशन के बारे में अक्सर पूछे जाने वाले सवाल
2. पक्का करें कि आपका Cloud प्रोजेक्ट, किसी चालू बिलिंग खाते से लिंक हो.
3. क्लाइंट आईडी माइग्रेट करने के लिए, नया एपीआई पासकोड बनाएं.
   • Cloud प्रोजेक्ट पर मौजूद किसी भी एपीआई पासकोड का फिर से इस्तेमाल किया जा सकता है.
   • एक ही Cloud प्रोजेक्ट से कई एपीआई पासकोड इस्तेमाल किए जा सकते हैं. उदाहरण के लिए, Maps Platform की हर सेवा के लिए ट्रैफ़िक को अलग करने के लिए या अलग-अलग प्लैटफ़ॉर्म (ब्राउज़र, मोबाइल ऐप्लिकेशन वगैरह) से ट्रैफ़िक को अलग करने के लिए. एपीआई पासकोड मैनेज करने के सबसे सही तरीकों के बारे में जानने के लिए, सुरक्षा गाइड देखें.

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

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

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

ज़्यादा जानकारी के लिए, Google Maps Platform की सुरक्षा से जुड़े दिशा-निर्देश देखें.

Maps JavaScript API, Maps Static API, और Street View Static API के लिए, अपने क्लाइंट आईडी पर मौजूद भरोसेमंद रेफ़रल को एपीआई पासकोड से जुड़ी पाबंदियों पर माइग्रेट किया जा सकता है. Cloud Console पर, भरोसेमंद रेफ़रर की सूची देखी जा सकती है.

कोटा सेटिंग की समीक्षा करना

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

कोटा रिपोर्ट के बारे में ज़्यादा जानें

Maps JavaScript API की क्लाइंट-साइड सेवाओं के लिए कोटा बढ़ाना

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

अपने मौजूदा कोटा कॉन्फ़िगरेशन और मौजूदा इस्तेमाल की समीक्षा करें. साथ ही, कोटा की सीमाओं में ज़रूरत के मुताबिक बदलाव करें.

1. देखें कि क्या क्लाइंट आईडी के साथ, Maps JavaScript API की क्लाइंट-साइड सेवाओं का इस्तेमाल किया जा रहा है.
   • Cloud Console पर मेट्रिक पेज खोलें.
   • इन सेटिंग की मदद से, इस्तेमाल के डेटा को फ़िल्टर करें:
     • इसके हिसाब से ग्रुप किया गया: एपीआई मेथड
     • क्रेडेंशियल: सिर्फ़ "project_number:<numerical identifier>" चुनें.
   • इसके बाद, आपको "एपीआई मेथड के हिसाब से ट्रैफ़िक" चार्ट में, मेथड के नामों की सूची और उनका ट्रैफ़िक दिखेगा.

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

अपना कोड अपडेट करना

क्लाइंट पैरामीटर को मुख्य पैरामीटर से बदलना

अपने आउटगोइंग जीएमपी एपीआई कॉल में, पुष्टि करने वाले क्रेडेंशियल को URL&client={value} से URL&key={value} पर अपडेट करें. अगर आपके ऐप्लिकेशन, GMP सेवाओं को ऐक्सेस करने के लिए एचटीटीपी का इस्तेमाल कर रहे हैं, तो उन्हें एचटीटीपीएस का इस्तेमाल करने के लिए अपडेट करें.

रिपोर्टिंग के लिए चैनल पैरामीटर अपडेट करना

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

ज़्यादा जानकारी के लिए, Google Maps Platform की रिपोर्टिंग देखें.

वेब सेवाओं के लिए सिग्नेचर पैरामीटर हटाना

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

• Directions API (लेगसी)
• Distance Matrix API (लेगसी)
• जियोकोडिंग एपीआई
• ऊंचाई से जुड़ा एपीआई
• समय क्षेत्र एपीआई

ज़्यादा जानकारी के लिए, प्रीमियम प्लान की खास जानकारी देखें.

इमेजरी एपीआई के लिए साइनिंग सीक्रेट

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

अपने क्लाइंट आईडी के ट्रैफ़िक पर नज़र रखना

डप्लॉयमेंट के बाद, Cloud Console डैशबोर्ड का इस्तेमाल करके पुष्टि करें कि आपका ट्रैफ़िक माइग्रेट हो गया है. आपको अपने क्लाइंट आईडी के ट्रैफ़िक में कमी दिखेगी. क्रेडेंशियल के हिसाब से ग्रुप बनाने पर, यह ट्रैफ़िक डैशबोर्ड पर "project_number:123456" फ़ॉर्मैट में दिखता है.

अपने क्लाइंट आईडी को रोकना

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

क्लाइंट आईडी को खुद से कुछ समय के लिए फिर से चालू करने की सुविधा

Google Maps Platform के क्लाइंट आईडी, मई 2026 में बंद होने की अवधि में पहुंच गए हैं. इसलिए, अब सेवा की उपलब्धता की गारंटी नहीं दी जा सकती. सेवा बंद करने की तय प्रक्रिया के तहत, समय-समय पर ऐक्सेस पर पाबंदी लगाई जाएगी. आम तौर पर, सेवा कुछ घंटों में अपने-आप वापस चालू हो जाती है. हालांकि, अगर आपको तुरंत सेवा फिर से चालू करनी है, तो आपके पास इसे मैन्युअल तरीके से चालू करने का विकल्प होता है.

ऐक्सेस तुरंत वापस पाने के लिए, Google Cloud Console में जाकर, सेल्फ़-सर्विस के ज़रिए खाते को फिर से चालू करें:

• Google Maps Platform के क्रेडेंशियल पेज पर जाएं.
• अपने क्लाइंट आईडी से लिंक किया गया क्लाउड प्रोजेक्ट ढूंढें.
• सेवा को वापस लाने के लिए, एंट्री के सबसे दाईं ओर मौजूद 'फिर से शुरू करें' आइकॉन पर क्लिक करें.

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

• क्लाइंट आईडी
• इस्तेमाल का खास उदाहरण
• माइग्रेशन की टारगेट तारीख
• कारोबार पर पड़ने वाले असर का आकलन

क्लाइंट आईडी के इस्तेमाल की रिपोर्ट - बिलिंग रिपोर्ट से

प्रोजेक्ट मेट्रिक के बजाय बिलिंग रिपोर्ट देखना, उन उपयोगकर्ताओं के लिए मददगार हो सकता है जिनके पास प्रोजेक्ट मेट्रिक का ऐक्सेस नहीं है. उदाहरण के लिए, बिलिंग एडमिन (खास तौर पर Maps Platform प्लैटफ़ॉर्म पार्टनर). बिलिंग रिपोर्ट में एक से दो दिन की देरी होती है. हालांकि, इनमें 30 दिनों से ज़्यादा के इस्तेमाल और लागत की अहम जानकारी दिखती है.

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

1. Google Cloud Console में, बिलिंग > रिपोर्ट पेज पर जाएं.
2. (ज़रूरी नहीं, सिर्फ़ पार्टनर के लिए) अपनी पसंद का सब-बिलिंग खाता चुनने के लिए, फ़िल्टर लागू करें.
3. रिपोर्ट के डेटा को लेबल की goog-maps-api-key-suffix के हिसाब से ग्रुप करें. इस लेबल में, एपीआई पासकोड के आखिरी वर्ण दिखते हैं.
4. क्लाइंट आईडी के ट्रैफ़िक की पहचान करने के लिए, उन एंट्री को देखें जिनमें goog-maps-api-key-suffix लेबल मौजूद नहीं है या खाली है. ऐसा इसलिए, क्योंकि क्लाइंट आईडी के अनुरोधों के लिए यह लेबल नहीं भरा जाता है.
5. उन एसकेयू को अनदेखा करें जिन्हें एपीआई अनुरोधों से नहीं जोड़ा जाना चाहिए. उदाहरण के लिए, सदस्यता वाले एसकेयू.

समस्या का हल

हम यह कैसे देखें कि हमारा अनुरोध पूरा हो रहा है या नहीं?

रिस्पॉन्स कोड के ग्राफ़ पर जाकर, गड़बड़ी के आंकड़े देखे जा सकते हैं

ApiNotActivatedMapError या REQUEST_DENIED गड़बड़ी

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

RefererNotAllowedMapError गड़बड़ी

अगर आपके सोर्स डोमेन को एपीआई पासकोड में नहीं जोड़ा गया है, तो आपको RefererNotAllowedMapError गड़बड़ी दिखेगी. "अपने एपीआई पासकोड को सुरक्षित करें" सेक्शन पर जाएं और एपीआई पासकोड में अपना डोमेन जोड़ें.

OverQuotaMapError या OVER_QUERY_LIMIT गड़बड़ी

अगर कॉन्फ़िगर किया गया आपका कोटा, ट्रैफ़िक को कवर करने के लिए काफ़ी नहीं है, तो आपको OverQuotaMapError या OVER_QUERY_LIMIT दिखेगा. "कोटा सेटिंग की समीक्षा करें" सेक्शन देखें और अपने कोटा में इसके हिसाब से बदलाव करें.

"इस एपीआई को किए गए अनुरोध, एसएसएल पर होने चाहिए" गड़बड़ी

अगर आपको गड़बड़ी का यह मैसेज मिलता है, तो अपने एपीआई अनुरोधों को "http://" से "https://" पर अपडेट करें.

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}