क्लास google.script.url (क्लाइंट-साइड एपीआई)

google.script.url, एसिंक्रोनस क्लाइंट-साइड JavaScript API है. यह मौजूदा यूआरएल पैरामीटर और फ़्रैगमेंट पाने के लिए, यूआरएल पर क्वेरी कर सकता है. यह एपीआई, google.script.history एपीआई के साथ काम करता है. इसका इस्तेमाल सिर्फ़ उस वेब ऐप्लिकेशन के संदर्भ में किया जा सकता है जो IFRAME का इस्तेमाल करता है. इसका इस्तेमाल ऐड-ऑन या कंटेनर-स्क्रिप्ट कॉन्टेक्स्ट में साइडबार और डायलॉग के साथ करने के लिए नहीं किया जाना चाहिए. ज़्यादा जानकारी के लिए, वेब ऐप्लिकेशन में ब्राउज़र इतिहास का इस्तेमाल करने से जुड़ी गाइड देखें.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getLocation(function) void यह यूआरएल लोकेशन ऑब्जेक्ट लेता है और इसे दिए गए कॉलबैक फ़ंक्शन पर भेजता है.

ज़्यादा जानकारी के साथ दस्तावेज़

getLocation(function)

यह एक यूआरएल लोकेशन ऑब्जेक्ट लेता है और उसे बताए गए कॉलबैक फ़ंक्शन (सिर्फ़ एक आर्ग्युमेंट के तौर पर) में पास करता है.

Index.html

google.script.url.getLocation(function(location) {
  console.log(location.parameters);
  console.log(location.hash);
});

पैरामीटर

नामTypeब्यौरा
functionFunctionचलाने के लिए क्लाइंट-साइड कॉलबैक फ़ंक्शन, जिसमें सिर्फ़ लोकेशन ऑब्जेक्ट को आर्ग्युमेंट के तौर पर इस्तेमाल किया गया हो.

लोकेशन ऑब्जेक्ट

नीचे दी गई टेबल में लोकेशन एलिमेंट के उदाहरण दिए गए हैं, जो इस यूआरएल से क्वेरी किए जाने पर तय किए जाएंगे: http://www.example.com?n=1&name=alice&n=2#headingAnchor
फ़ील्ड
location.hash

# वर्ण के बाद यूआरएल फ़्रैगमेंट की स्ट्रिंग वैल्यू या कोई यूआरएल फ़्रैगमेंट मौजूद न होने पर खाली स्ट्रिंग

headingAnchor
location.parameter

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

{"name": "alice", "n": "1"}
location.parameters

location.parameter से मिलता-जुलता ऑब्जेक्ट, लेकिन हर कुंजी के लिए वैल्यू की एक कलेक्शन होता है. अगर कोई पैरामीटर मौजूद नहीं है, तो यह एक खाली ऑब्जेक्ट होगा.

{"name": ["alice"], "n": ["1", "2"]}