Guia de início rápido: automação

Crie e execute uma automação simples que crie um arquivo do Documentos Google e envie por e-mail um link para ele.

Antes de começar

Para usar esta amostra, você precisa dos seguintes pré-requisitos:

  • Uma Conta do Google (Google Workspace contas podem precisar da aprovação do administrador)
  • Um navegador da Web com acesso à Internet

Configurar

Para criar a automação, siga estas etapas:

Novo editor

  1. Faça login na Conta do Google.
  2. Para abrir o editor de script, acesse script.google.com. Se esta for a primeira vez que você acessa script.google.com, clique em Ver painel.
  3. No canto superior esquerdo, clique em Novo projeto.
  4. Apague o código no editor de script (se houver algum) e cole o código abaixo.

    modelos/independente/helloWorld.gs
    /**
     * Creates a Google Doc and sends an email to the current user with a link to the doc.
     */
    function createAndSendDocument() {
      try {
        // Create a new Google Doc named 'Hello, world!'
        const doc = DocumentApp.create('Hello, world!');
    
        // Access the body of the document, then add a paragraph.
        doc.getBody().appendParagraph('This document was created by Google Apps Script.');
    
        // Get the URL of the document.
        const url = doc.getUrl();
    
        // Get the email address of the active user - that's you.
        const email = Session.getActiveUser().getEmail();
    
        // Get the name of the document to use as an email subject line.
        const subject = doc.getName();
    
        // Append a new string to the "url" variable to use as an email body.
        const body = 'Link to your doc: ' + url;
    
        // Send yourself an email with a link to the document.
        GmailApp.sendEmail(email, subject, body);
      } catch (err) {
        // TODO (developer) - Handle exception
        Logger.log('Failed with error %s', err.message);
      }
    }
  5. Na parte superior, clique em Salvar .

  6. No canto superior esquerdo, clique em Projeto sem título.

  7. Digite um nome para o script e clique em Renomear.

Editor legado

  1. Faça login na Conta do Google.
  2. Para abrir o editor de script, acesse script.google.com. Se esta for a primeira vez que você acessa script.google.com, clique em Ver painel.
  3. Apague o código no editor de script (se houver algum) e cole o código abaixo.

    modelos/independente/helloWorld.gs
    /**
     * Creates a Google Doc and sends an email to the current user with a link to the doc.
     */
    function createAndSendDocument() {
      try {
        // Create a new Google Doc named 'Hello, world!'
        const doc = DocumentApp.create('Hello, world!');
    
        // Access the body of the document, then add a paragraph.
        doc.getBody().appendParagraph('This document was created by Google Apps Script.');
    
        // Get the URL of the document.
        const url = doc.getUrl();
    
        // Get the email address of the active user - that's you.
        const email = Session.getActiveUser().getEmail();
    
        // Get the name of the document to use as an email subject line.
        const subject = doc.getName();
    
        // Append a new string to the "url" variable to use as an email body.
        const body = 'Link to your doc: ' + url;
    
        // Send yourself an email with a link to the document.
        GmailApp.sendEmail(email, subject, body);
      } catch (err) {
        // TODO (developer) - Handle exception
        Logger.log('Failed with error %s', err.message);
      }
    }
  4. Selecione o item de menu File > Save. Nomeie o novo script e clique em OK.

Fazer um teste

Para executar o script, siga estas etapas:

Novo editor

  1. Na parte de cima do editor, clique em Executar.
  2. Na primeira caixa de diálogo exibida, clique em Revisar permissões. Na segunda caixa de diálogo, verifique as permissões que seu script usa e clique em Permitir.
  3. Quando a execução do script for concluída, verifique a Caixa de entrada do Gmail para o novo e-mail.
  4. Abra o e-mail e clique no link para abrir o arquivo do Documentos Google que você criou.

Editor legado

  1. Para executar o script, clique em executar ▶ ou selecione o item de menu Run > createAndSendDocument.
  2. Uma caixa de diálogo será exibida informando que o script requer autorização. Clique em Continuar. Em seguida, uma segunda caixa de diálogo solicitará autorização para serviços específicos do Google. Leia o aviso com atenção e clique em Permitir.
  3. Uma barra amarela na parte superior do editor de script indica quando o script está em execução. Quando a barra amarela desaparecer, o script estará concluído.
  4. Verifique sua Caixa de entrada do Gmail para ver o novo e-mail e clique no link para abrir o Documento Google que você criou.
  5. Abra o Google Drive. Você verá que o script e o documento estão armazenados nele.

Para continuar aprendendo sobre o Apps Script, consulte os seguintes recursos: