البدء السريع لبرمجة التطبيقات

توضّح لك هذه المقالة كيفية استخدام 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، لذا يمكن استخدام الرسالة الإلكترونية التي يرسلها النص البرمجي لتجاهل متطلبات التسجيل لأغراض الاختبار.