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
• 設定明確範圍

類別

名稱	簡短說明
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 表示正常等)。

UrlFetchApp

方法

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