Aplicativos da Web

Se você criar uma interface de usuário para um script, poderá publicá-lo como uma app da Web. Por exemplo, um script que permite que os usuários agendem compromissos com os membros de uma equipe de suporte seriam melhor apresentados como um aplicativo da web, para que os usuários podem acessá-lo diretamente de seus navegadores.

Tanto os scripts independentes quanto os scripts vinculados a Google Workspace aplicativos podem ser transformados em aplicativos 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:

• Ele contém uma função doGet(e) ou doPost(e).
• A função retorna um serviço HTML objeto HtmlOutput ou um Serviço de conteúdo TextOutput.

Parâmetros de solicitação

Quando um usuário visita um app ou programa envia uma solicitação HTTP GET, O Apps Script executa a função doGet(e). Quando um programa envia ao app uma solicitação HTTP POST, o Apps Script executará doPost(e). Em ambos os casos, o e representa um parâmetro de evento que pode conter informações sobre qualquer parâmetros 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 corresponde aos parâmetros da solicitação. Somente o primeiro valor é retornado para parâmetros com vários valores. {"name": "alice", "n": "1"}
e.parameters	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 após /exec ou /dev. Por exemplo, se o caminho do URL termina em /exec/hello, o as informações do caminho são hello.
e.contextPath	Não usado, sempre a string vazia.
e.contentLength	O tamanho do corpo da solicitação para 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, transmita parâmetros como username e age para um URL, conforme mostrado abaixo:

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

Em seguida, você pode exibir os parâmetros da seguinte forma:

function doGet(e) {
  var params = JSON.stringify(e);
  return ContentService.createTextOutput(params).setMimeType(ContentService.MimeType.JSON);
}

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
}

Aviso :os nomes de parâmetros a seguir são reservados pelo sistema e não podem ser usados em parâmetros de URL ou em corpos POST:

• c
• sid

. O uso desses parâmetros pode resultar em uma resposta HTTP 405 com a mensagem de erro "O arquivo que você solicitou não existe." Se possível, atualize seu script para usar diferentes nomes de parâmetros.

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", clique em "Ativar tipos de implantação" > App da Web.
3. Digite as informações sobre seu app da Web nos campos em "Implantação". padrão".
4. Clique em Implantar.

É possível compartilhar o URL do app da Web com quem você quer que use o app. desde que você tenha concedido acesso a eles.

Observação :os apps da Web implantados em um domínio vão deixar de funcionar se forem proprietários. alterações em um drive compartilhado ou conta em um domínio diferente. Isso pode ser corrigido novo proprietário ou colaborador reimplante o app da Web no novo domínio. Como alternativa, Se o aplicativo da web for movido de volta para seu domínio original, o aplicativo da web será iniciado funcionando novamente para ele sem a reimplantação.

Testar uma implantação de app da Web

Para testar o 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. Abaixo do URL do app da Web, clique em Copiar.

4. Cole o URL no navegador e teste o app da Web.

   Este URL termina em /dev e só pode ser acessado por usuários com acesso para edição ao script. Esta instância do app sempre executa a versão salva mais recentemente e se destina apenas a testes durante o desenvolvimento.

.

Aviso: ao implantar apps da Web para serem executados como desenvolvedor, você deve tenha muito cuidado ao lidar com tokens OAuth obtidos por meio de ScriptApp.getOAuthToken(). Esses tokens podem conceder a outros aplicativos acesso aos seus dados — nunca transmiti-las para o cliente.

Permissões

As permissões para um app da Web variam de acordo com a forma de execução escolhida o aplicativo:

• Execute o app como eu: neste caso, o script sempre é executado. como você, o proprietário do script, não importa quem acessa o aplicativo da web.
• Execute o app como usuário acessando o app da Web: neste caso, o script é executado sob a identidade do usuário ativo usando o aplicativo da Web. Esta permissão faz com que o aplicativo da web mostre o e-mail do proprietário do script quando o usuário que autoriza o acesso.

.

Aviso: para evitar abusos, o Apps Script impõe limites sobre a taxa nos quais novos usuários podem autorizar um app da Web executado como o usuário. Esses dependem, entre outros fatores, de a conta de publicação fazer parte um domínio do Google Workspace.

Observação: você pode colaborar em apps da Web usando drive compartilhado. Quando um app da Web em um arquivo compartilhado é implantado, a opção "Executar como você" é ativada causa que o aplicativo da web seja executado sob a autoridade do usuário que o implantou (já que não há proprietário do script).

Incorporar seu app da Web ao Google Sites

Aviso: os apps da Web incorporados ainda estão sujeitos a permissões de acesso para evitar uso malicioso. Se o aplicativo da Web incorporado não estiver funcionando, verifique se as permissões definidas pelo proprietário do app da Web e pelo administrador do domínio autorizarem e como usá-lo.

Para incorporar um aplicativo da Web ao Google Sites, primeiro ele deve ser implantadas. Você também precisa do URL implantado da caixa de diálogo Deploy.

Para incorporar um app da Web a um Sites , siga estas etapas:

1. Abra a página do Google Sites à qual você deseja adicionar o aplicativo da Web.
2. Selecione Inserir > URL de incorporação.
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ê publicar página, os leitores do seu site talvez precisem autorizar o aplicativo da Web antes que ele executa normalmente. Os apps da Web não autorizados apresentam solicitações de autorização para o usuário.

Apps da Web e histórico do navegador

Um app da Web que usa o Apps Script para simular várias páginas aplicativo ou um com uma interface dinâmica controlada por parâmetros de URL. Para fazer isso bem, você pode definir um objeto de estado para representar o estado interface ou página e envie o estado para o histórico do navegador como o o usuário a navegar pelo seu aplicativo. Também é possível ouvir eventos do histórico para que sua mostra a IU correta quando o usuário navega para frente e para trás com o botões do navegador. Ao consultar os parâmetros de URL no momento do carregamento, você terá um app a criar a IU dinamicamente com base nesses parâmetros, permitindo que o usuário iniciar o app em um estado específico.

O Apps Script oferece duas APIs JavaScript assíncronas do lado do cliente para ajudar você com a criação de aplicativos da web vinculados ao histórico do navegador:

• google.script.history fornece métodos para permitir uma resposta dinâmica a alterações do histórico do navegador. Isso inclui: enviar estados (objetos simples que você pode definir) para o navegador histórico, substituindo o estado superior na pilha de histórico e definindo um listener para responder a alterações do histórico.

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

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