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
| Nome | Breve descrição |
|---|---|
HTTPResponse | Essa classe permite que os usuários acessem informações específicas sobre respostas HTTP. |
UrlFetchApp | Busque recursos e se comunique 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 | Retorne 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 | Receber 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 que será feita se a operação for invocada. |
getRequest(url, params) | Object | Retorna a solicitação que será feita se a operação for invocada. |