Эта служба позволяет сценариям получать доступ к другим ресурсам в сети путем получения URL-адресов. Скрипт может использовать службу UrlFetch для отправки запросов HTTP и HTTPS и получения ответов. Служба UrlFetch использует сетевую инфраструктуру Google в целях эффективности и масштабирования.
Запросы, сделанные с использованием этой службы, исходят из заданного пула диапазонов IP-адресов. Вы можете просмотреть полный список IP-адресов, если вам нужно внести в белый список или одобрить эти запросы.
Для этой службы требуется область https://www.googleapis.com/auth/script.external_request
. В большинстве случаев Apps Script автоматически обнаруживает и включает области, необходимые сценарию, но если вы задаете области явно, вам придется вручную добавить эту область, чтобы использовать UrlFetchApp
.
Смотрите также
Классы
Имя | Краткое описание |
---|---|
HTTPResponse | Этот класс позволяет пользователям получать доступ к определенной информации об ответах HTTP. |
UrlFetchApp | Получайте ресурсы и общайтесь с другими хостами через Интернет. |
HTTPResponse
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
getAllHeaders() | Object | Возвращает карту атрибутов/значений заголовков для ответа HTTP, причем заголовки имеют несколько значений, возвращаемых в виде массивов. |
getAs(contentType) | Blob | Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента. |
getBlob() | Blob | Верните данные внутри этого объекта в виде большого двоичного объекта. |
getContent() | Byte[] | Получает необработанное двоичное содержимое ответа HTTP. |
getContentText() | String | Получает содержимое ответа HTTP, закодированное в виде строки. |
getContentText(charset) | String | Возвращает содержимое ответа HTTP, закодированное как строка заданной кодировки. |
getHeaders() | Object | Возвращает карту атрибутов/значений заголовков для ответа HTTP. |
getResponseCode() | Integer | Получите код состояния HTTP (200 для ОК и т. д.) HTTP-ответа. |
UrlFetchApp
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
fetch(url) | HTTPResponse | Делает запрос на получение URL-адреса. |
fetch(url, params) | HTTPResponse | Делает запрос на получение URL-адреса, используя дополнительные дополнительные параметры. |
fetchAll(requests) | HTTPResponse[] | Делает несколько запросов для получения нескольких URL-адресов, используя дополнительные дополнительные параметры. |
getRequest(url) | Object | Возвращает запрос, который был сделан, если операция была вызвана. |
getRequest(url, params) | Object | Возвращает запрос, который был выполнен, если была вызвана операция. |