URL Fetch Service

网址提取

此服务允许脚本通过提取网址来访问网络上的其他资源。脚本可以使用 UrlFetch 服务发出 HTTP 和 HTTPS 请求并接收响应。UrlFetch 服务使用 Google 的网络基础架构来提高效率和扩缩能力。

使用此服务发出的请求均来自一组 IP 范围池。如果您需要将这些请求列入白名单或批准,可以查找 IP 地址的完整列表

此服务需要 https://www.googleapis.com/auth/script.external_request 范围。在大多数情况下,Apps 脚本会自动检测并包含脚本所需的范围,但如果您要明确设置范围,则必须手动添加此范围才能使用 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返回在调用操作时发出的请求。