شروع سریع اسکریپت Google Apps

این سند به شما نشان می‌دهد که چگونه از 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 می‌خواند و آن محتوا را به عنوان یک ایمیل برای کاربر احراز هویت شده ارسال می‌کند. همانطور که در بخش «ثبت نام با گوگل» توضیح داده شد، جیمیل تمام طرحواره‌هایی را که برای خودتان ارسال می‌کنید نمایش می‌دهد. می‌توانید از ایمیل ارسال شده توسط اسکریپت برای دور زدن الزامات ثبت نام برای آزمایش استفاده کنید.