此服务允许脚本通过提取网址来访问网络上的其他资源。脚本可以使用 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 | 返回调用操作时发出的请求。 |