القوائم المخصّصة في Google Workspace

يمكن أن تُوسِّع النصوص البرمجية منتجات معيّنة من Google عن طريق إضافة عناصر على واجهة المستخدم تنقر على وظيفة برمجة التطبيقات عند النقر عليها. ومن الأمثلة الأكثر شيوعًا تشغيل نص برمجي من عنصر قائمة مخصّص في "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" أو "نماذج Google"، ولكن يمكن أيضًا تشغيل وظائف النص البرمجي من خلال النقر على الصور والرسومات في "جداول بيانات Google".

القوائم المخصّصة في "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" أو "نماذج Google"

يمكن أن تضيف "برمجة التطبيقات" قوائم جديدة في "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" أو "نماذج Google"، مع ربط كل عنصر في القائمة بوظيفة في نص برمجي. (في "نماذج Google"، لا تكون القوائم المخصصة مرئية إلا للمحرر الذي يفتح النموذج لتعديله، وليس للمستخدم الذي يفتح النموذج للرد).

لا يمكن للنص البرمجي إنشاء قائمة إلا إذا تم ربطه للمستند أو جدول البيانات أو النموذج. لعرض القائمة عندما يفتح المستخدم ملفًا، اكتب رمز القائمة في إحدى وظائف onOpen().

يوضّح المثال التالي كيفية إضافة قائمة تتضمّن عنصرًا متبوعًا بفاصل مرئي ثم قائمة فرعية تحتوي على عنصر آخر. (ملاحظة: في "جداول بيانات Google"، ما لم تكن تستخدم الإصدار الجديد، عليك استخدام بنية addMenu() بدلاً من ذلك، ولا يمكن استخدام القوائم الفرعية). عندما يختار المستخدم أحد عناصر القائمة، تفتح الدالة المقابلة مربّع حوار alert. لمزيد من المعلومات حول أنواع مربّعات الحوار التي يمكنك فتحها، اطّلِع على دليل مربّعات الحوار والأشرطة الجانبية.

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  // Or DocumentApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
     .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
     .alert('You clicked the second menu item!');
}

يمكن أن يحتوي المستند أو جدول البيانات أو العرض التقديمي أو النموذج على قائمة واحدة فقط باسم واحد. وإذا أضاف النص البرمجي نفسه أو نص برمجي آخر قائمة بالاسم نفسه، تحل القائمة الجديدة محل القائمة القديمة. لا يمكن إزالة القوائم أثناء فتح الملف، ولكن يمكنك كتابة دالة onOpen() لتخطّي القائمة في المستقبل إذا تم ضبط سمة معيّنة.

الصور والرسومات القابلة للنقر في "جداول بيانات Google"

يمكنك أيضًا تخصيص دالة "برمجة تطبيقات Google" لصورة أو رسم في "جداول بيانات Google"، ما دامت النصوص البرمجية مرتبطة بجدول البيانات. يوضّح المثال أدناه كيفية إعداد هذا.

1. في "جداول بيانات Google"، اختَر عنصر القائمة الإضافات > برمجة التطبيقات لإنشاء نص برمجي مرتبط بجدول البيانات.

2. احذف أي رمز في محرِّر النص البرمجي والصقه في الرمز أدناه.

     function showMessageBox() {
       Browser.msgBox('You clicked it!');
     }
   

3. ارجع إلى "جداول بيانات Google" وأدرِج صورة أو رسمًا من خلال اختيار إدراج > صورة أو إدراج > رسم.

4. بعد إدراج الصورة أو الرسم، انقر عليه. وستظهر قائمة منسدلة صغيرة في أعلى يسار الشاشة. انقر عليه واختَر تخصيص نص برمجي.

5. في مربع الحوار الذي يظهر، اكتب اسم دالة برمجة التطبيقات التي تريد تشغيلها بدون قوسين، وفي هذه الحالة تكون showMessageBox. النقر على حسنًا

6. انقر على الصورة أو الرسم مرة أخرى. سيتم تنفيذ الدالة الآن.

روابط إلى نص برمجي في "مواقع Google"

يمكنك أيضًا تخصيص دالة "برمجة تطبيقات Google" لرابط في "مواقع Google"، طالما تم ربط النص البرمجي بالموقع الإلكتروني. يوضح المثال أدناه كيفية إعداد هذا.

1. في موقع مصمم في "مواقع Google"، انقر على المزيد > إدارة الموقع الإلكتروني.
2. في الشريط الجانبي، انقر على برمجة التطبيقات، ثم إضافة نص برمجي جديد لإنشاء نص برمجي مرتبط بالموقع.

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

     function sitesLink() {
       var recipient = Session.getActiveUser().getEmail();
       GmailApp.sendEmail(recipient, 'Email from your site', 'You clicked a link!');
     }
   

4. الرجوع إلى "موقع Google" وتعديل الصفحة اكتب تصنيفًا سيصبح رابطًا، مثل Click me، ثم حدِّد النص وانقر على إدراج > رابط.

5. في مربّع الحوار الذي يظهر، انقر على برمجة التطبيقات، ثم انقر على الدالة sitesLink التي أنشأتها للتو. النقر على حسنًا

6. انقر على حفظ في أعلى الصفحة.

7. انقر على الرابط الذي أضفته إلى الصفحة.

8. سيظهر مربّع حوار يخبرك بأن النص البرمجي يتطلب تفويضًا. انقر على حسنًا. وسيطلب مربّع الحوار الثاني بعد ذلك تفويضًا لخدمات معيّنة من Google. اقرأ الإشعار بعناية، ثم انقر على السماح، ثم إغلاق.

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