Class TriggerBuilder

سازنده ماشه

یک سازنده عمومی برای تریگرهای اسکریپت.

روش‌ها

روش	نوع بازگشتی	شرح مختصر
for Document(document)	Document Trigger Builder	یک Document Trigger Builder مرتبط با سند داده شده ایجاد و برمی‌گرداند.
for Document(key)	Document Trigger Builder	یک Document Trigger Builder مرتبط با سند با شناسه‌ی داده شده ایجاد و برمی‌گرداند.
for Form(form)	Form Trigger Builder	یک Form Trigger Builder مرتبط با فرم داده شده ایجاد و برمی‌گرداند.
for Form(key)	Form Trigger Builder	یک Form Trigger Builder مرتبط با فرم با شناسه داده شده ایجاد و برمی‌گرداند.
for Spreadsheet(sheet)	Spreadsheet Trigger Builder	یک Spreadsheet Trigger Builder مرتبط با صفحه گسترده‌ی داده شده ایجاد و برمی‌گرداند.
for Spreadsheet(key)	Spreadsheet Trigger Builder	یک Spreadsheet Trigger Builder مرتبط با صفحه گسترده با شناسه‌ی داده شده ایجاد و برمی‌گرداند.
for User Calendar(emailId)	Calendar Trigger Builder	یک سازنده برای ساخت محرک‌های تقویم برمی‌گرداند.
time Based()	Clock Trigger Builder	یک Clock Trigger Builder برای ساخت ماشه‌های مبتنی بر زمان ایجاد و برمی‌گرداند.

مستندات دقیق

for Document(document)

یک Document Trigger Builder مرتبط با سند داده شده ایجاد و برمی‌گرداند.

ScriptApp.newTrigger('myFunction')
    .forDocument(DocumentApp.getActiveDocument())
    .onOpen()
    .create();

پارامترها

نام	نوع	توضیحات
document	Document	سند.

بازگشت

Document Trigger Builder - سازنده‌ی جدید محرک سند.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

---

for Document(key)

یک Document Trigger Builder مرتبط با سند با شناسه‌ی داده شده ایجاد و برمی‌گرداند.

ScriptApp.newTrigger('myFunction')
    .forDocument('1234567890abcdefghijklmnopqrstuvwxyz')
    .onOpen()
    .create();

پارامترها

نام	نوع	توضیحات
key	String	شناسه سند.

بازگشت

Document Trigger Builder - سازنده‌ی جدید محرک سند.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

---

for Form(form)

یک Form Trigger Builder مرتبط با فرم داده شده ایجاد و برمی‌گرداند.

ScriptApp.newTrigger('myFunction')
    .forForm(FormApp.getActiveForm())
    .onFormSubmit()
    .create();

پارامترها

نام	نوع	توضیحات
form	Form	فرم.

بازگشت

Form Trigger Builder - سازنده جدید ماشه فرم.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

for Form(key)

یک Form Trigger Builder مرتبط با فرم با شناسه داده شده ایجاد و برمی‌گرداند.

ScriptApp.newTrigger('myFunction')
    .forForm('1234567890abcdefghijklmnopqrstuvwxyz')
    .onFormSubmit()
    .create();

پارامترها

نام	نوع	توضیحات
key	String	شناسه فرم.

بازگشت

Form Trigger Builder - سازنده جدید ماشه فرم.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

for Spreadsheet(sheet)

یک Spreadsheet Trigger Builder مرتبط با صفحه گسترده‌ی داده شده ایجاد و برمی‌گرداند.

ScriptApp.newTrigger('myFunction')
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onEdit()
    .create();

پارامترها

نام	نوع	توضیحات
sheet	Spreadsheet	صفحه گسترده.

بازگشت

Spreadsheet Trigger Builder - سازنده‌ی ماشه صفحه گسترده جدید.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

for Spreadsheet(key)

یک Spreadsheet Trigger Builder مرتبط با صفحه گسترده با شناسه‌ی داده شده ایجاد و برمی‌گرداند.

ScriptApp.newTrigger('myFunction')
    .forSpreadsheet('1234567890abcdefghijklmnopqrstuvwxyz')
    .onEdit()
    .create();

پارامترها

نام	نوع	توضیحات
key	String	شناسه‌ی صفحه‌گسترده.

بازگشت

Spreadsheet Trigger Builder - سازنده‌ی ماشه صفحه گسترده جدید.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

for User Calendar(emailId)

یک سازنده برای ساخت محرک‌های تقویم برمی‌گرداند.

پارامترها

نام	نوع	توضیحات
email Id	String	شناسه ایمیل تقویم کاربری که تریگر آن را رصد می‌کند.

بازگشت

Calendar Trigger Builder - سازنده‌ی محرک تقویم جدید.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

• 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

---

time Based()

یک Clock Trigger Builder برای ساخت ماشه‌های مبتنی بر زمان ایجاد و برمی‌گرداند.

ScriptApp.newTrigger('myFunction').timeBased().atDate(2013, 10, 31).create();

بازگشت

Clock Trigger Builder - سازنده جدید ماشه ساعت.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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