URL Fetch Service

Recuperació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 escalabilidad.

Las solicitudes realizadas con este servicio se originan en un conjunto de rangos de IP. Puedes buscar la lista completa de direcciones IP si necesitas incluir en la lista blanca o aprobar estas solicitudes.

La cadena de agente de usuario predeterminada de las solicitudes del servicio UrlFetch es Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID).

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 agregar este permiso de forma manual para usar UrlFetchApp.

Consulta también

• HTTPResponse
• Cómo configurar permisos explícitos

Clases

Nombre	Descripción breve
HTTPResponse	Esta clase permite que los usuarios accedan 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 devuelve	Descripción breve
getAllHeaders()	Object	Devuelve un mapa de atributos/valores de encabezados para la respuesta HTTP, con encabezados que tienen varios valores que se muestran como arrays.
getAs(contentType)	Blob	Devuelve los datos dentro de este objeto como un blob convertido al tipo de contenido especificado.
getBlob()	Blob	Devuelve 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 cadena.
getContentText(charset)	String	Devuelve el contenido de una respuesta HTTP codificada como una cadena del conjunto de caracteres determinado.
getHeaders()	Object	Devuelve un mapa de atributos/valores de encabezados para la respuesta HTTP.
getResponseCode()	Integer	Obtiene el código de estado HTTP (200 para Aceptar, etc.) de una respuesta HTTP.

UrlFetchApp

Métodos

Método	Tipo de datos que se devuelve	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 URLs con parámetros avanzados opcionales.
getRequest(url)	Object	Devuelve la solicitud que se realiza si se invoca la operación.
getRequest(url, params)	Object	Devuelve la solicitud que se realiza si se invoca la operación.