GSP249

Visão geral

Os Complementos do Gmail automatizam tarefas no Gmail, o que economiza o tempo e o esforço dos usuários. Com eles, é possível examinar as mensagens recebidas e interagir com elas de diversas maneiras, como:

• exibir mais informações para o usuário na interface do Gmail;
• conectar-se a serviços que não são do Google para buscar informações ou realizar outras ações;
• exibir uma interface interativa para que o usuário controle o complemento ou envie informações a outro serviço.

Atividades

Neste laboratório prático, você criará um Complemento do Gmail que permite alterar rapidamente os marcadores de uma conversa de e-mail.

Configuração e requisitos

Antes de clicar no botão Começar o Laboratório

Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é iniciado quando você clica em Iniciar laboratório e mostra por quanto tempo os recursos ficam disponíveis.

Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Gmail durante o laboratório.

O que você precisa

Veja os requisitos para concluir o laboratório:

• Acesso a um navegador de Internet padrão (recomendamos o Chrome).
• Tempo disponível para concluir as atividades.

Observação: para executar este laboratório, use o modo de navegação anônima ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e a conta de estudante.

Como iniciar o laboratório e fazer login no Gmail

1. Quando tudo estiver pronto, clique em Iniciar laboratório.

   O painel "Detalhes do laboratório" aparece com as credenciais temporárias que você precisa usar para fazer login no Gmail neste laboratório.

   Se for preciso pagar por ele, uma caixa de diálogo vai aparecer para você selecionar a forma de pagamento.

2. Clique em Abrir o Gmail.

   O laboratório ativa os recursos e depois abre a página Fazer Login em outra guia.

   Dica: coloque as guias em janelas separadas lado a lado.

3. Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Fazer login.

   {{{user_0.username | "Nome de usuário"}}}

4. Clique em Próxima.

5. Copie a Senha abaixo e cole na caixa de diálogo de boas-vindas.

   {{{user_0.password | "Senha"}}}

6. Clique em Próxima.

7. Clique em Entendi para aceitar os termos.

   O Gmail será aberto.

8. Clique em Vamos começar e feche qualquer outra janela de informação.

Agora você está no Gmail, na sua caixa de entrada.

Tarefa 1: crie o projeto de script

Iniciar o Apps Script

1. Clique neste link do Apps Script para abri-lo em uma nova guia ou janela do navegador. Um novo projeto será aberto.

Observação: o Apps Script coloca o arquivo desse projeto na pasta raiz do Drive.

2. Clique no ícone de Configurações e selecione a opção Mostrar arquivo de manifesto "appsscript.json" no editor.

3. Clique no ícone do Editor

Dar um nome ao projeto

1. Clique em projeto sem título no canto superior esquerdo.
2. Nomeie o projeto como Guia de início rápido do Complemento do Gmail e clique em Renomear.

Criar o arquivo de script Code.gs

• Substitua o conteúdo do arquivo Code.gs pelo seguinte:

Code.gs

/** * Copyright Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * https://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** * Returns the array of cards that should be rendered for the current * e-mail thread. The name of this function is specified in the * manifest 'onTriggerFunction' field, indicating that this function * runs every time the add-on is started. * * @param {Object} e The data provided by the Gmail UI. * @return {Card[]} */ function buildAddOn(e) { // Activate temporary Gmail add-on scopes. var accessToken = e.messageMetadata.accessToken; GmailApp.setCurrentMessageAccessToken(accessToken); var messageId = e.messageMetadata.messageId; var message = GmailApp.getMessageById(messageId); // Get user and thread labels as arrays to enable quick sorting and indexing. var threadLabels = message.getThread().getLabels(); var labels = getLabelArray(GmailApp.getUserLabels()); var labelsInUse = getLabelArray(threadLabels); // Create a section for that contains all user Labels. var section = CardService.newCardSection() .setHeader("<font color=\"#1257e0\"><b>Available User Labels</b></font>"); // Create a checkbox group for user labels that are added to prior section. var checkboxGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.CHECK_BOX) .setFieldName('labels') .setOnChangeAction(CardService.newAction().setFunctionName('toggleLabel')); // Add checkbox with name and selected value for each User Label. for(var i = 0; i < labels.length; i++) { checkboxGroup.addItem(labels[i], labels[i], labelsInUse.indexOf(labels[i])!= -1); } // Add the checkbox group to the section. section.addWidget(checkboxGroup); // Build the main card after adding the section. var card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader() .setTitle('Quick Label') .setImageUrl('https://www.gstatic.com/images/icons/material/system/1x/label_googblue_48dp.png')) .addSection(section) .build(); return [card]; } /** * Updates the labels on the current thread based on * user selections. Runs via the OnChangeAction for * each CHECK_BOX created. * * @param {Object} e The data provided by the Gmail UI. */ function toggleLabel(e){ var selected = e.formInputs.labels; // Activate temporary Gmail add-on scopes. var accessToken = e.messageMetadata.accessToken; GmailApp.setCurrentMessageAccessToken(accessToken); var messageId = e.messageMetadata.messageId; var message = GmailApp.getMessageById(messageId); var thread = message.getThread(); if (selected != null){ for each (var label in GmailApp.getUserLabels()) { if(selected.indexOf(label.getName()) != -1){ thread.addLabel(label); } else { thread.removeLabel(label); } } } else { for each (var label in GmailApp.getUserLabels()) { thread.removeLabel(label); } } } /** * Converts an GmailLabel object to a array of strings. * Used for easy sorting and to determine if a value exists. * * @param {labelsObjects} A GmailLabel object array. * @return {lables[]} An array of labels names as strings. */ function getLabelArray(labelsObjects){ var labels = []; for(var i = 0; i < labelsObjects.length; i++) { labels[i] = labelsObjects[i].getName(); } labels.sort(); return labels; } Observação : antes de salvar, é necessário atualizar o manifesto do script para evitar erros.

Tarefa 2: atualize o manifesto do script

Atualize o manifesto (appsscript.json) para inserir as informações de implantação obrigatórias no complemento.

1. No editor de script, selecione o arquivo appsscript.json no menu à esquerda.
2. Substitua o conteúdo do manifesto (appsscript.json) pelo seguinte:

appsscript.json

{ "oauthScopes": [ "https://www.googleapis.com/auth/gmail.addons.execute", "https://www.googleapis.com/auth/gmail.addons.current.message.metadata", "https://www.googleapis.com/auth/gmail.modify" ], "gmail": { "name": "Gmail Add-on Quickstart - QuickLabels", "logoUrl": "https://www.gstatic.com/images/icons/material/system/1x/label_googblue_24dp.png", "contextualTriggers": [{ "unconditional": { }, "onTriggerFunction": "buildAddOn" }], "openLinkUrlPrefixes": [ "https://mail.google.com/" ], "primaryColor": "#4285F4", "secondaryColor": "#4285F4" } }

3. Clique no ícone Salvar projeto para salvar as mudanças feitas no manifesto e no Code.gs. Nesta etapa, as informações de implantação obrigatórias são fornecidas ao complemento. Se acontecer algum erro, salve o Code.gs novamente.

Crie um novo projeto do Apps Script

Tarefa 3: implante o complemento

1. Clique no botão Implantar > Testar implantações na parte de cima da tela.

2. Para Aplicativos(s): Gmail clique em Instalar.

3. Clique em Concluído.

4. Abra a guia de configurações dos complementos do Gmail.

5. Com isso, chegamos à caixa de diálogo Configurações e à guia Complementos.

Quando você concluir essas etapas, o complemento vai aparecer na lista de Complementos do desenvolvedor instalados e vai estar disponível para uso no Gmail.

Observação: se nenhum complemento aparecer na lista Complementos do desenvolvedor instalados, atualize a janela do navegador. Se isso continuar, volte para a aba Guia de início rápido de Complementos do Gmail e reinstale o complemento da janela Testar implantações.

Tarefa 4: execute o complemento

1. Volte para a guia "Gmail" e atualize a página.
2. Escolha e abra uma mensagem no Gmail.
3. Verifique se o menu do lado direito está aberto: clique na seta para expandir se estiver recolhido.

Crie alguns marcadores

1. Clique no botão Marcadores () na barra de menus do Gmail acima do e-mail.
2. Clique em Criar novo.
3. Insira "Teste 1" como nome do marcador e clique no botão Criar.
4. Repita essas etapas para criar outro marcador e dê o nome "Teste 2".

Autorizar complemento

Os complementos instalados aparecem no menu à direita da conversa de e-mail aberta.

1. No lado direito da tela, clique em .

O complemento vai mostrar um card de contexto no lado direito da janela com uma mensagem pedindo autorização.

2. Clique no link Autorizar acesso para abrir uma caixa de diálogo e autorizar o complemento.
3. Selecione a conta de estudante que autorizará o complemento.
4. Clique em Permitir.
5. Se a próxima caixa de diálogo indicar que o aplicativo não está verificado:

• Clique em Avançado.
• Na parte inferior da caixa de diálogo, clique em Acessar o Guia de início rápido de Complementos do Gmail (não seguro).
• Na nova caixa de diálogo, digite "Continue" no campo de texto e clique em Próximo.

6. Uma vez autorizado, o complemento será atualizado automaticamente e começará a funcionar.

Tarefa 5: use o complemento

Os marcadores Teste 1 e Teste 2 estão selecionados na seção Marcadores do usuário disponíveis do complemento (menu à direita).

1. Clique na caixa de seleção Teste 2 para desmarcar esse marcador. Com isso, ele será removido da conversa.
2. Verifique se os marcadores corretos foram aplicados voltando para a caixa de entrada e atualizando o navegador. Somente o marcador Teste 1 permanece ativo e o Teste 2 foi removido.
3. Abra outro e-mail.
4. No menu de complementos, marque as caixas de seleção Teste 1 e Teste 2 para ativá-los.
5. Volte à caixa de entrada e atualize o navegador. Os dois marcadores foram aplicados à conversa de e-mail.

Crie e use o Complemento do Gmail

Parabéns!

Agora você tem uma ideia do que é possível fazer com esses complementos. Há muitas outras possibilidades, como exibir outras conversas recentes iniciadas pelo remetente ou traduzir o texto em um e-mail de um idioma para outro sem sair do Gmail.

Comece o próximo laboratório

Saiba mais sobre o Workspace:

• Google Apps Script: acesse as Planilhas Google, o Maps e o Gmail usando apenas quatro linhas de código

Próximas etapas

• Saiba mais sobre os Complementos do Gmail
• Centro de aprendizagem do Google Workspace

Treinamento e certificação do Google Cloud

Esses treinamentos ajudam você a aproveitar as tecnologias do Google Cloud ao máximo. Nossas aulas incluem habilidades técnicas e práticas recomendadas para ajudar você a alcançar rapidamente o nível esperado e continuar sua jornada de aprendizado. Oferecemos treinamentos que vão do nível básico ao avançado, com opções de aulas virtuais, sob demanda e por meio de transmissões ao vivo para que você possa encaixá-las na correria do seu dia a dia. As certificações validam sua experiência e comprovam suas habilidades com as tecnologias do Google Cloud.

Manual atualizado em 5 de novembro de 2024

Laboratório testado em 5 de novembro de 2024

Copyright 2025 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.