Class UrlFetchApp

UrlFetchApp

संसाधन फ़ेच करें और इंटरनेट पर अन्य होस्ट से बातचीत करें.

यह सेवा, स्क्रिप्ट को अन्य ऐप्लिकेशन से संपर्क करने या अन्य संसाधनों को ऐक्सेस करने की अनुमति देती है यूआरएल फ़ेच करके, उन्हें वेब पर डाला जा सकता है. स्क्रिप्ट, एचटीटीपी और एचटीटीपीएस से जुड़ी समस्या हल करने के लिए, यूआरएल फ़ेच सेवा का इस्तेमाल कर सकती है आप अपने सवालों के जवाब पा सकते हैं. 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());

पैरामीटर

नामटाइपब्यौरा
urlStringवह यूआरएल जिसे फ़ेच करना है. यूआरएल में ज़्यादा से ज़्यादा 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);

पैरामीटर

नामटाइपब्यौरा
urlStringवह यूआरएल जिसे फ़ेच करना है. यूआरएल में ज़्यादा से ज़्यादा 2,082 वर्ण हो सकते हैं.
paramsObjectबेहतर पैरामीटर तय करने वाला वैकल्पिक JavaScript ऑब्जेक्ट. इसकी जानकारी नीचे दी गई है.

उन्नत पैरामीटर

नामटाइपब्यौरा
contentTypeStringसामग्री प्रकार (डिफ़ॉल्ट रूप से 'application/x-www-form-urlencoded'). कॉन्टेंट टाइप का दूसरा उदाहरण 'application/xml; charset=utf-8'.
headersObjectअनुरोध के लिए एचटीटीपी हेडर का JavaScript की/वैल्यू मैप
methodStringअनुरोध के लिए एचटीटीपी तरीका: get, delete, patch, post या put. डिफ़ॉल्ट वैल्यू get है.
payloadStringवह पेलोड (यानी, पीओएसटी का मुख्य हिस्सा) होता है. कुछ एचटीटीपी तरीके (जैसे कि GET) पेलोड को स्वीकार नहीं करते हैं. यह कोई स्ट्रिंग, बाइट अरे, BLOB या JavaScript ऑब्जेक्ट मौजूद होता है. JavaScript ऑब्जेक्ट को फ़ॉर्म फ़ील्ड के मैप के तौर पर समझा जाता है नाम से डाली जाती हैं, जहां वैल्यू या तो स्ट्रिंग या ब्लॉब हो सकती हैं.
useIntranetBooleanसमर्थन नहीं होना या रुकना. यह बताए गए समाधान के लिए फ़ेच का निर्देश देता है SDC के ज़रिए आपके डोमेन से जुड़े इंट्रानेट में मौजूद यूआरएल (अब सेवा में नहीं है)
validateHttpsCertificatesBooleanअगर false फ़ेच किसी भी वैल्यू को अनदेखा करता है एचटीटीपीएस अनुरोधों के लिए अमान्य सर्टिफ़िकेट. डिफ़ॉल्ट वैल्यू true है.
followRedirectsBooleanअगर false फ़ेच अपने-आप नहीं होता एचटीटीपी रीडायरेक्ट को फ़ॉलो करना; यह ओरिजनल एचटीटीपी रिस्पॉन्स दिखाता है. डिफ़ॉल्ट वैल्यू true है.
muteHttpExceptionsBooleanअगर true फ़ेच नहीं करता है अपवाद, अगर रिस्पॉन्स कोड गड़बड़ी के बारे में बताता है और इसके बजाय HTTPResponse दिखाता है. डिफ़ॉल्ट वैल्यू false है.
escapingBooleanअगर यूआरएल में 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]);

पैरामीटर

नामटाइपब्यौरा
requestsObject[]यूआरएल या JavaScript ऑब्जेक्ट का कलेक्शन, जिसमें तय किए गए अनुरोध के हिसाब से अनुरोध शामिल किए गए हैं देखें.

उन्नत पैरामीटर

नामटाइपब्यौरा
urlStringवह यूआरएल जिसे फ़ेच करना है. यूआरएल में ज़्यादा से ज़्यादा 2,082 वर्ण हो सकते हैं.
contentTypeStringसामग्री प्रकार (डिफ़ॉल्ट रूप से 'application/x-www-form-urlencoded'). कॉन्टेंट टाइप का दूसरा उदाहरण 'application/xml; charset=utf-8'.
headersObjectअनुरोध के लिए एचटीटीपी हेडर का JavaScript की/वैल्यू मैप
methodStringअनुरोध के लिए एचटीटीपी तरीका: get, delete, patch, post या put. डिफ़ॉल्ट वैल्यू get है.
payloadStringवह पेलोड (यानी, पीओएसटी का मुख्य हिस्सा) होता है. कुछ एचटीटीपी तरीके (जैसे कि GET) पेलोड को स्वीकार नहीं करते हैं. यह कोई स्ट्रिंग, बाइट अरे, BLOB या JavaScript ऑब्जेक्ट मौजूद होता है. JavaScript ऑब्जेक्ट को फ़ॉर्म फ़ील्ड के मैप के तौर पर समझा जाता है नाम से डाली जाती हैं, जहां वैल्यू या तो स्ट्रिंग या ब्लॉब हो सकती हैं.
useIntranetBooleanसमर्थन नहीं होना या रुकना. यह बताए गए समाधान के लिए फ़ेच का निर्देश देता है SDC के ज़रिए आपके डोमेन से जुड़े इंट्रानेट में मौजूद यूआरएल (अब सेवा में नहीं है)
validateHttpsCertificatesBooleanअगर false फ़ेच किसी भी वैल्यू को अनदेखा करता है एचटीटीपीएस अनुरोधों के लिए अमान्य सर्टिफ़िकेट. डिफ़ॉल्ट वैल्यू true है.
followRedirectsBooleanअगर false फ़ेच अपने-आप नहीं होता एचटीटीपी रीडायरेक्ट को फ़ॉलो करना; यह ओरिजनल एचटीटीपी रिस्पॉन्स दिखाता है. डिफ़ॉल्ट वैल्यू true है.
muteHttpExceptionsBooleanअगर true है, तो फ़ेच अपवाद, अगर रिस्पॉन्स कोड गड़बड़ी के बारे में बताता है और इसके बजाय HTTPResponse दिखाता है. डिफ़ॉल्ट वैल्यू false है.
escapingBooleanअगर 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]);
}

पैरामीटर

नामटाइपब्यौरा
urlStringखोजा जाने वाला यूआरएल. यूआरएल में ज़्यादा से ज़्यादा 2,082 वर्ण हो सकते हैं.

वापसी का टिकट

Object — फ़ील्ड के नाम की वैल्यू का मैप. मैप में कम से कम ये कुंजियां मौजूद होती हैं: url, method, contentType, payload, और headers.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:

  • https://www.googleapis.com/auth/script.external_request

getRequest(url, params)

कार्रवाई शुरू किए जाने पर किए गए अनुरोध की जानकारी देता है.

इस तरीके से असल में अनुरोध नहीं किया जाता.

पैरामीटर

नामटाइपब्यौरा
urlStringखोजा जाने वाला यूआरएल. यूआरएल में ज़्यादा से ज़्यादा 2,082 वर्ण हो सकते हैं.
paramsObjectबेहतर पैरामीटर तय करने वाला एक वैकल्पिक JavaScript ऑब्जेक्ट, जैसा कि नीचे बताया गया है.

उन्नत पैरामीटर

नामटाइपब्यौरा
contentTypeStringसामग्री प्रकार (डिफ़ॉल्ट रूप से 'application/x-www-form-urlencoded'). कॉन्टेंट टाइप का दूसरा उदाहरण 'application/xml; charset=utf-8'.
headersObjectअनुरोध के लिए एचटीटीपी हेडर का JavaScript की/वैल्यू मैप
methodStringअनुरोध के लिए एचटीटीपी तरीका: get, delete, patch, post या put. डिफ़ॉल्ट वैल्यू get है.
payloadStringवह पेलोड (यानी, पीओएसटी का मुख्य हिस्सा) होता है. कुछ एचटीटीपी तरीके (जैसे कि GET) पेलोड को स्वीकार नहीं करते हैं. यह कोई स्ट्रिंग, बाइट अरे, BLOB या JavaScript ऑब्जेक्ट मौजूद होता है. JavaScript ऑब्जेक्ट को फ़ॉर्म फ़ील्ड के मैप के तौर पर समझा जाता है नाम से डाली जाती हैं, जहां वैल्यू या तो स्ट्रिंग या ब्लॉब हो सकती हैं.
useIntranetBooleanसमर्थन नहीं होना या रुकना. यह बताए गए समाधान के लिए फ़ेच का निर्देश देता है SDC के ज़रिए आपके डोमेन से जुड़े इंट्रानेट में मौजूद यूआरएल (अब सेवा में नहीं है)
validateHttpsCertificatesBooleanअगर false फ़ेच किसी भी वैल्यू को अनदेखा करता है एचटीटीपीएस अनुरोधों के लिए अमान्य सर्टिफ़िकेट. डिफ़ॉल्ट वैल्यू true है.
followRedirectsBooleanअगर false फ़ेच अपने-आप नहीं होता एचटीटीपी रीडायरेक्ट को फ़ॉलो करना; यह ओरिजनल एचटीटीपी रिस्पॉन्स दिखाता है. डिफ़ॉल्ट वैल्यू true है.
muteHttpExceptionsBooleanअगर true फ़ेच नहीं करता है अपवाद, अगर रिस्पॉन्स कोड गड़बड़ी के बारे में बताता है और इसके बजाय HTTPResponse दिखाता है. डिफ़ॉल्ट वैल्यू false है.
escapingBooleanअगर यूआरएल में false रिज़र्व वर्ण नहीं हैं एस्केप किया गया. डिफ़ॉल्ट वैल्यू true है.

वापसी का टिकट

Object — फ़ील्ड के नाम की वैल्यू का मैप. मैप में कम से कम ये कुंजियां मौजूद होती हैं: url, method, contentType, payload, और headers.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:

  • https://www.googleapis.com/auth/script.external_request