أداة إنشاء عامة لمشغِّلات النصوص البرمجية.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
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