دليل سريع للبدء في Google 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 ليتطابق مع المَعلمة في النص البرمجي السابق. استبدِل محتوى ملف 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 في قائمة اختيار الدالة.
  4. انقر على تشغيل في بيئة تطوير "برمجة تطبيقات Google".

في المرة الأولى التي تُشغّل فيها النص البرمجي، سيُطلب منك منح الإذن. بعد منح الإذن، شغِّل النص البرمجي مرة أخرى. بعد تشغيل النص البرمجي، تحقّق من بريدك الوارد بحثًا عن رسالة إلكترونية مرسَلة من نفسك تتضمّن زر الانتقال إلى إجراء، كما هو موضّح في لقطة الشاشة التالية:

برنامج تعليمي حول &quot;برمجة تطبيقات Google&quot;

كيف يعمل النص البرمجي؟

تقرأ الدالة testSchemas محتوى HTML من الملف mail_template.html وترسل هذا المحتوى كرسالة إلكترونية إلى المستخدم الذي تم التحقّق من هويته. كما هو موضّح في مقالة التسجيل باستخدام Google، يعرض Gmail جميع المخططات التي ترسلها إلى نفسك. يمكنك استخدام الرسالة الإلكترونية التي يرسلها النص البرمجي لتجاوز متطلبات التسجيل لأغراض الاختبار.