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

المعلمات

الاسم	النوع	الوصف
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: الإصدار الجديد 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: الإصدار الجديد 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 — الإصدار الجديد SpreadsheetTriggerBuilder

التفويض

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

• 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 — الإصدار الجديد SpreadsheetTriggerBuilder

التفويض

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

• 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: أداة ClockTriggerBuilder الجديدة

التفويض

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

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