Этот сервис позволяет скриптам получать доступ к другим ресурсам в сети путем получения 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 | Возвращает данные, содержащиеся в этом объекте, в виде двоичных данных (blob), преобразованных в указанный тип содержимого. |
get Blob() | 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 для OK и т. д.) HTTP-ответа. |
UrlFetchApp
Методы
| Метод | Тип возвращаемого значения | Краткое описание |
|---|---|---|
fetch(url) | HTTPResponse | Выполняет запрос на получение URL-адреса. |
fetch(url, params) | HTTPResponse | Выполняет запрос на получение URL-адреса, используя необязательные расширенные параметры. |
fetch All(requests) | HTTPResponse[] | Выполняет несколько запросов для получения нескольких URL-адресов, используя необязательные расширенные параметры. |
get Request(url) | Object | Возвращает запрос, который был отправлен, если операция была вызвана. |
get Request(url, params) | Object | Возвращает запрос, который был бы отправлен, если бы операция была вызвана. |