หน้านี้ได้รับการแปลโดย 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`	รับ URL การให้สิทธิ์ที่สามารถใช้เพื่อมอบสิทธิ์เข้าถึงสคริปต์
`getAuthorizedScopes()`	`String[]`	รับรายการขอบเขตที่ได้รับอนุญาตสำหรับสคริปต์

`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`	รับโทเค็นข้อมูลประจำตัว 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-01-08 UTC

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