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

खास जानकारी

पुष्टि करने की प्रोसेस को ज़्यादा सुरक्षित और भरोसेमंद बनाने के लिए, Maps Platform के क्लाइंट आईडी का इस्तेमाल 26 मई, 2025 से बंद कर दिया गया है. इनका इस्तेमाल 31 मई, 2026 के बाद नहीं किया जा सकेगा.

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

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

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

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

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

• 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 Project से कई एपीआई कुंजियों का इस्तेमाल किया जा सकता है. उदाहरण के लिए, हर Maps Platform सेवा के लिए ट्रैफ़िक को अलग करने के लिए या अलग-अलग प्लैटफ़ॉर्म (ब्राउज़र, मोबाइल ऐप्लिकेशन वगैरह) से ट्रैफ़िक को अलग करने के लिए. एपीआई पासकोड को मैनेज करने के सबसे सही तरीकों के बारे में जानने के लिए, सुरक्षा गाइड देखें.

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

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

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

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

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

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

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

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

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

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

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

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

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

एपीआई का तरीका	क्लाइंट-साइड सेवा	कोटा में बदलाव करने वाली सेवा
google.routes.Directions.Javascript	रास्ता बताने वाली सेवा	निर्देश से जुड़ा एपीआई
google.routes.DistanceMatrix.Javascript	Distance Matrix Service	दूरी के मैट्रिक्स का एपीआई
google.maps.Elevation.Javascript	लिफ़्ट की सुविधा	ऊंचाई से जुड़ा एपीआई
google.places.Geocoding.Javascript	जियोकोडिंग सेवा	जियोकोडिंग एपीआई
google.places.Geocoding.Javascript को छोड़कर, google.places.*.Javascript	Places Library	Places API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अपने क्लाइंट आईडी को कुछ समय के लिए रोकना

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

समस्या का हल

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

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

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"
}