أداة إنشاء عامة لمشغِّلات النصوص البرمجية
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
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();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
key | String | رقم تعريف جدول البيانات |
استرجاع الكرة
SpreadsheetTriggerBuilder
— الإصدار الجديد SpreadsheetTriggerBuilder
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forUserCalendar(emailId)
تعرض أداة إنشاء لإنشاء مشغِّلات التقويم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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