מדריך למתחילים בנושא Apps Script

במאמר הזה מוסבר איך להשתמש ב-Apps Script כדי לשלוח לעצמכם אימייל עם סכימות כדי לבדוק את תגי העיצוב של הודעות אימייל.

יצירת הפרויקט

נכנסים אל script.google.com. אם זו הפעם הראשונה שאתם מבקרים ב-script.google.com, המערכת תפנה אתכם לדף מידע. לוחצים על הפעלת סקריפטים כדי להמשיך אל עורך הסקריפטים. בעורך הסקריפטים, יוצרים סקריפט לפרויקט ריק.

מחליפים את הקוד שמופיע ב-Code.gs בקוד הבא:

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

בוחרים באפשרות קובץ > חדש > קובץ Html כדי ליצור קובץ HTML חדש. נותנים לקובץ שם mail_template כך שיתאים לפרמטר ב-JavaScript שלמעלה. מחליפים את התוכן של קובץ ה-HTML בתוכן הבא:

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>

בדיקת הסקריפט

כדי לבדוק את הסקריפט:

  1. שומרים את הפרויקט.
  2. צריך לבחור את הכרטיסייה של Code.gs.
  3. צריך לוודא שהפונקציה testSchemas נבחרה בתפריט הנפתח Select function.
  4. לוחצים על Run בסביבת הפיתוח של Apps Script.

בפעם הראשונה שתפעיל את הסקריפט, תתבקש להעניק הרשאה, ולאחר מכן עליך להפעיל אותו מחדש. לאחר הרצת הסקריפט, מחפשים בתיבת הדואר הנכנס אימייל שנשלח מעצמכם עם לחצן מעבר לפעולה, כמו בצילום המסך הבא:

מדריך ל-Apps Script

איך הסקריפט פועל?

הפונקציה testSchemas קוראת את תוכן ה-HTML מהקובץ ששמו mail_template.html ושולחת את התוכן כאימייל למשתמש המאומת הנוכחי. כפי שמוסבר בהרשמה באמצעות Google, כל הסכימות שאתם שולחים לעצמכם יוצגו ב-Gmail, כך שאפשר להשתמש באימייל שהסקריפט שולח כדי להתעלם מדרישות ההרשמה למטרות בדיקה.