Dịch vụ này cung cấp quyền truy cập vào các trình kích hoạt tập lệnh và xuất bản tập lệnh.
Lớp
| Tên | Mô tả ngắn |
|---|---|
AuthMode | Một bảng liệt kê xác định những danh mục dịch vụ được ủy quyền mà Apps Script có thể thực thi thông qua một hàm đã kích hoạt. |
AuthorizationInfo | Một đối tượng dùng để xác định xem 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, đồng thời cung cấp URL cho hộp thoại uỷ quyền. |
AuthorizationStatus | Một bảng liệt kê 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 các 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 bảng liệt kê biểu thị loại sự kiện đã kích hoạt. |
FormTriggerBuilder | Trình tạo cho trình kích hoạt biểu mẫu. |
InstallationSource | Một bảng 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 xuất bản và kích hoạt tập lệnh. |
Service | Truy cập và thao tác với tính năng xuất bản 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ể được sử dụng trong API gọi lại (như quy trình OAuth). |
Trigger | Sự kiện kích hoạt tập lệnh. |
TriggerBuilder | Trình tạo chung cho các trình kích hoạt tập lệnh. |
TriggerSource | Một bảng liệt kê biểu thị nguồn của sự kiện khiến trình kích hoạt kích hoạt. |
AuthMode
Thuộc tính
| Thuộc tính | Loại | Mô tả |
|---|---|---|
NONE | Enum | Một chế độ không cho phép truy cập vào bất kỳ dịch vụ nào cần được cho phép. |
CUSTOM_FUNCTION | Enum | Một chế độ cho phép truy cập vào một nhóm nhỏ dịch vụ để sử dụng trong các hàm bảng tính tuỳ chỉnh. |
LIMITED | Enum | Một chế độ cho phép truy cập vào một nhóm nhỏ dịch vụ bị giới hạn. |
FULL | Enum | Một chế độ cho phép truy cập vào tất cả các dịch vụ yêu cầu ủy quyền. |
AuthorizationInfo
Phương pháp
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
getAuthorizationStatus() | AuthorizationStatus | Nhận giá trị cho biết liệu người dùng có cần ủy 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 ủy quyền có thể dùng để cấp quyền truy cập vào 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 tập lệnh này tất cả quyền được tập lệnh hiện yêu cầu. |
CalendarTriggerBuilder
Phương pháp
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
create() | Trigger | Tạo trình kích hoạt và trả về trình kích hoạt. |
onEventUpdated() | CalendarTriggerBuilder | Chỉ định trình kích hoạt sẽ kích hoạt khi một mục trên lịch được tạo, cập nhật hoặc xóa. |
ClockTriggerBuilder
Phương pháp
| 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 gian hiện tại mà trình 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 trình kích hoạt sẽ kích hoạt vào một ngày nhất định theo mặc định, gần nửa đêm (+/- 15 phút). |
atHour(hour) | ClockTriggerBuilder | Chỉ định giờ mà trình kích hoạt chạy. |
create() | Trigger | Tạo trình kích hoạt. |
everyDays(n) | ClockTriggerBuilder | Chỉ định chạy trình kích hoạt n ngày một lần. |
everyHours(n) | ClockTriggerBuilder | Chỉ định chạy trình kích hoạt này n giờ một lần. |
everyMinutes(n) | ClockTriggerBuilder | Chỉ định chạy trình kích hoạt này n phút một lần. |
everyWeeks(n) | ClockTriggerBuilder | Chỉ định chạy trình kích hoạt này n tuần một lần. |
inTimezone(timezone) | ClockTriggerBuilder | Chỉ định múi giờ cho ngày/giờ được chỉ định khi trình kích hoạt chạy. |
nearMinute(minute) | ClockTriggerBuilder | Chỉ định phút mà trình kích hoạt chạy (cộng hoặc trừ 15 phút). |
onMonthDay(day) | ClockTriggerBuilder | Chỉ định ngày trong tháng mà trình kích hoạt chạy. |
onWeekDay(day) | ClockTriggerBuilder | Chỉ định ngày trong tuần mà trình kích hoạt chạy. |
DocumentTriggerBuilder
Phương pháp
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
create() | Trigger | Tạo và trả về trình kích hoạt mới. |
onOpen() | DocumentTriggerBuilder | Chỉ định một trình kích hoạt sẽ kích hoạt khi mở tài liệu. |
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 khi sự kiện theo thời gian đạt đến một thời điểm cụ thể. |
ON_OPEN | Enum | Trình 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 | Trình 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 giá trị mới vào một ô, được tính là một lượt chỉnh sửa thay vì một thay đổi). |
ON_FORM_SUBMIT | Enum | Trình kích hoạt sẽ kích hoạt sau khi người dùng trả lời Google Biểu mẫu. |
ON_CHANGE | Enum | Trình 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 được tính là một thay đổi thay vì chỉnh sửa). |
ON_EVENT_UPDATED | Enum | Trình 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 đã chỉ định. |
FormTriggerBuilder
Phương pháp
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
create() | Trigger | Tạo và trả về trình kích hoạt mới. |
onFormSubmit() | FormTriggerBuilder | Chỉ định một trình kích hoạt sẽ kích hoạt khi một phản hồi được gửi đến biểu mẫu. |
onOpen() | FormTriggerBuilder | Chỉ định một trình kích hoạt sẽ kích hoạt khi chế độ xem chỉnh sửa của biểu mẫu được mở. |
InstallationSource
Thuộc tính
| Thuộc tính | Loại | Mô tả |
|---|---|---|
APPS_MARKETPLACE_DOMAIN_ADD_ON | Enum | Quản trị viên đã cài đặt tiện ích bổ sung 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 bảng liệt kê xác định những danh mục dịch vụ được ủy quyền mà Apps Script có thể thực thi thông qua một hàm đã kích hoạt. |
AuthorizationStatus | AuthorizationStatus | Một bảng liệt kê biểu thị trạng thái uỷ quyền của một tập lệnh. |
EventType | EventType | Một bảng liệt kê biểu thị loại sự kiện đã kích hoạt. |
InstallationSource | InstallationSource | Một bảng liệt kê biểu thị 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 bảng liệt kê biểu thị nguồn của sự kiện khiến trình kích hoạt kích hoạt. |
WeekDay | Weekday | Một bảng liệt kê biểu thị các ngày trong tuần. |
Phương pháp
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
deleteTrigger(trigger) | void | Xoá trình kích hoạt đã cho để không còn chạy nữa. |
getAuthorizationInfo(authMode) | AuthorizationInfo | Lấy đối tượng dùng để xác định xem 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, đồng thời cung cấp URL cho hộp thoại uỷ quyền. |
getIdentityToken() | String | Lấy mã thông báo nhận dạng OpenID Connect cho người dùng hiệu quả, nếu phạm vi openid đã được cấp. |
getInstallationSource() | InstallationSource | Trả về giá trị enum 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 (ví dụ: liệu người dùng đã cài đặt riêng tập lệnh đó thông qua Cửa hàng Chrome trực tuyến hay quản trị viên miền đã cài đặt tập lệnh cho tất cả người dùng). |
getOAuthToken() | String | Lấy mã truy cập OAuth 2.0 cho người dùng hiệu quả. |
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 đối tượng dùng để kiểm soát việc xuất bản 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 do người dùng này sở hữu trong tài liệu nhất định, 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 do người dùng này sở hữu trong biểu mẫu nhất định, 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ả các trình kích hoạt có thể cài đặt thuộc sở hữu của người dùng này trong bảng tính nhất định, dành cho tập lệnh hoặc tiện ích bổ sung này. |
invalidateAuth() | void | Vô hiệu hóa uỷ quyền mà người dùng hiệu quả phải thực thi tập lệnh hiện tại. |
newStateToken() | StateTokenBuilder | Tạo 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 (như luồng OAuth). |
newTrigger(functionName) | TriggerBuilder | Bắt đầu quy trình tạo một trình kích hoạt có thể cài đặt, khi được kích hoạt, sẽ gọi một hàm nhất định. |
Service
Phương pháp
| 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, hàm này sẽ trả về null. |
isEnabled() | Boolean | Trả về true nếu có thể truy cập tập lệnh dưới dạng ứng dụng web. |
SpreadsheetTriggerBuilder
Phương pháp
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
create() | Trigger | Tạo trình kích hoạt và trả về trình kích hoạt. |
onChange() | SpreadsheetTriggerBuilder | Chỉ định một trình 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 được thay đổi. |
onEdit() | SpreadsheetTriggerBuilder | Chỉ định một trình kích hoạt sẽ kích hoạt khi bạn chỉnh sửa bảng tính. |
onFormSubmit() | SpreadsheetTriggerBuilder | Chỉ định một trình kích hoạt sẽ kích hoạt khi bảng tính được gửi đến biểu mẫu. |
onOpen() | SpreadsheetTriggerBuilder | Chỉ định một trình kích hoạt sẽ kích hoạt khi mở bảng tính. |
StateTokenBuilder
Phương pháp
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
createToken() | String | Xây dựng bản trình bày chuỗi được mã hóa của 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 hàm callback. |
withTimeout(seconds) | StateTokenBuilder | Đặt thời lượng (tính bằng giây) mà mã thông báo hợp lệ. |
Trigger
Phương pháp
| 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à trình kích hoạt sẽ kích hoạt. |
getHandlerFunction() | String | Trả về hàm sẽ được gọi khi trình kích hoạt kích hoạt. |
getTriggerSource() | TriggerSource | Trả về nguồn của các sự kiện sẽ kích hoạt trình kích hoạt. |
getTriggerSourceId() | String | Trả về mã nhận dạng dành riêng cho nguồn. |
getUniqueId() | String | Trả về 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 pháp
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
forDocument(document) | DocumentTriggerBuilder | Tạo và trả về DocumentTriggerBuilder liên kết với tài liệu đã cho. |
forDocument(key) | DocumentTriggerBuilder | Tạo và trả về DocumentTriggerBuilder liên kết với tài liệu có mã nhận dạng nhất định. |
forForm(form) | FormTriggerBuilder | Tạo và trả về FormTriggerBuilder liên kết với biểu mẫu đã cho. |
forForm(key) | FormTriggerBuilder | Tạo và trả về FormTriggerBuilder liên kết với biểu mẫu có mã nhận dạng nhất định. |
forSpreadsheet(sheet) | SpreadsheetTriggerBuilder | Tạo và trả về SpreadsheetTriggerBuilder liên kết với bảng tính đã cho. |
forSpreadsheet(key) | SpreadsheetTriggerBuilder | Tạo và trả về SpreadsheetTriggerBuilder liên kết với bảng tính có mã nhận dạng đã cho. |
forUserCalendar(emailId) | CalendarTriggerBuilder | Trả về trình tạo để tạo trình kích hoạt lịch. |
timeBased() | ClockTriggerBuilder | Tạo và trả về ClockTriggerBuilder để tạo các trình 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 khiến trình kích hoạt kích hoạt. |
CLOCK | Enum | Sự kiện theo thời gian khiến trình kích hoạt kích hoạt. |
FORMS | Enum | Google Biểu mẫu khiến trình kích hoạt hoạt động. |
DOCUMENTS | Enum | Google Tài liệu làm cho trình kích hoạt hoạt động. |
CALENDAR | Enum | Lịch Google khiến trình kích hoạt hoạt động. |