Эта служба позволяет сценариям получать доступ к другим ресурсам в сети путем получения URL-адресов. Скрипт может использовать службу 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 Script автоматически обнаруживает и включает области, необходимые сценарию, но если вы задаете области явно, вам придется вручную добавить эту область, чтобы использовать Url Fetch App .
См. также
Классы
| Имя | Краткое описание |
|---|---|
HTTPResponse | Этот класс позволяет пользователям получать доступ к определенной информации об ответах HTTP. |
Url Fetch App | Получайте ресурсы и общайтесь с другими хостами через Интернет. |
HTTPResponse
Методы
| Метод | Тип возврата | Краткое описание |
|---|---|---|
get All Headers() | Object | Возвращает карту атрибутов/значений заголовков для ответа HTTP, причем заголовки имеют несколько значений, возвращаемых в виде массивов. |
get As(contentType) | Blob | Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента. |
get Blob() | Blob | Верните данные внутри этого объекта в виде большого двоичного объекта. |
get Content() | Byte[] | Получает необработанное двоичное содержимое ответа HTTP. |
get Content Text() | String | Получает содержимое ответа HTTP, закодированное в виде строки. |
get Content Text(charset) | String | Возвращает содержимое ответа HTTP, закодированное как строка заданной кодировки. |
get Headers() | Object | Возвращает карту атрибутов/значений заголовков для ответа HTTP. |
get Response Code() | Integer | Получите код состояния HTTP (200 для ОК и т. д.) HTTP-ответа. |
Url Fetch App
Методы
| Метод | Тип возврата | Краткое описание |
|---|---|---|
fetch(url) | HTTPResponse | Делает запрос на получение URL-адреса. |
fetch(url, params) | HTTPResponse | Делает запрос на получение URL-адреса, используя дополнительные дополнительные параметры. |
fetch All(requests) | HTTPResponse[] | Делает несколько запросов на получение нескольких URL-адресов, используя дополнительные дополнительные параметры. |
get Request(url) | Object | Возвращает запрос, который был выполнен, если операция была вызвана. |
get Request(url, params) | Object | Возвращает запрос, который был выполнен, если была вызвана операция. |