URL Fetch Service

Busca de URL

Esse serviço permite que os scripts acessem outros recursos na Web buscando URLs. Um script pode usar o serviço UrlFetch para emitir solicitações HTTP e HTTPS e receber respostas. O serviço UrlFetch usa a infraestrutura de rede do Google para fins de eficiência e escalonamento.

As solicitações feitas usando esse serviço são originadas de um pool fixo de intervalos de IP. Você pode consultar a lista completa de endereços IP se precisar colocar esses pedidos na lista de permissões ou aprová-los.

A string do user agent padrão das solicitações do serviço UrlFetch é Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID).

Esse serviço requer o escopo https://www.googleapis.com/auth/script.external_request. Na maioria dos casos, o Apps Script detecta e inclui automaticamente os escopos necessários para um script, mas se você estiver definindo seus escopos explicitamente adicione manualmente esse escopo para usar UrlFetchApp.

Consulte também

• HTTPResponse
• Como definir escopos explícitos

Classes

Nome	Breve descrição
HTTPResponse	Essa classe permite que os usuários acessem informações específicas sobre respostas HTTP.
UrlFetchApp	Buscar recursos e se comunicar com outros hosts pela Internet.

HTTPResponse

Métodos

Método	Tipo de retorno	Breve descrição
getAllHeaders()	Object	Retorna um mapa de atributo/valor de cabeçalhos para a resposta HTTP, com cabeçalhos que têm vários valores retornados como matrizes.
getAs(contentType)	Blob	Retorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado.
getBlob()	Blob	Retorna os dados dentro desse objeto como um blob.
getContent()	Byte[]	Recebe o conteúdo binário bruto de uma resposta HTTP.
getContentText()	String	Recebe o conteúdo de uma resposta HTTP codificada como uma string.
getContentText(charset)	String	Retorna o conteúdo de uma resposta HTTP codificada como uma string do conjunto de caracteres especificado.
getHeaders()	Object	Retorna um mapa de atributo/valor de cabeçalhos para a resposta HTTP.
getResponseCode()	Integer	Recebe o código de status HTTP (200 para OK etc.) de uma resposta HTTP.

UrlFetchApp

Métodos

Método	Tipo de retorno	Breve descrição
fetch(url)	HTTPResponse	Faz uma solicitação para buscar um URL.
fetch(url, params)	HTTPResponse	Faz uma solicitação para buscar um URL usando parâmetros avançados opcionais.
fetchAll(requests)	HTTPResponse[]	Faz várias solicitações para buscar vários URLs usando parâmetros avançados opcionais.
getRequest(url)	Object	Retorna a solicitação feita se a operação foi invocada.
getRequest(url, params)	Object	Retorna a solicitação que seria feita se a operação fosse invocada.