Esta página foi traduzida pela API Cloud Translation.

URL Fetch Service

Esse serviço permite que scripts acessem outros recursos na Web ao buscar 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 efeitos de eficiência e escalonamento.

As solicitações feitas usando esse serviço têm origem em um conjunto de intervalos de IP. Consulte a lista completa de endereços IP se você precisar adicionar essas solicitações à lista de permissões ou aprová-las.

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

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 necessários para um script, mas, se você estiver definindo os escopos explicitamente, será necessário adicionar esse escopo manualmente para usar UrlFetchApp.

Consulte também

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 deste objeto como um blob convertido para o tipo de conteúdo especificado.
`getBlob()`	`Blob`	Retorne os dados dentro deste 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`	Receba 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 é feita se a operação for invocada.