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

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

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

أو النماذج

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

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

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

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

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

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

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

3. ارجع إلى جداول البيانات وأدرج صورة أو رسمًا عن طريق تحديد إدراج > صورة أو إدراج > رسم.

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

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

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

روابط إلى نص برمجي في "مواقع 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 التي أنشأتها للتو. انقر على OK (موافق).

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

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

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

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