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