דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

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

gmail/markup/Code.gs

הצגת הקוד ב-GitHub

/**
 * 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

הצגת הקוד ב-GitHub

<!--
 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>

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

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

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

בפעם הראשונה שתפעילו את הסקריפט, תתבקשו להעניק הרשאה. לאחר מכן, תצטרכו להריץ אותו מחדש. אחרי שהסקריפט יפעל, בדקו בתיבת הדואר הנכנס אם קיבלתם אימייל שנשלח מכם עם לחצן Go-To Action (מעבר לפעולה), כמו בצילום המסך הבא:

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

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