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 horários com membros de uma equipe de suporte é melhor apresentado como um app da Web para que os usuários possam acessá-lo diretamente nos navegadores.
Tanto os scripts independentes quanto os vinculados a aplicativos Google Workspace podem ser transformados em apps da Web, desde que atendam aos requisitos abaixo.
Requisitos para apps da Web
Um script pode ser publicado como um app da Web se atender a estes requisitos:
- Ele contém uma função
doGet(e)
oudoPost(e)
. - A função retorna um objeto de serviço HTML
HtmlOutput
ou um objeto de serviço de conteúdoTextOutput
.
Parâmetros de solicitação
Quando um usuário visita um app ou um programa envia uma solicitação HTTP GET
,
o Apps Script executa a função doGet(e)
. Quando um programa envia uma solicitação HTTP
POST
para o app, 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 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 com vários valores. {"name": "alice", "n": "1"} |
e.parameters |
Um objeto semelhante a {"name": ["alice"], "n": ["1", "2"]} |
e.pathInfo |
O caminho do URL após |
e.contextPath |
Não usado, sempre a string vazia. |
e.contentLength |
O tamanho do corpo da solicitação para solicitações POST ou 332 |
e.postData.length |
O mesmo que 332 |
e.postData.type |
O tipo MIME do corpo do POST text/csv |
e.postData.contents |
O texto do corpo do 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, mostre os parâmetros da seguinte maneira:
function doGet(e) {
var params = JSON.stringify(e);
return ContentService.createTextOutput(params).setMimeType(ContentService.MimeType.JSON);
}
No exemplo acima, doGet(e)
retorna o seguinte resultado:
{
"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:
- No canto superior direito do projeto do script, clique em Implantar > Nova implantação.
- Ao lado de "Selecionar tipo", clique em Ativar tipos de implantação > App da Web.
- Insira as informações sobre seu app da Web nos campos em "Configuração de implantação".
- Clique em Implantar.
Você pode compartilhar o URL do app da Web com quem quiser usar seu app, desde que você tenha concedido acesso a ele.
Testar uma implantação de app da Web
Para testar o script como um app da Web, siga as etapas abaixo:
- No canto superior direito do projeto de script, clique em Implantar > Testar implantações.
- Ao lado de "Selecionar tipo", clique em Ativar tipos de implantação > App da Web.
- No URL do app da Web, clique em Copiar.
Cole o URL no navegador e teste o app da Web.
Esse URL termina em
/dev
e só pode ser acessado por usuários com acesso de edição ao script. Essa 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 de um app da Web variam de acordo com a forma como você escolhe executá-lo:
- Executar o app como eu: nesse caso, o script sempre é executado como você, o proprietário do script, não importa quem acesse o app da Web.
- Executar o app como usuário que acessa o app da Web: nesse caso, o script é executado com a identidade do usuário ativo que usa 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.
Incorporar seu app da Web ao Google Sites
Para incorporar um app da Web no Google Sites, ele precisa ser implantado. Você também
precisa do URL implantado na caixa de diálogo Deploy
.
Para incorporar um app da Web a uma página do Sites, siga estas etapas:
- Abra a página "Sites" em que você quer adicionar o app da Web.
- Selecione Inserir > Incorporar URL.
- 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. Ao publicar a página, os visitantes do site talvez precisem 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.
Apps da Web e histórico do navegador
Pode ser interessante ter um app da Web do Apps Script que simule um aplicativo de várias páginas 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 a página ou a IU do app e enviar o estado para o histórico do navegador à medida que o usuário navega pelo app. Você também pode detectar eventos de histórico para que o app da Web exiba a interface correta quando o usuário navegar para frente e para trás com os botões do navegador. Ao consultar os parâmetros de URL no momento do carregamento, é possível fazer com que o app crie a interface dinamicamente com base nesses parâmetros, permitindo que o usuário inicie o app em um estado específico.
O Apps Script oferece 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
oferece métodos para permitir a resposta dinâmica a mudanças no 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 do histórico e definir uma função de callback de listener para responder a alterações do histórico.google.script.url
fornece os meios para recuperar os parâmetros 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. Eles não oferecem suporte a barras laterais, caixas de diálogo ou complementos. Essa funcionalidade também não é recomendada para uso em apps da Web incorporados em um site do Google.