Class TriggerBuilder

أداةإنشاء العوامل المشغِّلة

أداة إنشاء عامة لعوامل تشغيل النصوص البرمجية

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
forDocument(document)DocumentTriggerBuilderتُنشئ هذه الدالة DocumentTriggerBuilder وتُرجعها مرتبطة بالمستند المحدّد.
forDocument(key)DocumentTriggerBuilderتُنشئ هذه الدالة DocumentTriggerBuilder وتُرجعها مرتبطة بالمستند الذي يحمل المعرّف المحدّد.
forForm(form)FormTriggerBuilderلإنشاء FormTriggerBuilder مرتبط بالنموذج المحدّد وعرضه
forForm(key)FormTriggerBuilderلإنشاء FormTriggerBuilder مرتبط بالنموذج باستخدام المعرّف المحدّد وإرجاع هذا العنصر.
forSpreadsheet(sheet)SpreadsheetTriggerBuilderتُنشئ هذه الدالة SpreadsheetTriggerBuilder وتُرجعها مرتبطة بجدول البيانات المحدّد.
forSpreadsheet(key)SpreadsheetTriggerBuilderلإنشاء SpreadsheetTriggerBuilder مرتبط بجدول البيانات باستخدام الرقم التعريفي المحدّد وإرجاعه
forUserCalendar(emailId)CalendarTriggerBuilderتعرِض هذه الدالة أداة إنشاء لإنشاء عوامل تشغيل التقويم.
timeBased()ClockTriggerBuilderتُنشئ هذه الدالة ClockTriggerBuilder وتُرجعها لإنشاء عوامل تشغيل مستندة إلى الوقت.

مستندات تفصيلية

forDocument(document)

تُنشئ هذه الدالة DocumentTriggerBuilder وتُرجعها مرتبطة بالمستند المحدّد. 

ScriptApp.newTrigger('myFunction')
    .forDocument(DocumentApp.getActiveDocument())
    .onOpen()
    .create();

المعلمات

الاسمالنوعالوصف
documentDocumentالمستند

الإرجاع

DocumentTriggerBuilder - أداة DocumentTriggerBuilder الجديدة

التفويض

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

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

forDocument(key)

تُنشئ هذه الدالة DocumentTriggerBuilder وتُرجعها مرتبطة بالمستند الذي يحمل المعرّف المحدّد. 

ScriptApp.newTrigger('myFunction')
    .forDocument('1234567890abcdefghijklmnopqrstuvwxyz')
    .onOpen()
    .create();

المعلمات

الاسمالنوعالوصف
keyStringرقم تعريف المستند

الإرجاع

DocumentTriggerBuilder - أداة DocumentTriggerBuilder الجديدة

التفويض

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

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

forForm(form)

لإنشاء FormTriggerBuilder مرتبط بالنموذج المحدّد وعرضه 

ScriptApp.newTrigger('myFunction')
    .forForm(FormApp.getActiveForm())
    .onFormSubmit()
    .create();

المعلمات

الاسمالنوعالوصف
formFormالنموذج

الإرجاع

FormTriggerBuilder - واجهة FormTriggerBuilder الجديدة

التفويض

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

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

forForm(key)

لإنشاء FormTriggerBuilder مرتبط بالنموذج باستخدام المعرّف المحدّد وإرجاع هذا العنصر. 

ScriptApp.newTrigger('myFunction')
    .forForm('1234567890abcdefghijklmnopqrstuvwxyz')
    .onFormSubmit()
    .create();

المعلمات

الاسمالنوعالوصف
keyStringرقم تعريف النموذج

الإرجاع

FormTriggerBuilder - واجهة FormTriggerBuilder الجديدة

التفويض

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

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

forSpreadsheet(sheet)

تُنشئ هذه الدالة SpreadsheetTriggerBuilder وتُرجعها مرتبطة بجدول البيانات المحدّد. 

ScriptApp.newTrigger('myFunction')
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onEdit()
    .create();

المعلمات

الاسمالنوعالوصف
sheetSpreadsheetجدول البيانات

الإرجاع

SpreadsheetTriggerBuilder - واجهة SpreadsheetTriggerBuilder الجديدة

التفويض

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forSpreadsheet(key)

لإنشاء SpreadsheetTriggerBuilder مرتبط بجدول البيانات باستخدام الرقم التعريفي المحدّد وإرجاعه 

ScriptApp.newTrigger('myFunction')
    .forSpreadsheet('1234567890abcdefghijklmnopqrstuvwxyz')
    .onEdit()
    .create();

المعلمات

الاسمالنوعالوصف
keyStringرقم تعريف جدول البيانات

الإرجاع

SpreadsheetTriggerBuilder - واجهة SpreadsheetTriggerBuilder الجديدة

التفويض

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forUserCalendar(emailId)

تعرِض هذه الدالة أداة إنشاء لإنشاء عوامل تشغيل التقويم.

المعلمات

الاسمالنوعالوصف
emailIdStringرقم تعريف البريد الإلكتروني لتقويم المستخدم الذي يراقب المشغِّل

الإرجاع

CalendarTriggerBuilder - الإصدار الجديد من CalendarTriggerBuilder

التفويض

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

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.events.readonly
  • https://www.google.com/calendar/feeds

timeBased()

تُنشئ هذه الدالة ClockTriggerBuilder وتُرجعها لإنشاء عوامل تشغيل مستندة إلى الوقت. 

ScriptApp.newTrigger('myFunction').timeBased().atDate(2013, 10, 31).create();

الإرجاع

ClockTriggerBuilder — ClockTriggerBuilder الجديدة

التفويض

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

  • https://www.googleapis.com/auth/script.scriptapp