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