इस सेवा की मदद से, स्क्रिप्ट यूआरएल फ़ेच करके वेब पर मौजूद अन्य संसाधनों को ऐक्सेस कर सकती हैं. कोई स्क्रिप्ट, UrlFetch सेवा का इस्तेमाल करके एचटीटीपी और एचटीटीपीएस अनुरोध भेज सकती है और जवाब पा सकती है. UrlFetch सेवा, Google के नेटवर्क इंफ़्रास्ट्रक्चर का इस्तेमाल करती है, ताकि बेहतर तरीके से काम किया जा सके और ज़्यादा से ज़्यादा लोगों तक पहुंचा जा सके.
इस सेवा का इस्तेमाल करके किए गए अनुरोध, आईपी पतों की एक तय सीमा से आते हैं. अगर आपको इन अनुरोधों को श्वेतसूची में शामिल करना है या स्वीकार करना है, तो आईपी पतों की पूरी सूची देखें.
UrlFetch सेवा के अनुरोधों की डिफ़ॉल्ट उपयोगकर्ता एजेंट स्ट्रिंग Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID) है.
इस सेवा के लिए https://www.googleapis.com/auth/script.external_request
स्कोप की ज़रूरत होती है. ज़्यादातर मामलों में, Apps Script अपने-आप उन स्कोप का पता लगा लेता है जिनकी स्क्रिप्ट को ज़रूरत होती है. हालांकि, अगर आपको स्कोप को साफ़ तौर पर सेट करना है, तो Url का इस्तेमाल करने के लिए, आपको इस स्कोप को मैन्युअल तरीके से जोड़ना होगा.
इन्हें भी देखें
क्लास
| नाम | संक्षिप्त विवरण |
|---|---|
HTTPResponse | इस क्लास की मदद से, उपयोगकर्ता एचटीटीपी रिस्पॉन्स के बारे में खास जानकारी ऐक्सेस कर सकते हैं. |
Url | इंटरनेट पर मौजूद संसाधनों को फ़ेच करना और अन्य होस्ट के साथ कम्यूनिकेट करना. |
HTTPResponse
तरीके
| तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
|---|---|---|
get | Object | यह फ़ंक्शन, एचटीटीपी रिस्पॉन्स के हेडर का एट्रिब्यूट/वैल्यू मैप दिखाता है. साथ ही, जिन हेडर की एक से ज़्यादा वैल्यू होती हैं उन्हें कलेक्शन के तौर पर दिखाता है. |
get | Blob | इस ऑब्जेक्ट में मौजूद डेटा को, बताए गए कॉन्टेंट टाइप में बदले गए ब्लॉब के तौर पर दिखाता है. |
get | Blob | इस ऑब्जेक्ट में मौजूद डेटा को blob के तौर पर दिखाओ. |
get | Byte[] | इस फ़ंक्शन से, एचटीटीपी रिस्पॉन्स का रॉ बाइनरी कॉन्टेंट मिलता है. |
get | String | यह फ़ंक्शन, एचटीटीपी रिस्पॉन्स के कॉन्टेंट को स्ट्रिंग के तौर पर एन्कोड करता है. |
get | String | यह फ़ंक्शन, एचटीटीपी रिस्पॉन्स के कॉन्टेंट को दिए गए वर्णसेट की स्ट्रिंग के तौर पर एन्कोड करके दिखाता है. |
get | Object | यह एचटीटीपी रिस्पॉन्स के लिए, हेडर का एट्रिब्यूट/वैल्यू मैप दिखाता है. |
get | Integer | एचटीटीपी रिस्पॉन्स का एचटीटीपी स्टेटस कोड (OK के लिए 200 वगैरह) पाएं. |
UrlFetchApp
तरीके
| तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
|---|---|---|
fetch(url) | HTTPResponse | यह कुकी, यूआरएल फ़ेच करने का अनुरोध करती है. |
fetch(url, params) | HTTPResponse | यह फ़ंक्शन, वैकल्पिक तौर पर उपलब्ध ऐडवांस पैरामीटर का इस्तेमाल करके, यूआरएल फ़ेच करने का अनुरोध करता है. |
fetch | HTTPResponse[] | यह वैकल्पिक ऐडवांस पैरामीटर का इस्तेमाल करके, कई यूआरएल फ़ेच करने के लिए कई अनुरोध करता है. |
get | Object | अगर कार्रवाई शुरू की गई थी, तो यह फ़ंक्शन उस अनुरोध को दिखाता है. |
get | Object | अगर कार्रवाई शुरू की जाती है, तो यह फ़ंक्शन उस अनुरोध को दिखाता है. |