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 originam-se de um pool definido de intervalos de IPs. Você pode procurar a lista completa de endereços IP se precisar autorizar ou aprovar essas solicitações.

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. No entanto, se você definir seus escopos explicitamente, será necessário adicionar manualmente esse escopo para usar UrlFetchApp.

Veja também

Classes

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

HTTPResponse

Métodos

MétodoTipo de retornoBreve descrição
getAllHeaders()ObjectRetorna 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)BlobRetorna 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 atributo/valor de cabeçalhos para a resposta HTTP.
getResponseCode()IntegerReceber 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 que será feita se a operação for invocada.
getRequest(url, params)ObjectRetorna a solicitação que será feita se a operação for invocada.