Class TriggerBuilder

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();

المَعلمات

الاسمTypeالوصف
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();

المَعلمات

الاسمTypeالوصف
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();

المَعلمات

الاسمTypeالوصف
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();

المَعلمات

الاسمTypeالوصف
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();

المَعلمات

الاسمTypeالوصف
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();

المَعلمات

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

استرجاع الكرة

SpreadsheetTriggerBuilder — الإصدار الجديد SpreadsheetTriggerBuilder

التفويض

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

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

forUserCalendar(emailId)

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

المَعلمات

الاسمTypeالوصف
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