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

खास जानकारी

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

  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 प्रोजेक्ट ढूंढें जिससे आपका क्लाइंट आईडी लिंक है:
  2. पक्का करें कि आपका Cloud प्रोजेक्ट, किसी चालू बिलिंग खाते से लिंक हो.
  3. क्लाइंट आईडी के माइग्रेशन के लिए, नया एपीआई पासकोड बनाएं.
    • Cloud प्रोजेक्ट पर, मौजूदा किसी भी एपीआई पासकोड का फिर से इस्तेमाल किया जा सकता है.
    • एक ही Cloud प्रोजेक्ट के कई एपीआई पासकोड का इस्तेमाल किया जा सकता है. उदाहरण के लिए, 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 पर इन सेवाओं का इस्तेमाल किया जा रहा है, तो एपीआई पासकोड पर माइग्रेट करने के बाद, कोटा के इस्तेमाल में बढ़ोतरी दिखेगी.

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

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

एपीआई का तरीका

क्लाइंट-साइड सेवा

कोटा में बदलाव करने वाली सेवा

google.routes.Directions.Javascript

रास्ता बताने वाली सेवा

Directions API

google.routes.DistanceMatrix.Javascript

दूरी का मैट्रिक्स बताने वाली सेवा

Distance Matrix API

google.maps.Elevation.Javascript

ऊंचाई बताने वाली सेवा

Elevation API

google.places.Geocoding.Javascript

जियोकोडिंग सेवा

Geocoding API

google.places.*.Javascript, google.places.Geocoding.Javascript के अलावा

जगहों की लाइब्रेरी

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

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

क्लाइंट पैरामीटर की जगह, पासकोड पैरामीटर का इस्तेमाल करना

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

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

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

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

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

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

  • Directions API (लेगसी)
  • Distance Matrix API (लेगसी)
  • Geocoding API
  • Elevation API
  • Time Zone API

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

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

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

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

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

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

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

क्लाइंट आईडी को अस्थायी तौर पर फिर से चालू करने के लिए, सेल्फ़-सर्विस का इस्तेमाल करना

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

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

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

अगर एपीआई पासकोड पर तुरंत माइग्रेट नहीं किया जा सकता और आपको कुछ समय के लिए सेवा में रुकावटों से छूट चाहिए, तो कृपया 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 Project पर सेवा चालू नहीं की गई है, तो आपको ApiNotActivatedMapError या REQUEST_DENIED गड़बड़ी दिखेगी. सेवा चालू करने के लिए, निर्देशों का पालन करें enable the service.

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