Aplicativos da Web

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Se você criar uma interface do usuário para um script, poderá publicá-lo como um app da Web. Por exemplo, um script que permite que os usuários agendem consultas com os membros de uma equipe de suporte é melhor apresentado como um app da Web para que os usuários possam acessá-lo diretamente dos navegadores.

Os scripts autônomos e os scripts vinculados a Google Workspace aplicativos podem ser transformados em apps da Web, desde que atendam aos requisitos abaixo.

Requisitos para apps da Web

Um script poderá ser publicado como um app da Web se atender a estes requisitos:

Parâmetros de solicitação

Quando um usuário visita um app ou programa que envia uma solicitação HTTP GET, o Apps Script executa a função doGet(e). Quando um programa envia ao app uma solicitação POST HTTP, o Apps Script executa doPost(e). Em ambos os casos, o argumento e representa um parâmetro de evento que pode conter informações sobre qualquer parâmetro de solicitação. A estrutura do objeto de evento é mostrada na tabela abaixo:

Campos
e.queryString

O valor da parte da string de consulta do URL ou null se nenhuma string de consulta for especificada

name=alice&n=1&n=2
e.parameter

Um objeto de pares de chave-valor que correspondem aos parâmetros da solicitação. Apenas o primeiro valor é retornado para parâmetros que têm vários valores.

{"name": "alice", "n": "1"}
e.parameters

Um objeto semelhante a e.parameter, mas com uma matriz de valores para cada chave.

{"name": ["alice"], "n": ["1", "2"]}
e.pathInfo

O caminho do URL depois de /exec ou /dev. Por exemplo, se o caminho do URL termina em /exec/hello, as informações do caminho são hello.

e.contextPath Não utilizado, sempre a string vazia.
e.contentLength

O comprimento do corpo de solicitação de solicitações POST ou -1 para solicitações GET

332
e.postData.length

O mesmo que e.contentLength

332
e.postData.type

O tipo MIME do corpo POST

text/csv
e.postData.contents

O texto de conteúdo do corpo POST

Alice,21
e.postData.name

Sempre o valor "postData"

postData

Por exemplo, é possível transmitir parâmetros como username e age para um URL, conforme mostrado abaixo:

https://script.google.com/.../exec?username=jsmith&age=21

Em seguida, exiba os parâmetros:

function doGet(e) {
  var params = JSON.stringify(e);
  return HtmlService.createHtmlOutput(params);
}

No exemplo acima, doGet(e) retorna a seguinte saída:

{
  "queryString": "username=jsmith&age=21",
  "parameter": {
    "username": "jsmith",
    "age": "21"
  },
  "contextPath": "",
  "parameters": {
    "username": [
      "jsmith"
    ],
    "age": [
      "21"
    ]
  },
  "contentLength": -1
}

Implantar um script como um app da Web

Para implantar um script como um app da Web, siga estas etapas:

  1. No canto superior direito do projeto de script, clique em Implantar > Nova implantação.
  2. Ao lado de "Selecionar tipo&&t;clique em Ativar tipos de implantação > App da Web.
  3. Insira as informações do app da Web nos campos em "quo";Configuração de implantação."
  4. Clique em Implantar.

Compartilhe o URL do app da Web com quem você quer usar, desde que tenha concedido acesso a ele.

Testar uma implantação de app da Web

Para testar seu script como um app da Web, siga as etapas abaixo:

  1. No canto superior direito do projeto de script, clique em Implantar > testar implantações.
  2. Ao lado de "Selecionar tipo" clique em Ativar tipos de implantação > App da Web.
  3. No URL do app da Web, clique em Copiar.
  4. Cole o URL no navegador e teste seu app da Web.

    Esse URL termina em /dev e só pode ser acessado por usuários que tenham acesso de edição ao script. Esta instância do app sempre executa o código salvo mais recentemente e é destinada apenas a testes durante o desenvolvimento.

Permissões

As permissões para um app da Web são diferentes dependendo de como você decidir executá-lo:

  • Executar o app como eu: nesse caso, o script sempre é executado como você, o proprietário do script, independentemente de quem acesse o app da Web.
  • Executar o app como usuário que acessa o app da Web: neste caso, o script é executado sob a identidade do usuário ativo usando o app da Web. Essa abordagem de permissão faz com que o app da Web mostre o e-mail do proprietário do script quando o usuário autoriza o acesso.

Incorporação do app da Web no Google Sites

Também é possível incorporar apps da Web na versão clássica e nas novas versões do Google Sites.

Incorporação do app da Web no novo Google Sites

Para incorporar um app da Web, ele precisa ser implantado primeiro. Você também precisa do URL implantado da caixa de diálogo Deploy.

Para incorporar um app da Web em uma nova página do Sites, siga estas etapas:

  1. Abra a página "Sites" a que você quer adicionar o app da Web.
  2. Selecione Inserir > URL incorporado.
  3. Cole o URL do app da Web e clique em ADICIONAR.

O app da Web aparece em um frame na visualização da página. Quando você publica a página, os visualizadores do seu site podem precisar autorizar o app da Web antes que ele seja executado normalmente. Apps da Web não autorizados apresentam solicitações de autorização ao usuário.

Incorporação do app da Web no Sites clássico

É possível vincular um script a um site Google clássico da mesma forma que você vincula um script a um arquivo do Documentos ou do Planilhas Google. Para criar um script vinculado, acesse o site, clique no ícone de engrenagem Configurações e selecione Gerenciar site. Na página "Gerenciar site", clique em Scripts do Google Apps no painel de navegação à esquerda e no botão Adicionar novo script. Isso abre um novo script no editor do Apps Script, em que você pode codificar e implantar seu app da Web.

Também é possível incorporar o app da Web em uma página. Você pode vincular o app da Web ao site ou usar qualquer app da Web que tenha o URL. Para incorporar um app da Web a uma página do Google Sites, siga as etapas abaixo:

  1. Abra um site que você possa editar ou crie um novo site.
  2. Navegue até a página no seu site onde você quer incorporar o app da Web.
  3. Clique no ícone de edição e em Insert > Google Apps Script.
  4. Escolha o script na lista que representa seu app da Web. Caso ele não esteja vinculado a esse site, cole o URL do app da Web.
  5. Clique no botão Selecionar, escolha as opções desejadas na caixa de diálogo seguinte e clique em Salvar.
  6. Salve as mudanças na página. Você verá o app da Web incorporado na página "Sites".

Histórico da Web e apps da Web

Pode ser desejável que um app da Web do Apps Script simule um aplicativo de várias páginas ou um com uma IU dinâmica controlada por parâmetros de URL. Para fazer isso bem, você pode definir um objeto de estado para representar a IU ou a página do app e enviar o estado ao histórico do navegador conforme o usuário navega no app. Você também pode detectar eventos do histórico para que o app da Web exiba a IU correta quando o usuário navegar com os botões do navegador. Ao consultar os parâmetros de URL no momento do carregamento, você pode fazer com que o app crie dinamicamente a IU com base nesses parâmetros, permitindo que o usuário inicie o app em um estado específico.

O Apps Script fornece duas APIs JavaScript assíncronas do lado do cliente para ajudar na criação de apps da Web vinculados ao histórico do navegador:

  • google.script.history fornece métodos para permitir respostas dinâmicas às mudanças do histórico do navegador. Isso inclui enviar estados (objetos simples que você pode definir) para o histórico do navegador, substituir o estado superior na pilha de histórico e definir uma função de retorno de chamada do listener para responder às mudanças do histórico.

  • O google.script.url fornece os meios para recuperar os parâmetros de URL e o fragmento de URL da página atual, se eles estiverem presentes.

Essas APIs de histórico estão disponíveis apenas para apps da Web. Elas não são compatíveis com barras laterais, caixas de diálogo ou complementos. Essa funcionalidade também não é recomendada para uso em apps da Web incorporados em um Google Sites.