本頁面由 Cloud Translation API 翻譯而成。

URL Fetch Service

這項服務可允許指令碼透過擷取網址的方式存取網路上的其他資源。指令碼可使用 UrlFetch 服務發出 HTTP 和 HTTPS 要求，並接收回應。UrlFetch 服務使用 Google 的網路基礎架構來提高效率與資源調度。

使用這項服務提出的要求源自一組 IP 範圍。如果需要將這些要求加入許可清單或核准，您可以查看 IP 位址的完整清單。

這項服務需要 https://www.googleapis.com/auth/script.external_request 範圍。在大多數情況下，Apps Script 會自動偵測並納入指令碼所需的範圍，但如果您要明確設定範圍，則必須手動新增此範圍才能使用 UrlFetchApp。

類別

名稱	簡短說明
`HTTPResponse`	這個類別可讓使用者存取 HTTP 回應的特定資訊。
`UrlFetchApp`	透過網際網路擷取資源並與其他主機通訊。

方法	傳回類型	簡短說明
`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 回應的 HTTP 狀態碼 (200 代表 OK 等等)。