Démarrage rapide avec Apps Script

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

Créer le projet

Accédez à script.google.com. Si c'est la première fois que vous accédez à script.google.com, vous serez redirigé vers une page d'informations. Cliquez sur Start Scripting (Commencer à créer des scripts) pour accéder à l'éditeur de script. Dans l'éditeur de script, 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 code 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 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é à accorder l'autorisation. Vous devez ensuite l'exécuter à nouveau. Une fois le script exécuté, vérifiez votre boîte de réception pour trouver un e-mail que vous vous êtes envoyé et qui contient un bouton Go-To Action (Accéder à l'action), comme dans la capture d'écran suivante :

Tutoriel Apps Script

Comment fonctionne le script ?

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