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