Krótkie wprowadzenie do Apps Script

Z tego artykułu dowiesz się, jak używać Apps Script do wysyłania do siebie e-maili ze schematami, aby testować znaczniki e-maili.

Tworzenie projektu

Otwórz script.google.com. Jeśli otwierasz script.google.com po raz pierwszy, przekierujemy Cię na stronę z informacjami. Aby przejść do edytora skryptów, kliknij Start Scripting (Rozpocznij tworzenie skryptów). W edytorze skryptów utwórz skrypt dla pustego projektu.

Zastąp kod w pliku Code.gs tym kodem:

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);
  }
}

Aby utworzyć nowy plik HTML, wybierz Plik > Nowy > Plik HTML. Nazwij plik mail_template, aby pasował do parametru w powyższym kodzie JavaScript. Zastąp zawartość pliku HTML tym kodem:

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>

Testowanie skryptu

Aby przetestować skrypt:

  1. Zapisz projekt.
  2. Wybierz kartę Code.gs.
  3. Sprawdź, czy w menu Select function wybrana jest funkcja testSchemas.
  4. W środowisku programistycznym Apps Script kliknij Run.

Przy pierwszym uruchomieniu skryptu pojawi się prośba o przyznanie autoryzacji. Po jej przyznaniu uruchom skrypt ponownie. Po uruchomieniu skryptu sprawdź skrzynkę odbiorczą. Powinien w niej być e-mail wysłany przez Ciebie z przyciskiem Go-To Action (przejdź do działania), jak na tym zrzucie ekranu:

Samouczek Apps Script

Jak działa skrypt?

Funkcja testSchemas odczytuje treść HTML z pliku o nazwie mail_template.html i wysyła ją w e-mailu do aktualnie uwierzytelnionego użytkownika. Jak wyjaśniono w artykule Rejestracja w Google, wszystkie schematy, które do siebie wyślesz, będą wyświetlane w Gmailu, więc e-mail wysłany przez skrypt może być używany do ignorowania wymagań rejestracyjnych na potrzeby testowania.