تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

المعلّمات

الاسم	النوع	الوصف
`document`	`Document`	المستند

تذكرة ذهاب وعودة

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

المعلّمات

الاسم	النوع	الوصف
`key`	`String`	رقم تعريف المستند

تذكرة ذهاب وعودة

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

المعلّمات

الاسم	النوع	الوصف
`form`	`Form`	النموذج

تذكرة ذهاب وعودة

FormTriggerBuilder: النموذج الجديد مشغّل النموذج

التفويض

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

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

`forForm(key)`

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

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

المعلّمات

الاسم	النوع	الوصف
`key`	`String`	رقم تعريف النموذج

تذكرة ذهاب وعودة

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

المعلّمات

الاسم	النوع	الوصف
`sheet`	`Spreadsheet`	جدول البيانات

تذكرة ذهاب وعودة

SpreadsheetTriggerBuilder — جدول البيانات الجديد TriggerTriggerBuilder

التفويض

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

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

`forSpreadsheet(key)`

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

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

المعلّمات

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

تذكرة ذهاب وعودة

SpreadsheetTriggerBuilder — جدول البيانات الجديد TriggerTriggerBuilder

التفويض

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

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

`forUserCalendar(emailId)`

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

المعلّمات

الاسم	النوع	الوصف
`emailId`	`String`	رقم تعريف البريد الإلكتروني لتقويم المستخدم الذي يراقبه المشغّل.

تذكرة ذهاب وعودة

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 — الإصدار الجديد من WatchTriggerBuilder

التفويض

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

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