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
| Nome | Breve descrição |
|---|---|
HTTPResponse | Essa classe permite que os usuários acessem informações específicas sobre respostas HTTP. |
UrlFetchApp | Busque recursos e comunique-se com outros hosts pela Internet. |
HTTPResponse
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
getAllHeaders() | Object | Retorna 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) | Blob | Retorne 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 atributos/valores dos cabeçalhos para a resposta HTTP. |
getResponseCode() | Integer | Consiga 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 tiver sido invocada. |
getRequest(url, params) | Object | Retorna a solicitação que é feita se a operação tiver sido invocada. |