URL Fetch Service

网址提取

此服务允许脚本通过提取网址来访问 Web 上的其他资源。脚本可以使用 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 脚本会自动检测并包含脚本所需的范围，但 如果您要 明确设置范围 ，则必须手动添加此范围才能使用 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	返回在调用该操作时发出的请求。