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

खास जानकारी

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

  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. वह क्लाउड प्रोजेक्ट ढूंढें जिससे आपका क्लाइंट आईडी लिंक है:
  2. पक्का करें कि आपका क्लाउड प्रोजेक्ट, किसी चालू बिलिंग खाते से लिंक हो.
  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 Service

निर्देश से जुड़ा एपीआई

google.routes.DistanceMatrix.Javascript

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

दूरी के मैट्रिक्स का एपीआई

google.maps.Elevation.Javascript

एलिवेशन सर्विस

ऊंचाई से जुड़ा एपीआई

google.places.Geocoding.Javascript

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

जियोकोडिंग एपीआई

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

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

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

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

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

अपने आउटगोइंग GMP API कॉल में, पुष्टि करने वाले क्रेडेंशियल को 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 पर जाकर, अपने क्लाइंट आईडी को रोका जा सकता है. ज़्यादा जानकारी के लिए, प्रीमियम प्लान की पुष्टि करने की खास जानकारी देखें.

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

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 गड़बड़ी

अगर आपने अपने क्लाउड प्रोजेक्ट पर सेवा चालू नहीं की है, तो आपको 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"
}