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

توضِّح لك هذه المقالة كيفية استخدام برمجة التطبيقات لإرسال رسالة إلكترونية إلى نفسك تحتوي على مخططات من أجل اختبار ترميز البريد الإلكتروني.

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

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

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

البرنامج التعليمي لبرمجة التطبيقات

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

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