URL Fetch Service

Obtención de URL

Este servicio permite que las secuencias de comandos accedan a otros recursos en la Web mediante la recuperación de URLs. 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 que se realizan con este servicio provienen de un grupo establecido de rangos de IP. Puedes buscar la lista completa de direcciones IP si necesitas incluir estas solicitudes en la lista de entidades permitidas o aprobarlas.

Este servicio requiere el permiso https://www.googleapis.com/auth/script.external_request. En la mayoría de los casos, Apps Script detecta e incluye automáticamente los permisos que necesita una secuencia de comandos, pero si configuras tus permisos de forma explícita, debes agregarlos de forma manual para usar UrlFetchApp.

Consulta también

Clases

NombreDescripción breve
HTTPResponseEsta clase permite que los usuarios accedan a información específica sobre las respuestas HTTP.
UrlFetchAppRecupera recursos y comunícate con otros hosts a través de Internet.

HTTPResponse

Métodos

MétodoTipo de datos que se muestraDescripción breve
getAllHeaders()ObjectMuestra un mapa de atributos/valores de encabezados para la respuesta HTTP, con encabezados que tienen varios valores que se muestran como arrays.
getAs(contentType)BlobMuestra los datos dentro de este objeto como un blob convertido al tipo de contenido especificado.
getBlob()BlobDevuelve los datos dentro de este objeto como un blob.
getContent()Byte[]Obtiene el contenido binario sin procesar de una respuesta HTTP.
getContentText()StringObtiene el contenido de una respuesta HTTP codificada como una cadena.
getContentText(charset)StringMuestra el contenido de una respuesta HTTP codificada como una cadena del conjunto de caracteres determinado.
getHeaders()ObjectMuestra un mapa de atributos/valores de encabezados para la respuesta HTTP.
getResponseCode()IntegerObtén el código de estado HTTP (200 para OK, etc.) de una respuesta HTTP.

UrlFetchApp

Métodos

MétodoTipo de datos que se muestraDescripción breve
fetch(url)HTTPResponseRealiza una solicitud para recuperar una URL.
fetch(url, params)HTTPResponseRealiza una solicitud para recuperar una URL con parámetros avanzados opcionales.
fetchAll(requests)HTTPResponse[]Realiza varias solicitudes para recuperar varias URLs con parámetros avanzados opcionales.
getRequest(url)ObjectMuestra la solicitud que se realiza si se invocó la operación.
getRequest(url, params)ObjectMuestra la solicitud que se realiza si se invocó la operación.