Guia de início rápido do Apps Script

Neste artigo, mostramos como usar o Apps Script para enviar um e-mail com esquemas e testar a marcação de e-mail.

Como criar o projeto

Acesse script.google.com. Se esta for a primeira vez que você acessa script.google.com, vamos redirecionar você para uma página de informações. Clique em Começar a programar scripts para acessar o editor de scripts. No editor de script, crie um script para um Projeto em branco.

Substitua o código em Code.gs pelo seguinte:

gmail/markup/Code.gs
/**
 * Send an email with schemas in order to test email markup.
 */
function testSchemas() {
  try {
    const htmlBody = HtmlService.createHtmlOutputFromFile('mail_template').getContent();

    MailApp.sendEmail({
      to: Session.getActiveUser().getEmail(),
      subject: 'Test Email markup - ' + new Date(),
      htmlBody: htmlBody
    });
  } catch (err) {
    console.log(err.message);
  }
}

Selecione Arquivo > Novo > Arquivo HTML para criar um arquivo HTML. Nomeie o arquivo como mail_template para corresponder ao parâmetro no JavaScript acima. Substitua o conteúdo do arquivo HTML pelo seguinte:

gmail/markup/mail_template.html
<!--
 Copyright 2022 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

      http://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.
-->

<html>
  <head>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "EmailMessage",
      "description": "Check this out",
      "potentialAction": {
        "@type": "ViewAction",
        "target": "https://www.youtube.com/watch?v=eH8KwfdkSqU"
      }
    }
    </script>
  </head>
  <body>
    <p>
      This a test for a Go-To action in Gmail.
    </p>
  </body>
</html>

Como testar o script

Para testar o script:

  1. Salve o projeto.
  2. Selecione a guia Code.gs.
  3. Verifique se a função testSchemas está selecionada no menu suspenso Select function.
  4. Clique em Run no ambiente de desenvolvimento do Apps Script.

Na primeira vez que você executar o script, será necessário conceder autorização. Depois disso, execute-o novamente. Depois que o script for executado, verifique sua caixa de entrada em busca de um e-mail enviado por você mesmo com um botão Ir para a ação, como na captura de tela a seguir:

Tutorial do Apps Script

Como o script funciona?

A função testSchemas lê o conteúdo HTML do arquivo chamado mail_template.html e envia esse conteúdo como um e-mail para o usuário autenticado no momento. Conforme explicado em Registrar-se no Google, todos os esquemas enviados para você vão aparecer no Gmail. Assim, o e-mail enviado pelo script pode ser usado para ignorar os requisitos de registro para fins de teste.