Script Service

Script

Dịch vụ này cung cấp quyền truy cập vào trình kích hoạt tập lệnh và phát hành tập lệnh.

Lớp

Tên	Mô tả ngắn
AuthMode	Một enum xác định những danh mục dịch vụ được uỷ quyền mà Apps Script có thể thực thi thông qua một hàm được kích hoạt.
AuthorizationInfo	Một đối tượng kiểm tra xem người dùng đã cấp quyền cho các phạm vi bắt buộc của tập lệnh hay chưa.
AuthorizationStatus	Một enum biểu thị trạng thái uỷ quyền của một tập lệnh.
CalendarTriggerBuilder	Trình tạo cho trình kích hoạt lịch.
ClockTriggerBuilder	Trình tạo cho trình kích hoạt đồng hồ.
DocumentTriggerBuilder	Trình tạo cho trình kích hoạt tài liệu.
EventType	Một enum biểu thị loại sự kiện được kích hoạt.
FormTriggerBuilder	Trình tạo cho trình kích hoạt biểu mẫu.
InstallationSource	Một liệt kê cho biết cách cài đặt tập lệnh dưới dạng tiện ích bổ sung cho người dùng hiện tại.
ScriptApp	Truy cập và thao tác với tính năng phát hành tập lệnh và trình kích hoạt.
Service	Truy cập và thao tác với hoạt động phát hành tập lệnh.
SpreadsheetTriggerBuilder	Trình tạo cho trình kích hoạt bảng tính.
StateTokenBuilder	Cho phép tập lệnh tạo mã thông báo trạng thái có thể dùng trong các API gọi lại (như luồng OAuth).
Trigger	Một điều kiện kích hoạt tập lệnh.
TriggerBuilder	Trình tạo chung cho trình kích hoạt tập lệnh.
TriggerSource	Một enum biểu thị nguồn của sự kiện kích hoạt điều kiện kích hoạt.

AuthMode

Thuộc tính

Thuộc tính	Loại	Mô tả
NONE	Enum	Chế độ không cho phép truy cập vào bất kỳ dịch vụ nào yêu cầu uỷ quyền.
CUSTOM_FUNCTION	Enum	Một chế độ cho phép truy cập vào một tập hợp con dịch vụ có giới hạn để sử dụng trong các hàm bảng tính tùy chỉnh.
LIMITED	Enum	Một chế độ cho phép truy cập vào một nhóm dịch vụ có giới hạn.
FULL	Enum	Chế độ cho phép truy cập vào tất cả các dịch vụ yêu cầu uỷ quyền.

AuthorizationInfo

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
getAuthorizationStatus()	AuthorizationStatus	Lấy một giá trị cho biết người dùng có cần uỷ quyền cho tập lệnh này sử dụng một hoặc nhiều dịch vụ hay không (ví dụ: ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()	String	Lấy URL uỷ quyền có thể dùng để cấp quyền truy cập vào tập lệnh.
getAuthorizedScopes()	String[]	Lấy danh sách các phạm vi được uỷ quyền cho tập lệnh.

AuthorizationStatus

Thuộc tính

Thuộc tính	Loại	Mô tả
REQUIRED	Enum	Người dùng cần uỷ quyền cho tập lệnh này để sử dụng một hoặc nhiều dịch vụ.
NOT_REQUIRED	Enum	Người dùng đã cấp cho tập lệnh này tất cả các quyền mà tập lệnh hiện yêu cầu.

CalendarTriggerBuilder

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
create()	Trigger	Tạo điều kiện kích hoạt và trả về điều kiện kích hoạt đó.
onEventUpdated()	CalendarTriggerBuilder	Chỉ định một điều kiện kích hoạt sẽ kích hoạt khi một mục trong lịch được tạo, cập nhật hoặc xoá.

ClockTriggerBuilder

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
after(durationMilliseconds)	ClockTriggerBuilder	Chỉ định thời lượng tối thiểu (tính bằng mili giây) sau thời điểm hiện tại mà điều kiện kích hoạt chạy.
at(date)	ClockTriggerBuilder	Chỉ định thời điểm trình kích hoạt chạy.
atDate(year, month, day)	ClockTriggerBuilder	Chỉ định rằng điều kiện kích hoạt sẽ kích hoạt vào ngày đã cho, theo mặc định là gần nửa đêm (+/- 15 phút).
atHour(hour)	ClockTriggerBuilder	Chỉ định giờ mà điều kiện kích hoạt chạy.
create()	Trigger	Tạo điều kiện kích hoạt.
everyDays(n)	ClockTriggerBuilder	Chỉ định chạy điều kiện kích hoạt n ngày một lần.
everyHours(n)	ClockTriggerBuilder	Chỉ định chạy điều kiện kích hoạt sau mỗi n giờ.
everyMinutes(n)	ClockTriggerBuilder	Chỉ định chạy điều kiện kích hoạt mỗi n phút.
everyWeeks(n)	ClockTriggerBuilder	Chỉ định chạy điều kiện kích hoạt n tuần một lần.
inTimezone(timezone)	ClockTriggerBuilder	Chỉ định múi giờ cho ngày/giờ được chỉ định khi điều kiện kích hoạt chạy.
nearMinute(minute)	ClockTriggerBuilder	Chỉ định phút mà điều kiện kích hoạt chạy (thêm hoặc trừ 15 phút).
onMonthDay(day)	ClockTriggerBuilder	Chỉ định ngày trong tháng mà điều kiện kích hoạt chạy.
onWeekDay(day)	ClockTriggerBuilder	Chỉ định ngày trong tuần mà điều kiện kích hoạt chạy.

DocumentTriggerBuilder

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
create()	Trigger	Tạo và trả về điều kiện kích hoạt mới.
onOpen()	DocumentTriggerBuilder	Chỉ định một điều kiện kích hoạt sẽ kích hoạt khi tài liệu được mở.

EventType

Thuộc tính

Thuộc tính	Loại	Mô tả
CLOCK	Enum	Trình kích hoạt sẽ kích hoạt sau khi sự kiện do thời gian điều khiển đạt đến một thời điểm cụ thể.
ON_OPEN	Enum	Điều kiện kích hoạt sẽ kích hoạt sau khi người dùng mở tệp Google Tài liệu, Trang tính hoặc Biểu mẫu.
ON_EDIT	Enum	Điều kiện kích hoạt sẽ kích hoạt sau khi người dùng chỉnh sửa tệp Google Trang tính (ví dụ: bằng cách nhập một giá trị mới vào một ô, giá trị này được tính là một nội dung chỉnh sửa thay vì một nội dung thay đổi).
ON_FORM_SUBMIT	Enum	Điều kiện kích hoạt sẽ kích hoạt sau khi người dùng trả lời một Biểu mẫu Google.
ON_CHANGE	Enum	Điều kiện kích hoạt sẽ kích hoạt sau khi người dùng thay đổi tệp Google Trang tính (ví dụ: bằng cách thêm một hàng, điều này được tính là thay đổi thay vì chỉnh sửa).
ON_EVENT_UPDATED	Enum	Điều kiện kích hoạt sẽ kích hoạt sau khi một sự kiện được tạo, cập nhật hoặc xoá trên Lịch Google được chỉ định.

FormTriggerBuilder

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
create()	Trigger	Tạo và trả về điều kiện kích hoạt mới.
onFormSubmit()	FormTriggerBuilder	Chỉ định một điều kiện kích hoạt sẽ kích hoạt khi người dùng gửi phản hồi vào biểu mẫu.
onOpen()	FormTriggerBuilder	Chỉ định một điều kiện kích hoạt sẽ kích hoạt khi mở chế độ xem chỉnh sửa của biểu mẫu.

InstallationSource

Thuộc tính

Thuộc tính	Loại	Mô tả
APPS_MARKETPLACE_DOMAIN_ADD_ON	Enum	Tiện ích bổ sung do quản trị viên cài đặt cho miền của người dùng.
NONE	Enum	Tập lệnh không chạy dưới dạng tiện ích bổ sung.
WEB_STORE_ADD_ON	Enum	Tiện ích bổ sung do người dùng cài đặt từ Cửa hàng Chrome trực tuyến.

ScriptApp

Thuộc tính

Thuộc tính	Loại	Mô tả
AuthMode	AuthMode	Một enum xác định những danh mục dịch vụ được uỷ quyền mà Apps Script có thể thực thi thông qua một hàm được kích hoạt.
AuthorizationStatus	AuthorizationStatus	Một enum biểu thị trạng thái uỷ quyền của một tập lệnh.
EventType	EventType	Một enum biểu thị loại sự kiện được kích hoạt.
InstallationSource	InstallationSource	Một liệt kê cho biết cách cài đặt tập lệnh cho người dùng dưới dạng tiện ích bổ sung.
TriggerSource	TriggerSource	Một enum biểu thị nguồn của sự kiện khiến điều kiện kích hoạt hoạt động.
WeekDay	Weekday	Một enum đại diện cho các ngày trong tuần.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
deleteTrigger(trigger)	void	Xoá điều kiện kích hoạt đã cho để điều kiện kích hoạt đó không còn chạy nữa.
getAuthorizationInfo(authMode)	AuthorizationInfo	Lấy một đối tượng kiểm tra xem người dùng đã cấp quyền cho tất cả các yêu cầu về tập lệnh hay chưa.
getAuthorizationInfo(authMode, oAuthScopes)	AuthorizationInfo	Lấy một đối tượng kiểm tra xem người dùng đã cấp quyền cho các phạm vi được yêu cầu hay chưa.
getIdentityToken()	String	Nhận mã thông báo danh tính OpenID Connect cho người dùng hiệu quả, nếu phạm vi openid đã được cấp.
getInstallationSource()	InstallationSource	Trả về một giá trị enum cho biết cách tập lệnh được cài đặt dưới dạng tiện ích bổ sung cho người dùng hiện tại (ví dụ: liệu người dùng có tự cài đặt tập lệnh đó thông qua Cửa hàng Chrome trực tuyến hay không, hoặc liệu quản trị viên miền có cài đặt tập lệnh đó cho tất cả người dùng hay không).
getOAuthToken()	String	Lấy mã truy cập OAuth 2.0 cho người dùng hợp lệ.
getProjectTriggers()	Trigger[]	Lấy tất cả các trình kích hoạt có thể cài đặt được liên kết với dự án hiện tại và người dùng hiện tại.
getScriptId()	String	Lấy mã nhận dạng duy nhất của dự án tập lệnh.
getService()	Service	Lấy một đối tượng dùng để kiểm soát việc phát hành tập lệnh dưới dạng ứng dụng web.
getUserTriggers(document)	Trigger[]	Lấy tất cả trình kích hoạt có thể cài đặt mà người dùng này sở hữu trong tài liệu đã cho, chỉ dành cho tập lệnh hoặc tiện ích bổ sung này.
getUserTriggers(form)	Trigger[]	Lấy tất cả các trình kích hoạt có thể cài đặt mà người dùng này sở hữu ở dạng đã cho, chỉ dành cho tập lệnh hoặc tiện ích bổ sung này.
getUserTriggers(spreadsheet)	Trigger[]	Lấy tất cả trình kích hoạt có thể cài đặt mà người dùng này sở hữu trong bảng tính đã cho, chỉ dành cho tập lệnh hoặc tiện ích bổ sung này.
invalidateAuth()	void	Làm mất hiệu lực quyền uỷ quyền mà người dùng hợp lệ có để thực thi tập lệnh hiện tại.
newStateToken()	StateTokenBuilder	Tạo một trình tạo cho mã thông báo trạng thái có thể được sử dụng trong API gọi lại (chẳng hạn như luồng OAuth).
newTrigger(functionName)	TriggerBuilder	Bắt đầu quá trình tạo một trình kích hoạt có thể cài đặt. Khi được kích hoạt, trình kích hoạt này sẽ gọi một hàm nhất định.
requireAllScopes(authMode)	void	Xác thực xem người dùng đã đồng ý cho tất cả các phạm vi mà tập lệnh yêu cầu hay chưa.
requireScopes(authMode, oAuthScopes)	void	Xác thực xem người dùng đã đồng ý với các phạm vi được yêu cầu hay chưa.

Service

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
getUrl()	String	Trả về URL của ứng dụng web, nếu ứng dụng đó đã được triển khai; nếu không, trả về null.
isEnabled()	Boolean	Trả về true nếu có thể truy cập vào tập lệnh dưới dạng ứng dụng web.

SpreadsheetTriggerBuilder

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
create()	Trigger	Tạo điều kiện kích hoạt và trả về điều kiện kích hoạt đó.
onChange()	SpreadsheetTriggerBuilder	Chỉ định một điều kiện kích hoạt sẽ kích hoạt khi nội dung hoặc cấu trúc của bảng tính thay đổi.
onEdit()	SpreadsheetTriggerBuilder	Chỉ định một điều kiện kích hoạt sẽ kích hoạt khi bảng tính được chỉnh sửa.
onFormSubmit()	SpreadsheetTriggerBuilder	Chỉ định một điều kiện kích hoạt sẽ kích hoạt khi bảng tính có một biểu mẫu được gửi đến.
onOpen()	SpreadsheetTriggerBuilder	Chỉ định một điều kiện kích hoạt sẽ kích hoạt khi bảng tính được mở.

StateTokenBuilder

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
createToken()	String	Tạo một chuỗi đã mã hoá đại diện cho mã thông báo trạng thái.
withArgument(name, value)	StateTokenBuilder	Thêm một đối số vào mã thông báo.
withMethod(method)	StateTokenBuilder	Đặt một hàm gọi lại.
withTimeout(seconds)	StateTokenBuilder	Đặt thời lượng (tính bằng giây) mà mã thông báo có hiệu lực.

Trigger

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
getEventType()	EventType	Trả về loại sự kiện mà điều kiện kích hoạt sẽ kích hoạt.
getHandlerFunction()	String	Trả về hàm sẽ được gọi khi điều kiện kích hoạt được kích hoạt.
getTriggerSource()	TriggerSource	Trả về nguồn sự kiện sẽ kích hoạt điều kiện kích hoạt.
getTriggerSourceId()	String	Trả về mã nhận dạng dành riêng cho nguồn.
getUniqueId()	String	Trả về một giá trị nhận dạng duy nhất có thể dùng để phân biệt các trình kích hoạt với nhau.

TriggerBuilder

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
forDocument(document)	DocumentTriggerBuilder	Tạo và trả về một DocumentTriggerBuilder liên kết với tài liệu đã cho.
forDocument(key)	DocumentTriggerBuilder	Tạo và trả về một DocumentTriggerBuilder liên kết với tài liệu có mã nhận dạng đã cho.
forForm(form)	FormTriggerBuilder	Tạo và trả về một FormTriggerBuilder liên kết với biểu mẫu đã cho.
forForm(key)	FormTriggerBuilder	Tạo và trả về một FormTriggerBuilder liên kết với biểu mẫu có mã nhận dạng đã cho.
forSpreadsheet(sheet)	SpreadsheetTriggerBuilder	Tạo và trả về một SpreadsheetTriggerBuilder liên kết với bảng tính đã cho.
forSpreadsheet(key)	SpreadsheetTriggerBuilder	Tạo và trả về một SpreadsheetTriggerBuilder liên kết với bảng tính có mã nhận dạng đã cho.
forUserCalendar(emailId)	CalendarTriggerBuilder	Trả về một trình tạo để tạo trình kích hoạt lịch.
timeBased()	ClockTriggerBuilder	Tạo và trả về ClockTriggerBuilder để tạo điều kiện kích hoạt dựa trên thời gian.

TriggerSource

Thuộc tính

Thuộc tính	Loại	Mô tả
SPREADSHEETS	Enum	Google Trang tính sẽ kích hoạt điều kiện kích hoạt.
CLOCK	Enum	Sự kiện dựa trên thời gian sẽ kích hoạt điều kiện kích hoạt.
FORMS	Enum	Google Forms kích hoạt điều kiện kích hoạt.
DOCUMENTS	Enum	Google Tài liệu sẽ kích hoạt điều kiện kích hoạt.
CALENDAR	Enum	Lịch Google kích hoạt điều kiện kích hoạt.