บริการนี้ช่วยให้สคริปต์สามารถเข้าถึงทรัพยากรอื่นๆ บนเว็บโดยการดึงข้อมูล URL สคริปต์สามารถใช้บริการ UrlFetch เพื่อส่งคําขอ HTTP และ HTTPS และรับการตอบกลับได้ บริการ UrlFetch ใช้โครงสร้างพื้นฐานเครือข่ายของ Google เพื่อประสิทธิภาพและการปรับขนาด
คําขอที่ใช้บริการนี้จะเริ่มต้นจากชุดช่วง IP คุณสามารถค้นหารายการที่อยู่ IP ทั้งหมดได้หากต้องการอนุญาตหรืออนุมัติคําขอเหล่านี้
บริการนี้ต้องใช้ขอบเขต https://www.googleapis.com/auth/script.external_request
ในกรณีส่วนใหญ่ Apps Script จะตรวจจับและรวมขอบเขตที่สคริปต์ต้องการโดยอัตโนมัติ
แต่หากคุณกําหนดขอบเขตอย่างชัดเจน
คุณต้องเพิ่มขอบเขตนี้ด้วยตนเองเพื่อใช้ UrlFetchApp
ดูเพิ่มเติม
ชั้นเรียน
ชื่อ | รายละเอียดแบบย่อ |
---|---|
HTTPResponse | คลาสนี้อนุญาตให้ผู้ใช้เข้าถึงข้อมูลที่เจาะจงเกี่ยวกับการตอบกลับ HTTP |
UrlFetchApp | ดึงข้อมูลและสื่อสารกับโฮสต์อื่นๆ ทางอินเทอร์เน็ต |
HTTPResponse
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
getAllHeaders() | Object | แสดงผลแมปแอตทริบิวต์/ค่าของส่วนหัวสําหรับการตอบกลับ HTTP โดยมีส่วนหัวที่แสดงค่าหลายค่าเป็นอาร์เรย์ |
getAs(contentType) | Blob | ส่งคืนข้อมูลภายในออบเจ็กต์นี้เป็น BLOB ที่แปลงเป็นประเภทเนื้อหาที่ระบุ |
getBlob() | Blob | ส่งคืนข้อมูลภายในออบเจ็กต์นี้เป็น BLOB |
getContent() | Byte[] | รับเนื้อหาไบนารีดิบของการตอบกลับ HTTP |
getContentText() | String | รับเนื้อหาของการตอบกลับ HTTP ซึ่งเข้ารหัสเป็นสตริง |
getContentText(charset) | String | แสดงผลเนื้อหาของการตอบกลับ HTTP ที่เข้ารหัสเป็นสตริงของชุดอักขระที่ระบุ |
getHeaders() | Object | แสดงผลการจับคู่แอตทริบิวต์/ค่าของส่วนหัวสําหรับการตอบกลับ HTTP |
getResponseCode() | Integer | รับรหัสสถานะ HTTP (200 สําหรับดี ฯลฯ) ของการตอบกลับ HTTP |
UrlFetchApp
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
fetch(url) | HTTPResponse | ส่งคําขอดึงข้อมูล URL |
fetch(url, params) | HTTPResponse | ส่งคําขอดึงข้อมูล URL โดยใช้พารามิเตอร์ขั้นสูงที่ไม่บังคับ |
fetchAll(requests) | HTTPResponse[] | ส่งคําขอหลายรายการเพื่อดึงข้อมูล URL หลายรายการโดยใช้พารามิเตอร์ขั้นสูงที่ไม่บังคับ |
getRequest(url) | Object | แสดงผลคําขอที่มีการเรียกใช้หากเรียกใช้การดําเนินการ |
getRequest(url, params) | Object | แสดงผลคําขอที่สร้างขึ้นหากมีการดําเนินการ |