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 eficiência e escalonamento.

As solicitações feitas com esse serviço são originadas de um pool definido de intervalos de IP. Você pode consultar a lista completa de endereços IP se precisar colocar essas solicitações na lista de permissões ou aprovar.

Este 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 de que um script precisa. No entanto, se você definir os escopos explicitamente, adicione manualmente esse escopo para usar UrlFetchApp.

Veja também

Aulas

NomeBreve descrição
HTTPResponseEssa classe permite que os usuários acessem informações específicas sobre respostas HTTP.
UrlFetchAppBusque recursos e comunique-se com outros hosts pela Internet.

HTTPResponse

Métodos

MétodoTipo de retornoBreve descrição
getAllHeaders()ObjectRetorna um mapa de atributos/valores de cabeçalhos para a resposta HTTP, com cabeçalhos que têm vários valores retornados como matrizes.
getAs(contentType)BlobRetorne os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado.
getBlob()BlobRetorne os dados dentro desse objeto como um blob.
getContent()Byte[]Recebe o conteúdo binário bruto de uma resposta HTTP.
getContentText()StringRecebe o conteúdo de uma resposta HTTP codificada como uma string.
getContentText(charset)StringRetorna o conteúdo de uma resposta HTTP codificada como uma string do conjunto de caracteres especificado.
getHeaders()ObjectRetorna um mapa de atributos/valores dos cabeçalhos para a resposta HTTP.
getResponseCode()IntegerConsiga o código de status HTTP (200 para OK etc.) de uma resposta HTTP.

UrlFetchApp

Métodos

MétodoTipo de retornoBreve descrição
fetch(url)HTTPResponseFaz uma solicitação para buscar um URL.
fetch(url, params)HTTPResponseFaz 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)ObjectRetorna a solicitação feita se a operação tiver sido invocada.
getRequest(url, params)ObjectRetorna a solicitação que é feita se a operação tiver sido invocada.