این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class 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