URL Fetch Service

網址擷取

這項服務可讓指令碼透過擷取網址，存取網路上的其他資源。指令碼可使用 UrlFetch 服務，發出 HTTP 和 HTTPS 要求，然後接收回應。UrlFetch 服務會使用 Google 的網路基礎架構，以提高效率和擴充服務。

使用這項服務提出的要求會來自特定的 IP 範圍集區。如需將這些要求加入許可清單或核准，您可以查看完整的 IP 位址清單。

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 會自動偵測並納入指令碼所需的範圍，但如果您明確設定範圍，則必須手動新增此範圍才能使用 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 回應的 HTTP 狀態碼 (200 代表「OK」等)。

UrlFetchApp

方法

方法傳回類型簡短說明
fetch(url)HTTPResponse提出要求以擷取網址。
fetch(url, params)HTTPResponse使用選用的進階參數提出要求，以便擷取網址。
fetchAll(requests)HTTPResponse[]使用選用的進階參數提出多項要求，擷取多個網址。
getRequest(url)Object傳回在作業叫用時所提出的要求。
getRequest(url, params)Object傳回在作業叫用時所提出的要求。