Démarrage rapide avec Apps Script

Cet article explique comment utiliser Apps Script pour vous envoyer un e-mail avec des schémas afin de tester le balisage d'e-mail.

Créer le projet

Accédez à script.google.com. Si vous accédez au site script.google.com pour la première fois, vous serez redirigé vers une page d'informations. Cliquez sur Créer le script pour accéder à l'éditeur de script. Dans l'éditeur de scripts, créez un script pour un projet vide.

Remplacez le code dans Code.gs par le code suivant:

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

Sélectionnez Fichier > Nouveau > Fichier HTML pour créer un fichier HTML. Nommez le fichier mail_template pour qu'il corresponde au paramètre du JavaScript ci-dessus. Remplacez le contenu du fichier HTML par le code suivant:

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>

Tester le script

Pour tester le script:

  1. Enregistrez le projet.
  2. Sélectionnez l'onglet correspondant à Code.gs.
  3. Assurez-vous que la fonction testSchemas est sélectionnée dans le menu déroulant Select function.
  4. Cliquez sur Run dans l'environnement de développement Apps Script.

La première fois que vous exécutez le script, vous êtes invité à donner votre autorisation, après quoi vous devez l'exécuter à nouveau. Une fois le script exécuté, recherchez dans votre boîte de réception un e-mail envoyé par vous et incluant un bouton Go-To Action (Action d'accès), comme dans la capture d'écran suivante:

Tutoriel Apps Script

Comment le script fonctionne-t-il ?

La fonction testSchemas lit le contenu HTML à partir du fichier nommé mail_template.html et l'envoie par e-mail à l'utilisateur actuellement authentifié. Comme expliqué dans la section Enregistrement auprès de Google, tous les schémas que vous vous envoyez à vous-même s'affichent dans Gmail. L'e-mail envoyé par le script peut donc être utilisé pour ignorer les conditions d'enregistrement à des fins de test.