Class UrlFetchApp

UrlFetchApp

Busque recursos e se comunique com outros hosts pela Internet.

Este serviço permite que os scripts se comuniquem com outros aplicativos ou acessem outros recursos na Web buscando URLs. Um script pode usar o serviço de busca de URL para emitir solicitações HTTP e HTTPS solicitações e receber respostas. O serviço de busca de URL usa a infraestrutura de rede do Google para para fins de eficiência e dimensionamento.

As solicitações feitas usando esse serviço são originadas de um pool definido de intervalos de IP. Você pode procurar a lista completa de endereços IP se: você precisa autorizar ou aprovar essas solicitações.

Este serviço requer a permissão https://www.googleapis.com/auth/script.external_request do projeto. Na maioria dos casos, o Apps Script detecta e inclui automaticamente os escopos necessários. mas se você estiver configurando seus escopos explicitamente, você precisa adicionar manualmente esse escopo para usar UrlFetchApp.

Consulte também

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 foi invocada.
getRequest(url, params)ObjectRetorna a solicitação feita se a operação tiver sido invocada.

Documentação detalhada

fetch(url)

Faz uma solicitação para buscar um URL.

Isso funciona em HTTP e HTTPS.

// The code below logs the HTML code of the Google home page.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getContentText());

Parâmetros

NomeTipoDescrição
urlStringO URL a ser buscado. O URL pode ter até 2.082 caracteres.

Retornar

HTTPResponse: os dados de resposta HTTP.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/script.external_request

fetch(url, params)

Faz uma solicitação para buscar um URL usando parâmetros avançados opcionais.

Isso funciona em HTTP e HTTPS.

// Make a GET request and log the returned content.
var response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContentText());
// Make a POST request with form data.
var resumeBlob = Utilities.newBlob('Hire me!', 'text/plain', 'resume.txt');
var formData = {
  'name': 'Bob Smith',
  'email': 'bob@example.com',
  'resume': resumeBlob
};
// Because payload is a JavaScript object, it is interpreted as
// as form data. (No need to specify contentType; it automatically
// defaults to either 'application/x-www-form-urlencoded'
// or 'multipart/form-data')
var options = {
  'method' : 'post',
  'payload' : formData
};
UrlFetchApp.fetch('https://httpbin.org/post', options);
// Make a POST request with a JSON payload.
var data = {
  'name': 'Bob Smith',
  'age': 35,
  'pets': ['fido', 'fluffy']
};
var options = {
  'method' : 'post',
  'contentType': 'application/json',
  // Convert the JavaScript object to a JSON string.
  'payload' : JSON.stringify(data)
};
UrlFetchApp.fetch('https://httpbin.org/post', options);

Parâmetros

NomeTipoDescrição
urlStringO URL a ser buscado. O URL pode ter até 2.082 caracteres.
paramsObjectO objeto JavaScript opcional que especifica parâmetros avançados conforme definido abaixo.

Parâmetros avançados

NomeTipoDescrição
contentTypeStringo tipo de conteúdo (o padrão é 'application/x-www-form-urlencoded'). Outro exemplo de tipo de conteúdo é 'application/xml; charset=utf-8".
headersObjectum mapa de chave-valor JavaScript de cabeçalhos HTTP para a solicitação
methodStringo método HTTP da solicitação: get, delete, patch, post ou put. O padrão é get.
payloadStringa carga (ou seja, o corpo POST) para a solicitação. Certo Os métodos HTTP (por exemplo, GET) não aceitam payload. Pode ser uma string, uma matriz de bytes, um blob ou um objeto JavaScript. Um objeto JavaScript é interpretado como um mapa de campo de formulário de nomes a valores, em que os valores podem ser strings ou blobs.
useIntranetBooleanObsoleto. Isso instrui a busca a resolver o problema URL na intranet vinculado ao seu domínio pelo (descontinuado) SDC
validateHttpsCertificatesBooleanSe false, a busca ignora qualquer certificados inválidos para solicitações HTTPS. O padrão é true.
followRedirectsBooleanSe false, a busca não seguir redirecionamentos HTTP; ele retornará a resposta HTTP original. O padrão é true.
muteHttpExceptionsBooleanSe true, a busca não gera uma exceção se o código de resposta indicar falha e, em vez disso, retornará HTTPResponse. O padrão é false.
escapingBooleanSe false caracteres reservados no URL não estiverem escapou. O padrão é true.

Retornar

HTTPResponse: os dados de resposta HTTP.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/script.external_request

fetchAll(requests)

Faz várias solicitações para buscar vários URLs usando parâmetros avançados opcionais.

Isso funciona em HTTP e HTTPS.

// Make both a POST request with form data, and a GET request.
var resumeBlob = Utilities.newBlob('Hire me!', 'text/plain', 'resume.txt');
var formData = {
  'name': 'Bob Smith',
  'email': 'bob@example.com',
  'resume': resumeBlob
};
// Because payload is a JavaScript object, it is interpreted as
// as form data. (No need to specify contentType; it defaults to either
// 'application/x-www-form-urlencoded' or 'multipart/form-data')
var request1 = {
  'url': 'https://httpbin.org/post',
  'method' : 'post',
  'payload' : formData
};
// A request may also just be a URL.
var request2 = 'https://httpbin.org/get?key=value';
UrlFetchApp.fetchAll([request1, request2]);

Parâmetros

NomeTipoDescrição
requestsObject[]Uma matriz de URLs ou objetos JavaScript que especificam solicitações conforme definido a seguir.

Parâmetros avançados

NomeTipoDescrição
urlStringo URL a ser buscado. O URL pode ter até 2.082 caracteres.
contentTypeStringo tipo de conteúdo (o padrão é 'application/x-www-form-urlencoded'). Outro exemplo de tipo de conteúdo é 'application/xml; charset=utf-8".
headersObjectum mapa de chave-valor JavaScript de cabeçalhos HTTP para a solicitação
methodStringo método HTTP da solicitação: get, delete, patch, post ou put. O padrão é get.
payloadStringa carga (ou seja, o corpo POST) para a solicitação. Certo Os métodos HTTP (por exemplo, GET) não aceitam payload. Pode ser uma string, uma matriz de bytes, um blob ou um objeto JavaScript. Um objeto JavaScript é interpretado como um mapa de campo de formulário de nomes a valores, em que os valores podem ser strings ou blobs.
useIntranetBooleanObsoleto. Isso instrui a busca a resolver o problema URL na intranet vinculado ao seu domínio pelo (descontinuado) SDC
validateHttpsCertificatesBooleanSe false, a busca ignora qualquer certificados inválidos para solicitações HTTPS. O padrão é true.
followRedirectsBooleanSe false, a busca não seguir redirecionamentos HTTP; ele retornará a resposta HTTP original. O padrão é true.
muteHttpExceptionsBooleanSe for true, a busca não vai gerar uma exceção se o código de resposta indicar falha e, em vez disso, retornará HTTPResponse. O padrão é false.
escapingBooleanSe for false, os caracteres reservados no URL não serão escapou. O padrão é true.

Retornar

HTTPResponse[]: uma matriz de dados de resposta HTTP de cada solicitação de entrada.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/script.external_request

getRequest(url)

Retorna a solicitação feita se a operação foi invocada.

Esse método não emite a solicitação.

// The code below logs the value for every key of the returned map.
var response = UrlFetchApp.getRequest("http://www.google.com/");
for(i in response) {
  Logger.log(i + ": " + response[i]);
}

Parâmetros

NomeTipoDescrição
urlStringO URL a ser pesquisado. O URL pode ter até 2.082 caracteres.

Retornar

Object: um mapa do nome do campo para o valor. O mapa tem pelo menos as seguintes chaves: url, method, contentType, payload e headers.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/script.external_request

getRequest(url, params)

Retorna a solicitação feita se a operação tiver sido invocada.

Esse método não emite a solicitação.

Parâmetros

NomeTipoDescrição
urlStringO URL a ser pesquisado. O URL pode ter até 2.082 caracteres.
paramsObjectUm objeto JavaScript opcional que especifica parâmetros avançados conforme definido abaixo.

Parâmetros avançados

NomeTipoDescrição
contentTypeStringo tipo de conteúdo (o padrão é 'application/x-www-form-urlencoded'). Outro exemplo de tipo de conteúdo é 'application/xml; charset=utf-8".
headersObjectum mapa de chave-valor JavaScript de cabeçalhos HTTP para a solicitação
methodStringo método HTTP da solicitação: get, delete, patch, post ou put. O padrão é get.
payloadStringa carga (ou seja, o corpo POST) para a solicitação. Certo Os métodos HTTP (por exemplo, GET) não aceitam payload. Pode ser uma string, uma matriz de bytes, um blob ou um objeto JavaScript. Um objeto JavaScript é interpretado como um mapa de campo de formulário de nomes a valores, em que os valores podem ser strings ou blobs.
useIntranetBooleanObsoleto. Isso instrui a busca a resolver o problema URL na intranet vinculado ao seu domínio pelo (descontinuado) SDC
validateHttpsCertificatesBooleanSe false, a busca ignora qualquer certificados inválidos para solicitações HTTPS. O padrão é true.
followRedirectsBooleanSe false, a busca não seguir redirecionamentos HTTP; ele retornará a resposta HTTP original. O padrão é true.
muteHttpExceptionsBooleanSe true, a busca não gera uma exceção se o código de resposta indicar falha e, em vez disso, retornará HTTPResponse. O padrão é false.
escapingBooleanSe false caracteres reservados no URL não forem escapou. O padrão é true.

Retornar

Object: um mapa do nome do campo para o valor. O mapa tem pelo menos as seguintes chaves: url, method, contentType, payload e headers.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/script.external_request