Este servicio permite que las secuencias de comandos accedan a otros recursos en la Web mediante la recuperación de URL. Una secuencia de comandos puede usar el servicio UrlFetch para emitir solicitudes HTTP y HTTPS y recibir respuestas. El servicio UrlFetch usa la infraestructura de red de Google para fines de eficiencia y escalamiento.
Las solicitudes realizadas con este servicio se originan en un grupo determinado de rangos de IP. Puedes buscar la lista completa de direcciones IP si necesitas incluir estas solicitudes en la lista blanca o aprobarlas.
Este servicio requiere el alcance https://www.googleapis.com/auth/script.external_request. En la mayoría de los casos, Apps Script detecta y, además, incluye automáticamente los alcances que necesita una secuencia de comandos, pero si configuras los alcances de forma explícita, debes agregar este permiso de forma manual para usar UrlFetchApp.
Consulta también
Clases
| Nombre | Descripción breve |
|---|---|
HTTPResponse | Esta clase permite a los usuarios acceder a información específica sobre las respuestas HTTP. |
UrlFetchApp | Recupera recursos y comunícate con otros hosts a través de Internet. |
HTTPResponse
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
|---|---|---|
getAllHeaders() | Object | Muestra un atributo/valor de asignación de encabezados para la respuesta HTTP, con encabezados que tienen múltiples valores mostrados como arreglos. |
getAs(contentType) | Blob | Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado. |
getBlob() | Blob | Muestra los datos dentro de este objeto como un BLOB. |
getContent() | Byte[] | Obtiene el contenido binario sin procesar de una respuesta HTTP. |
getContentText() | String | Obtiene el contenido de una respuesta HTTP codificada como una string. |
getContentText(charset) | String | Muestra el contenido de una respuesta HTTP codificada como una string del charset determinado. |
getHeaders() | Object | Muestra una asignación de atributo/valor de los encabezados para la respuesta HTTP. |
getResponseCode() | Integer | Obtén el código de estado HTTP (200 para OK, etc.) de una respuesta HTTP. |
UrlFetchApp
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
|---|---|---|
fetch(url) | HTTPResponse | Realiza una solicitud para recuperar una URL. |
fetch(url, params) | HTTPResponse | Realiza una solicitud para recuperar una URL con parámetros avanzados opcionales. |
fetchAll(requests) | HTTPResponse[] | Realiza varias solicitudes para recuperar varias URL con parámetros avanzados opcionales. |
getRequest(url) | Object | Muestra la solicitud que se realiza si se invocó la operación. |
getRequest(url, params) | Object | Muestra la solicitud que se realiza si se invocó la operación. |