หน้านี้ได้รับการแปลโดย Cloud Translation API

Script Service

บริการนี้ให้สิทธิ์เข้าถึงทริกเกอร์สคริปต์และการเผยแพร่สคริปต์

คลาส

ชื่อ	รายละเอียดแบบย่อ
`AuthMode`	การแจงนับที่ระบุหมวดหมู่ของบริการที่ได้รับอนุญาตซึ่ง Apps Script สามารถ เรียกใช้ผ่านฟังก์ชันที่ทริกเกอร์
`AuthorizationInfo`	ออบเจ็กต์ที่ตรวจสอบว่าผู้ใช้ได้ให้สิทธิ์สำหรับขอบเขตที่จำเป็นของสคริปต์หรือไม่
`AuthorizationStatus`	การแจงนับที่ระบุสถานะการให้สิทธิ์ของสคริปต์
`CalendarTriggerBuilder`	เครื่องมือสร้างทริกเกอร์ปฏิทิน
`ClockTriggerBuilder`	เครื่องมือสร้างสำหรับทริกเกอร์นาฬิกา
`DocumentTriggerBuilder`	เครื่องมือสร้างสำหรับทริกเกอร์เอกสาร
`EventType`	การแจงนับที่ระบุประเภทของเหตุการณ์ที่ทริกเกอร์
`FormTriggerBuilder`	เครื่องมือสร้างทริกเกอร์แบบฟอร์ม
`InstallationSource`	การแจงนับที่ระบุวิธีการติดตั้งสคริปต์เป็นส่วนเสริมสำหรับผู้ใช้ปัจจุบัน
`ScriptApp`	เข้าถึงและจัดการการเผยแพร่สคริปต์และทริกเกอร์
`Service`	เข้าถึงและจัดการการเผยแพร่สคริปต์
`SpreadsheetTriggerBuilder`	เครื่องมือสร้างทริกเกอร์สเปรดชีต
`StateTokenBuilder`	อนุญาตให้สคริปต์สร้างโทเค็นสถานะที่ใช้ใน API เรียกกลับได้ (เช่น โฟลว์ OAuth)
`Trigger`	ทริกเกอร์สคริปต์
`TriggerBuilder`	เครื่องมือสร้างทั่วไปสำหรับทริกเกอร์สคริปต์
`TriggerSource`	การแจงนับที่ระบุแหล่งที่มาของเหตุการณ์ที่ทําให้ทริกเกอร์ทํางาน

`AuthMode`

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
`NONE`	`Enum`	โหมดที่ไม่อนุญาตให้เข้าถึงบริการใดๆ ที่ต้องมีการให้สิทธิ์
`CUSTOM_FUNCTION`	`Enum`	โหมดที่อนุญาตให้เข้าถึงบริการบางส่วนแบบจำกัดเพื่อใช้ในฟังก์ชันสเปรดชีตที่กำหนดเอง
`LIMITED`	`Enum`	โหมดที่อนุญาตให้เข้าถึงบริการบางส่วนแบบจำกัด
`FULL`	`Enum`	โหมดที่อนุญาตให้เข้าถึงบริการทั้งหมดที่ต้องมีการให้สิทธิ์

`AuthorizationInfo`

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getAuthorizationStatus()`	`AuthorizationStatus`	รับค่าที่ระบุว่าผู้ใช้ต้องให้สิทธิ์สคริปต์นี้เพื่อใช้บริการอย่างน้อย 1 รายการ (เช่น `ScriptApp.AuthorizationStatus.REQUIRED`) หรือไม่
`getAuthorizationUrl()`	`String\|null`	รับ URL การให้สิทธิ์ที่ใช้ให้สิทธิ์เข้าถึงสคริปต์ได้
`getAuthorizedScopes()`	`String[]\|null`	รับรายการขอบเขตที่ได้รับอนุญาตสำหรับสคริปต์

`AuthorizationStatus`

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
`REQUIRED`	`Enum`	ผู้ใช้ต้องให้สิทธิ์สคริปต์นี้เพื่อใช้บริการอย่างน้อย 1 รายการ
`NOT_REQUIRED`	`Enum`	ผู้ใช้ได้ให้สิทธิ์ทั้งหมดที่สคริปต์นี้ต้องการในปัจจุบันแล้ว

`CalendarTriggerBuilder`

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`create()`	`Trigger`	สร้างทริกเกอร์และแสดงผล
`onEventUpdated()`	`CalendarTriggerBuilder`	ระบุทริกเกอร์ที่จะเริ่มทำงานเมื่อมีการสร้าง อัปเดต หรือลบรายการในปฏิทิน

`ClockTriggerBuilder`

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`after(durationMilliseconds)`	`ClockTriggerBuilder`	ระบุระยะเวลาขั้นต่ำ (เป็นมิลลิวินาที) หลังจากเวลาปัจจุบันที่ทริกเกอร์จะทำงาน
`at(date)`	`ClockTriggerBuilder`	ระบุเวลาที่ทริกเกอร์ทำงาน
`atDate(year, month, day)`	`ClockTriggerBuilder`	ระบุว่าทริกเกอร์จะเริ่มทำงานในวันที่ที่ระบุ โดยค่าเริ่มต้นจะเริ่มทำงานใกล้กับเวลาเที่ยงคืน (+/- 15 นาที)
`atHour(hour)`	`ClockTriggerBuilder`	ระบุชั่วโมงที่ทริกเกอร์ทำงาน
`create()`	`Trigger`	สร้างทริกเกอร์
`everyDays(n)`	`ClockTriggerBuilder`	ระบุให้เรียกใช้ทริกเกอร์ทุก `n` วัน
`everyHours(n)`	`ClockTriggerBuilder`	ระบุให้เรียกใช้ทริกเกอร์ทุก `n` ชั่วโมง
`everyMinutes(n)`	`ClockTriggerBuilder`	ระบุให้เรียกใช้ทริกเกอร์ทุกๆ `n` นาที
`everyWeeks(n)`	`ClockTriggerBuilder`	ระบุให้เรียกใช้ทริกเกอร์ทุก `n` สัปดาห์
`inTimezone(timezone)`	`ClockTriggerBuilder`	ระบุเขตเวลาสำหรับวันที่/เวลาที่ระบุเมื่อทริกเกอร์ทำงาน
`nearMinute(minute)`	`ClockTriggerBuilder`	ระบุนาทีที่ทริกเกอร์ทำงาน (บวกหรือลบ 15 นาที)
`onMonthDay(day)`	`ClockTriggerBuilder`	ระบุวันที่ในเดือนที่จะเรียกใช้ทริกเกอร์
`onWeekDay(day)`	`ClockTriggerBuilder`	ระบุวันในสัปดาห์ที่ทริกเกอร์ทำงาน

`DocumentTriggerBuilder`

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`create()`	`Trigger`	สร้างและแสดงผลทริกเกอร์ใหม่
`onOpen()`	`DocumentTriggerBuilder`	ระบุทริกเกอร์ที่จะเริ่มทำงานเมื่อเปิดเอกสาร

`EventType`

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
`CLOCK`	`Enum`	ทริกเกอร์จะเริ่มทำงานเมื่อเหตุการณ์ที่อิงตามเวลาถึงเวลาที่กำหนด
`ON_OPEN`	`Enum`	ทริกเกอร์จะทำงานเมื่อผู้ใช้เปิดไฟล์ Google เอกสาร, ชีต หรือฟอร์ม
`ON_EDIT`	`Enum`	ทริกเกอร์จะทำงานเมื่อผู้ใช้แก้ไขไฟล์ Google ชีต (เช่น ป้อนค่าใหม่ลงในเซลล์ ซึ่งถือเป็นการแก้ไขแทนการเปลี่ยนแปลง)
`ON_FORM_SUBMIT`	`Enum`	ทริกเกอร์จะทำงานเมื่อผู้ใช้ตอบแบบฟอร์มของ Google
`ON_CHANGE`	`Enum`	ทริกเกอร์จะทำงานเมื่อผู้ใช้เปลี่ยนไฟล์ Google ชีต (เช่น โดยการเพิ่มแถว ซึ่งถือเป็นการเปลี่ยนแปลงแทนการแก้ไข)
`ON_EVENT_UPDATED`	`Enum`	ทริกเกอร์จะทำงานเมื่อมีการสร้าง อัปเดต หรือลบกิจกรรมใน Google ปฏิทินที่ระบุ

`FormTriggerBuilder`

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`create()`	`Trigger`	สร้างและแสดงผลทริกเกอร์ใหม่
`onFormSubmit()`	`FormTriggerBuilder`	ระบุทริกเกอร์ที่จะเริ่มทำงานเมื่อมีการส่งคำตอบไปยังแบบฟอร์ม
`onOpen()`	`FormTriggerBuilder`	ระบุทริกเกอร์ที่จะเริ่มทำงานเมื่อเปิดมุมมองแก้ไขของแบบฟอร์ม

`InstallationSource`

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
`APPS_MARKETPLACE_DOMAIN_ADD_ON`	`Enum`	ผู้ดูแลระบบติดตั้งส่วนเสริมสำหรับโดเมนของผู้ใช้
`NONE`	`Enum`	สคริปต์ไม่ได้ทำงานเป็นส่วนเสริม
`WEB_STORE_ADD_ON`	`Enum`	ผู้ใช้ติดตั้งส่วนเสริมจาก Chrome เว็บสโตร์

`ScriptApp`

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
`AuthMode`	`AuthMode`	การแจงนับที่ระบุหมวดหมู่ของบริการที่ได้รับอนุญาตซึ่ง Apps Script สามารถ เรียกใช้ผ่านฟังก์ชันที่ทริกเกอร์
`AuthorizationStatus`	`AuthorizationStatus`	การแจงนับที่ระบุสถานะการให้สิทธิ์ของสคริปต์
`EventType`	`EventType`	การแจงนับที่ระบุประเภทของเหตุการณ์ที่ทริกเกอร์
`InstallationSource`	`InstallationSource`	การแจงนับที่ระบุวิธีการติดตั้งสคริปต์ให้กับผู้ใช้ในรูปแบบของส่วนเสริม
`TriggerSource`	`TriggerSource`	การแจงนับที่ระบุแหล่งที่มาของเหตุการณ์ที่ทําให้ทริกเกอร์ทํางาน
`WeekDay`	`Weekday`	การแจงนับที่แสดงวันในสัปดาห์

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`deleteTrigger(trigger)`	`void`	นำทริกเกอร์ที่ระบุออกเพื่อไม่ให้ทำงานอีกต่อไป
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	รับออบเจ็กต์ที่ตรวจสอบว่าผู้ใช้ได้ให้สิทธิ์สำหรับข้อกำหนดของสคริปต์ทั้งหมดหรือไม่
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	รับออบเจ็กต์ที่ตรวจสอบว่าผู้ใช้ได้ให้สิทธิ์สำหรับขอบเขตที่ขอหรือไม่
`getIdentityToken()`	`String\|null`	รับโทเค็นข้อมูลประจำตัว OpenID Connect สำหรับ ผู้ใช้ที่มีประสิทธิภาพ หากได้รับขอบเขต `openid`
`getInstallationSource()`	`InstallationSource`	แสดงค่า Enum ที่ระบุวิธีติดตั้งสคริปต์เป็นส่วนเสริมสำหรับ ผู้ใช้ปัจจุบัน (เช่น ผู้ใช้ติดตั้งด้วยตนเองผ่าน Chrome เว็บสโตร์ หรือผู้ดูแลระบบโดเมนติดตั้งให้ผู้ใช้ทั้งหมด)
`getOAuthToken()`	`String`	รับโทเค็น การเข้าถึง OAuth 2.0 สำหรับผู้ใช้ที่มีผล
`getProjectTriggers()`	`Trigger[]`	รับทริกเกอร์ที่ติดตั้งได้ทั้งหมดที่เชื่อมโยงกับโปรเจ็กต์ปัจจุบันและผู้ใช้ปัจจุบัน
`getScriptId()`	`String`	รับรหัสที่ไม่ซ้ำกันของโปรเจ็กต์สคริปต์
`getService()`	`Service`	รับออบเจ็กต์ที่ใช้เพื่อควบคุมการเผยแพร่สคริปต์เป็นเว็บแอป
`getUserTriggers(document)`	`Trigger[]`	รับทริกเกอร์ที่ติดตั้งได้ทั้งหมดซึ่งผู้ใช้เป็นเจ้าของในเอกสารที่ระบุ สำหรับสคริปต์หรือส่วนเสริมนี้เท่านั้น
`getUserTriggers(form)`	`Trigger[]`	รับทริกเกอร์ที่ติดตั้งได้ทั้งหมดซึ่งผู้ใช้เป็นเจ้าของในแบบฟอร์มที่ระบุ สำหรับสคริปต์หรือส่วนเสริมนี้เท่านั้น
`getUserTriggers(spreadsheet)`	`Trigger[]`	รับทริกเกอร์ที่ติดตั้งได้ทั้งหมดซึ่งผู้ใช้เป็นเจ้าของในสเปรดชีตที่ระบุ สำหรับสคริปต์หรือส่วนเสริมนี้เท่านั้น
`invalidateAuth()`	`void`	ยกเลิกการให้สิทธิ์ที่ผู้ใช้ที่มีผลบังคับใช้มีในการเรียกใช้สคริปต์ปัจจุบัน
`newStateToken()`	`StateTokenBuilder`	สร้างเครื่องมือสร้างโทเค็นสถานะที่ใช้ใน API เรียกกลับได้ (เช่น โฟลว์ OAuth)
`newTrigger(functionName)`	`TriggerBuilder`	เริ่มกระบวนการสร้างทริกเกอร์ที่ติดตั้งได้ ซึ่งจะเรียกฟังก์ชันที่ระบุเมื่อทริกเกอร์ทำงาน
`requireAllScopes(authMode)`	`void`	ตรวจสอบว่าผู้ใช้ได้ให้ความยินยอมสำหรับขอบเขตทั้งหมดที่สคริปต์ร้องขอหรือไม่
`requireScopes(authMode, oAuthScopes)`	`void`	ตรวจสอบว่าผู้ใช้ให้ความยินยอมสำหรับขอบเขตที่ขอหรือไม่

`Service`

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getUrl()`	`String`	แสดง URL ของเว็บแอปหากมีการติดตั้งใช้งานแล้ว หรือแสดง `null` หากไม่มีการติดตั้งใช้งาน
`isEnabled()`	`Boolean`	แสดง `true` หากเข้าถึงสคริปต์เป็นเว็บแอปได้

`SpreadsheetTriggerBuilder`

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`create()`	`Trigger`	สร้างทริกเกอร์และแสดงผล
`onChange()`	`SpreadsheetTriggerBuilder`	ระบุทริกเกอร์ที่จะเริ่มทำงานเมื่อมีการเปลี่ยนแปลงเนื้อหาหรือโครงสร้างของสเปรดชีต
`onEdit()`	`SpreadsheetTriggerBuilder`	ระบุทริกเกอร์ที่จะเริ่มทำงานเมื่อมีการแก้ไขสเปรดชีต
`onFormSubmit()`	`SpreadsheetTriggerBuilder`	ระบุทริกเกอร์ที่จะเริ่มทำงานเมื่อมีการส่งแบบฟอร์มไปยังสเปรดชีต
`onOpen()`	`SpreadsheetTriggerBuilder`	ระบุทริกเกอร์ที่จะเริ่มทำงานเมื่อเปิดสเปรดชีต

`StateTokenBuilder`

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`createToken()`	`String`	สร้างการแสดงสตริงที่เข้ารหัสของโทเค็นสถานะ
`withArgument(name, value)`	`StateTokenBuilder`	เพิ่มอาร์กิวเมนต์ลงในโทเค็น
`withMethod(method)`	`StateTokenBuilder`	ตั้งค่าฟังก์ชัน Callback
`withTimeout(seconds)`	`StateTokenBuilder`	ตั้งค่าระยะเวลา (เป็นวินาที) ที่โทเค็นใช้งานได้

`Trigger`

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getEventType()`	`EventType`	แสดงประเภทเหตุการณ์ที่ทริกเกอร์เริ่มทำงาน
`getHandlerFunction()`	`String`	แสดงผลฟังก์ชันที่จะเรียกใช้เมื่อทริกเกอร์ทำงาน
`getTriggerSource()`	`TriggerSource`	แสดงผลแหล่งที่มาของเหตุการณ์ที่จะทําให้ทริกเกอร์เริ่มทํางาน
`getTriggerSourceId()`	`String`	แสดงรหัสที่เฉพาะเจาะจงกับแหล่งที่มา
`getUniqueId()`	`String`	แสดงตัวระบุที่ไม่ซ้ำกันซึ่งใช้แยกความแตกต่างระหว่างทริกเกอร์ได้

`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` สำหรับสร้างทริกเกอร์ตามเวลา

`TriggerSource`

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
`SPREADSHEETS`	`Enum`	Google ชีตทำให้ทริกเกอร์เริ่มทำงาน
`CLOCK`	`Enum`	เหตุการณ์ที่อิงตามเวลาจะทําให้ทริกเกอร์เริ่มทํางาน
`FORMS`	`Enum`	Google ฟอร์มทำให้ทริกเกอร์ทำงาน
`DOCUMENTS`	`Enum`	Google เอกสารทำให้ทริกเกอร์เริ่มทำงาน
`CALENDAR`	`Enum`	Google ปฏิทินทำให้ทริกเกอร์ทำงาน

เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ

อัปเดตล่าสุด 2025-12-11 UTC

บล็อก
อ่านบล็อกของนักพัฒนาซอฟต์แวร์ Google Workspace
Stack Overflow
ถามคําถามภายใต้แท็ก google-apps-script
ตัวอย่างโค้ด
ดูตัวอย่างโค้ดของเราหรือคัดลอกมาสร้างของคุณเอง
วิดีโอ
ดูบทแนะนํา Apps Script