Guide de démarrage rapide de Google Apps Script

Ce document vous 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 êtes 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 script précédent. 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 Sélectionner une fonction.
  4. Cliquez sur Exécuter dans l'environnement de développement Apps Script.

La première fois que vous exécutez le script, vous êtes invité à accorder l'autorisation. Après l'autorisation, exécutez à nouveau le script. Une fois le script exécuté, vérifiez votre boîte de réception. Vous devriez y trouver un e-mail que vous vous êtes envoyé et qui contient un bouton Accéder à l'action, comme illustré dans la capture d'écran suivante :

Tutoriel Apps Script

Comment fonctionne le script ?

La fonction testSchemas lit le contenu HTML du fichier mail_template.html et l'envoie par e-mail à l'utilisateur authentifié. Comme expliqué dans S'inscrire avec Google, Gmail affiche tous les schémas que vous vous envoyez. Vous pouvez utiliser l'e-mail envoyé par le script pour contourner les exigences d'enregistrement à des fins de test.