URL Fetch Service | Apps Script | Google for Developers (original) (raw)
URL Fetch Service
Stay organized with collections Save and categorize content based on your preferences.
URL Fetch
This service allows scripts to access other resources on the web by fetching URLs. A script can use the UrlFetch service to issue HTTP and HTTPS requests and receive responses. The UrlFetch service uses Google's network infrastructure for efficiency and scaling purposes.
Requests made using this service originate from a set pool of IP ranges. You can look up the full list of IP addressesif you need to whitelist or approve these requests.
The default user agent string of UrlFetch service requests isMozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID).
This service requires the https://www.googleapis.com/auth/script.external_requestscope. In most cases Apps Script automatically detects and includes scopes a script needs, but if you aresetting your scopes explicitlyyou must manually add this scope to use UrlFetchApp.
See also
[HTTPResponse](/apps-script/reference/url-fetch/http-response)- Setting explicit scopes
Classes
| Name | Brief description |
|---|---|
| HTTPResponse | This class allows users to access specific information on HTTP responses. |
| UrlFetchApp | Fetch resources and communicate with other hosts over the Internet. |
[HTTPResponse](/apps-script/reference/url-fetch/http-response)
Methods
| Method | Return type | Brief description |
|---|---|---|
| getAllHeaders() | Object | Returns an attribute/value map of headers for the HTTP response, with headers that have multiple values returned as arrays. |
| getAs(contentType) | Blob | Return the data inside this object as a blob converted to the specified content type. |
| getBlob() | Blob | Return the data inside this object as a blob. |
| getContent() | Byte[] | Gets the raw binary content of an HTTP response. |
| getContentText() | String | Gets the content of an HTTP response encoded as a string. |
| getContentText(charset) | String | Returns the content of an HTTP response encoded as a string of the given charset. |
| getHeaders() | Object | Returns an attribute/value map of headers for the HTTP response. |
| getResponseCode() | Integer | Get the HTTP status code (200 for OK, etc.) of an HTTP response. |
[UrlFetchApp](/apps-script/reference/url-fetch/url-fetch-app)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-04 UTC.