संसाधन फ़ेच करें और इंटरनेट पर अन्य होस्ट से बातचीत करें.
यह सेवा, स्क्रिप्ट को अन्य ऐप्लिकेशन से संपर्क करने या अन्य संसाधनों को ऐक्सेस करने की अनुमति देती है यूआरएल फ़ेच करके, उन्हें वेब पर डाला जा सकता है. स्क्रिप्ट, एचटीटीपी और एचटीटीपीएस से जुड़ी समस्या हल करने के लिए, यूआरएल फ़ेच सेवा का इस्तेमाल कर सकती है आप अपने सवालों के जवाब पा सकते हैं. URL फ़ेच सेवा इसके लिए Google की नेटवर्क इंफ़्रास्ट्रक्चर का उपयोग करती है और स्केलिंग के मकसद से इकट्ठा किया जाता है.
इस सेवा का इस्तेमाल करके किए गए अनुरोध, आईपी रेंज के एक सेट से जनरेट होते हैं. आईपी पतों की पूरी सूची देखी जा सकती है, अगर आपको इन अनुरोधों की अनुमति देनी होगी या उन्हें मंज़ूरी देनी होगी.
इस सेवा के लिए https://www.googleapis.com/auth/script.external_request
की ज़रूरत है
दायरा. ज़्यादातर मामलों में Apps Script, स्क्रिप्ट के लिए ज़रूरी दायरों का अपने-आप पता लगाती है और उन्हें शामिल करती है,
हालाँकि, अगर आपको अपने स्कोप सेट करने हैं, तो
साफ़ तौर पर आपको UrlFetchApp
का इस्तेमाल करने के लिए इस स्कोप को मैन्युअल रूप से जोड़ना होगा.
इन्हें भी देखें
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
fetch(url) | HTTPResponse | किसी यूआरएल को फ़ेच करने का अनुरोध करता है. |
fetch(url, params) | HTTPResponse | बेहतर वैकल्पिक पैरामीटर का इस्तेमाल करके, किसी यूआरएल को फ़ेच करने का अनुरोध किया जाता है. |
fetchAll(requests) | HTTPResponse[] | बेहतर वैकल्पिक पैरामीटर का इस्तेमाल करके, कई यूआरएल फ़ेच करने के लिए कई अनुरोध करता है. |
getRequest(url) | Object | कार्रवाई शुरू किए जाने पर किए गए अनुरोध की जानकारी देता है. |
getRequest(url, params) | Object | कार्रवाई शुरू किए जाने पर किए गए अनुरोध की जानकारी देता है. |
विस्तृत दस्तावेज़
fetch(url)
किसी यूआरएल को फ़ेच करने का अनुरोध करता है.
यह एचटीटीपी के साथ-साथ एचटीटीपीएस पर भी काम करता है.
// The code below logs the HTML code of the Google home page. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getContentText());
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
url | String | वह यूआरएल जिसे फ़ेच करना है. यूआरएल में ज़्यादा से ज़्यादा 2,082 वर्ण हो सकते हैं. |
वापसी का टिकट
HTTPResponse
— एचटीटीपी रिस्पॉन्स डेटा.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/script.external_request
fetch(url, params)
बेहतर वैकल्पिक पैरामीटर का इस्तेमाल करके, किसी यूआरएल को फ़ेच करने का अनुरोध किया जाता है.
यह एचटीटीपी के साथ-साथ एचटीटीपीएस पर भी काम करता है.
// Make a GET request and log the returned content. var response = UrlFetchApp.fetch('http://www.google.com/'); Logger.log(response.getContentText());
// Make a POST request with form data. var resumeBlob = Utilities.newBlob('Hire me!', 'text/plain', 'resume.txt'); var formData = { 'name': 'Bob Smith', 'email': 'bob@example.com', 'resume': resumeBlob }; // Because payload is a JavaScript object, it is interpreted as // as form data. (No need to specify contentType; it automatically // defaults to either 'application/x-www-form-urlencoded' // or 'multipart/form-data') var options = { 'method' : 'post', 'payload' : formData }; UrlFetchApp.fetch('https://httpbin.org/post', options);
// Make a POST request with a JSON payload. var data = { 'name': 'Bob Smith', 'age': 35, 'pets': ['fido', 'fluffy'] }; var options = { 'method' : 'post', 'contentType': 'application/json', // Convert the JavaScript object to a JSON string. 'payload' : JSON.stringify(data) }; UrlFetchApp.fetch('https://httpbin.org/post', options);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
url | String | वह यूआरएल जिसे फ़ेच करना है. यूआरएल में ज़्यादा से ज़्यादा 2,082 वर्ण हो सकते हैं. |
params | Object | बेहतर पैरामीटर तय करने वाला वैकल्पिक JavaScript ऑब्जेक्ट. इसकी जानकारी नीचे दी गई है. |
उन्नत पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
contentType | String | सामग्री प्रकार (डिफ़ॉल्ट रूप से 'application/x-www-form-urlencoded'). कॉन्टेंट टाइप का दूसरा उदाहरण 'application/xml; charset=utf-8'. |
headers | Object | अनुरोध के लिए एचटीटीपी हेडर का JavaScript की/वैल्यू मैप |
method | String | अनुरोध के लिए एचटीटीपी तरीका: get , delete ,
patch , post या put . डिफ़ॉल्ट वैल्यू get है. |
payload | String | वह पेलोड (यानी, पीओएसटी का मुख्य हिस्सा) होता है. कुछ एचटीटीपी तरीके (जैसे कि GET) पेलोड को स्वीकार नहीं करते हैं. यह कोई स्ट्रिंग, बाइट अरे, BLOB या JavaScript ऑब्जेक्ट मौजूद होता है. JavaScript ऑब्जेक्ट को फ़ॉर्म फ़ील्ड के मैप के तौर पर समझा जाता है नाम से डाली जाती हैं, जहां वैल्यू या तो स्ट्रिंग या ब्लॉब हो सकती हैं. |
useIntranet | Boolean | समर्थन नहीं होना या रुकना. यह बताए गए समाधान के लिए फ़ेच का निर्देश देता है SDC के ज़रिए आपके डोमेन से जुड़े इंट्रानेट में मौजूद यूआरएल (अब सेवा में नहीं है) |
validateHttpsCertificates | Boolean | अगर false फ़ेच किसी भी वैल्यू को अनदेखा करता है
एचटीटीपीएस अनुरोधों के लिए अमान्य सर्टिफ़िकेट. डिफ़ॉल्ट वैल्यू true है. |
followRedirects | Boolean | अगर false फ़ेच अपने-आप नहीं होता
एचटीटीपी रीडायरेक्ट को फ़ॉलो करना; यह ओरिजनल एचटीटीपी रिस्पॉन्स दिखाता है. डिफ़ॉल्ट वैल्यू true है. |
muteHttpExceptions | Boolean | अगर true फ़ेच नहीं करता है
अपवाद, अगर रिस्पॉन्स कोड गड़बड़ी के बारे में बताता है और इसके बजाय HTTPResponse दिखाता है. डिफ़ॉल्ट वैल्यू false है. |
escaping | Boolean | अगर यूआरएल में false रिज़र्व वर्ण नहीं हैं
एस्केप किया गया. डिफ़ॉल्ट वैल्यू true है. |
वापसी का टिकट
HTTPResponse
— एचटीटीपी रिस्पॉन्स डेटा.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/script.external_request
fetchAll(requests)
बेहतर वैकल्पिक पैरामीटर का इस्तेमाल करके, कई यूआरएल फ़ेच करने के लिए कई अनुरोध करता है.
यह एचटीटीपी के साथ-साथ एचटीटीपीएस पर भी काम करता है.
// Make both a POST request with form data, and a GET request. var resumeBlob = Utilities.newBlob('Hire me!', 'text/plain', 'resume.txt'); var formData = { 'name': 'Bob Smith', 'email': 'bob@example.com', 'resume': resumeBlob }; // Because payload is a JavaScript object, it is interpreted as // as form data. (No need to specify contentType; it defaults to either // 'application/x-www-form-urlencoded' or 'multipart/form-data') var request1 = { 'url': 'https://httpbin.org/post', 'method' : 'post', 'payload' : formData }; // A request may also just be a URL. var request2 = 'https://httpbin.org/get?key=value'; UrlFetchApp.fetchAll([request1, request2]);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
requests | Object[] | यूआरएल या JavaScript ऑब्जेक्ट का कलेक्शन, जिसमें तय किए गए अनुरोध के हिसाब से अनुरोध शामिल किए गए हैं देखें. |
उन्नत पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
url | String | वह यूआरएल जिसे फ़ेच करना है. यूआरएल में ज़्यादा से ज़्यादा 2,082 वर्ण हो सकते हैं. |
contentType | String | सामग्री प्रकार (डिफ़ॉल्ट रूप से 'application/x-www-form-urlencoded'). कॉन्टेंट टाइप का दूसरा उदाहरण 'application/xml; charset=utf-8'. |
headers | Object | अनुरोध के लिए एचटीटीपी हेडर का JavaScript की/वैल्यू मैप |
method | String | अनुरोध के लिए एचटीटीपी तरीका: get , delete ,
patch , post या put . डिफ़ॉल्ट वैल्यू get है. |
payload | String | वह पेलोड (यानी, पीओएसटी का मुख्य हिस्सा) होता है. कुछ एचटीटीपी तरीके (जैसे कि GET) पेलोड को स्वीकार नहीं करते हैं. यह कोई स्ट्रिंग, बाइट अरे, BLOB या JavaScript ऑब्जेक्ट मौजूद होता है. JavaScript ऑब्जेक्ट को फ़ॉर्म फ़ील्ड के मैप के तौर पर समझा जाता है नाम से डाली जाती हैं, जहां वैल्यू या तो स्ट्रिंग या ब्लॉब हो सकती हैं. |
useIntranet | Boolean | समर्थन नहीं होना या रुकना. यह बताए गए समाधान के लिए फ़ेच का निर्देश देता है SDC के ज़रिए आपके डोमेन से जुड़े इंट्रानेट में मौजूद यूआरएल (अब सेवा में नहीं है) |
validateHttpsCertificates | Boolean | अगर false फ़ेच किसी भी वैल्यू को अनदेखा करता है
एचटीटीपीएस अनुरोधों के लिए अमान्य सर्टिफ़िकेट. डिफ़ॉल्ट वैल्यू true है. |
followRedirects | Boolean | अगर false फ़ेच अपने-आप नहीं होता
एचटीटीपी रीडायरेक्ट को फ़ॉलो करना; यह ओरिजनल एचटीटीपी रिस्पॉन्स दिखाता है. डिफ़ॉल्ट वैल्यू true है. |
muteHttpExceptions | Boolean | अगर true है, तो फ़ेच
अपवाद, अगर रिस्पॉन्स कोड गड़बड़ी के बारे में बताता है और इसके बजाय HTTPResponse दिखाता है. डिफ़ॉल्ट वैल्यू false है. |
escaping | Boolean | अगर false है, तो यूआरएल में रिज़र्व वर्ण नहीं हैं
एस्केप किया गया. डिफ़ॉल्ट वैल्यू true है. |
वापसी का टिकट
HTTPResponse[]
— हर इनपुट अनुरोध से मिले एचटीटीपी रिस्पॉन्स डेटा का कलेक्शन.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/script.external_request
getRequest(url)
कार्रवाई शुरू किए जाने पर किए गए अनुरोध की जानकारी देता है.
इस तरीके से असल में अनुरोध नहीं किया जाता.
// The code below logs the value for every key of the returned map. var response = UrlFetchApp.getRequest("http://www.google.com/"); for(i in response) { Logger.log(i + ": " + response[i]); }
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
url | String | खोजा जाने वाला यूआरएल. यूआरएल में ज़्यादा से ज़्यादा 2,082 वर्ण हो सकते हैं. |
वापसी का टिकट
Object
— फ़ील्ड के नाम की वैल्यू का मैप. मैप में कम से कम ये कुंजियां मौजूद होती हैं: url
,
method
, contentType
, payload
, और headers
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/script.external_request
getRequest(url, params)
कार्रवाई शुरू किए जाने पर किए गए अनुरोध की जानकारी देता है.
इस तरीके से असल में अनुरोध नहीं किया जाता.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
url | String | खोजा जाने वाला यूआरएल. यूआरएल में ज़्यादा से ज़्यादा 2,082 वर्ण हो सकते हैं. |
params | Object | बेहतर पैरामीटर तय करने वाला एक वैकल्पिक JavaScript ऑब्जेक्ट, जैसा कि नीचे बताया गया है. |
उन्नत पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
contentType | String | सामग्री प्रकार (डिफ़ॉल्ट रूप से 'application/x-www-form-urlencoded'). कॉन्टेंट टाइप का दूसरा उदाहरण 'application/xml; charset=utf-8'. |
headers | Object | अनुरोध के लिए एचटीटीपी हेडर का JavaScript की/वैल्यू मैप |
method | String | अनुरोध के लिए एचटीटीपी तरीका: get , delete ,
patch , post या put . डिफ़ॉल्ट वैल्यू get है. |
payload | String | वह पेलोड (यानी, पीओएसटी का मुख्य हिस्सा) होता है. कुछ एचटीटीपी तरीके (जैसे कि GET) पेलोड को स्वीकार नहीं करते हैं. यह कोई स्ट्रिंग, बाइट अरे, BLOB या JavaScript ऑब्जेक्ट मौजूद होता है. JavaScript ऑब्जेक्ट को फ़ॉर्म फ़ील्ड के मैप के तौर पर समझा जाता है नाम से डाली जाती हैं, जहां वैल्यू या तो स्ट्रिंग या ब्लॉब हो सकती हैं. |
useIntranet | Boolean | समर्थन नहीं होना या रुकना. यह बताए गए समाधान के लिए फ़ेच का निर्देश देता है SDC के ज़रिए आपके डोमेन से जुड़े इंट्रानेट में मौजूद यूआरएल (अब सेवा में नहीं है) |
validateHttpsCertificates | Boolean | अगर false फ़ेच किसी भी वैल्यू को अनदेखा करता है
एचटीटीपीएस अनुरोधों के लिए अमान्य सर्टिफ़िकेट. डिफ़ॉल्ट वैल्यू true है. |
followRedirects | Boolean | अगर false फ़ेच अपने-आप नहीं होता
एचटीटीपी रीडायरेक्ट को फ़ॉलो करना; यह ओरिजनल एचटीटीपी रिस्पॉन्स दिखाता है. डिफ़ॉल्ट वैल्यू true है. |
muteHttpExceptions | Boolean | अगर true फ़ेच नहीं करता है
अपवाद, अगर रिस्पॉन्स कोड गड़बड़ी के बारे में बताता है और इसके बजाय HTTPResponse दिखाता है. डिफ़ॉल्ट वैल्यू false है. |
escaping | Boolean | अगर यूआरएल में false रिज़र्व वर्ण नहीं हैं
एस्केप किया गया. डिफ़ॉल्ट वैल्यू true है. |
वापसी का टिकट
Object
— फ़ील्ड के नाम की वैल्यू का मैप. मैप में कम से कम ये कुंजियां मौजूद होती हैं: url
,
method
, contentType
, payload
, और headers
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/script.external_request