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