شروع سریع اسکریپت برنامه ها

این مقاله به شما نشان می‌دهد که چگونه با استفاده از 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 جدید، مسیر File > New > Html file را دنبال کنید. نام فایل را mail_template قرار دهید تا با پارامتر موجود در جاوا اسکریپت بالا مطابقت داشته باشد. محتوای فایل HTML را با موارد زیر جایگزین کنید:

جیمیل/نشانه‌گذاری/قالب_نامه.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. در محیط توسعه‌ی Apps Script روی Run کلیک کنید.

اولین باری که اسکریپت را اجرا می‌کنید، از شما خواسته می‌شود که مجوز را اعطا کنید، پس از آن باید دوباره آن را اجرا کنید. پس از اجرای اسکریپت، صندوق ورودی خود را برای ایمیلی که از خودتان ارسال شده است با دکمه Go-To Action بررسی کنید، مانند تصویر زیر:

آموزش اسکریپت برنامه‌ها

اسکریپت چگونه کار می‌کند؟

تابع testSchemas محتوای HTML را از فایلی به نام mail_template.html می‌خواند و آن محتوا را به عنوان ایمیلی برای کاربر احراز هویت شده فعلی ارسال می‌کند. همانطور که در بخش ثبت نام با گوگل توضیح داده شد، تمام طرحواره‌هایی که برای خودتان ارسال می‌کنید در Gmail نمایش داده می‌شوند، بنابراین ایمیل ارسال شده توسط اسکریپت می‌تواند برای نادیده گرفتن الزامات ثبت نام برای اهداف آزمایشی استفاده شود.