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

توضّح لك هذه المقالة كيفية استخدام Apps Script لإرسال رسالة إلكترونية تتضمّن مخطّطات إليك لاختبار ترميز الرسائل الإلكترونية.

إنشاء المشروع

يُرجى الانتقال إلى script.google.com. إذا كانت هذه هي المرة الأولى التي تنتقل فيها إلى script.google.com، ستتم إعادة توجيهك إلى صفحة معلومات. انقر على Start Scripting (بدء كتابة النصوص البرمجية) للانتقال إلى محرِّر النصوص البرمجية. في أداة تعديل النصوص البرمجية، أنشئ نصًا برمجيًا لمشروع فارغ.

استبدِل الرمز في 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 في بيئة تطوير "برمجة تطبيقات Google".

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

البرنامج التعليمي لـ Apps Script

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

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