Dịch vụ này cung cấp quyền truy cập vào các 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 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 được dùng để xác định xem người dùng có cần cho phép tập lệnh này sử dụng một hoặc nhiều dịch vụ hay không, cũng như để cung cấp URL cho hộp thoại uỷ quyền. |
AuthorizationStatus | Nội dung liệt kê cho biết trạng thái uỷ quyền của một tập lệnh. |
CalendarTriggerBuilder | Trình tạo các điều kiện kích hoạt lịch. |
ClockTriggerBuilder | Trình tạo kích hoạt đồng hồ. |
DocumentTriggerBuilder | Trình tạo kích hoạt tài liệu. |
EventType | Một bảng liệt kê cho biết loại sự kiện được kích hoạt. |
FormTriggerBuilder | Trình tạo 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 việc xuất bản tập lệnh và các trình kích hoạt. |
Service | Truy cập và thao túng xuất bản tập lệnh. |
SpreadsheetTriggerBuilder | Trình tạo 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ể sử dụng trong API gọi lại (như luồng OAuth). |
Trigger | Trình kích hoạt tập lệnh. |
TriggerBuilder | Trình tạo chung cho các kích hoạt tập lệnh. |
TriggerSource | Bảng liệt kê cho biết nguồn của sự kiện khiến trình kích hoạt kích hoạt. |
AuthMode
Thuộc tính
Tài sản | Loại | Nội dung 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 bạn cho phép. |
CUSTOM_FUNCTION | Enum | Chế độ cho phép truy cập vào một nhóm nhỏ các dịch vụ để sử dụng trong các hàm bảng tính tuỳ chỉnh. |
LIMITED | Enum | Chế độ cho phép truy cập vào một số ít dịch vụ. |
FULL | Enum | Chế độ cho phép truy cập vào tất cả dịch vụ yêu cầu bạn cho phép. |
AuthorizationInfo
Phương thức
Phương thức | Kiểu 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 cho phép 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. |
AuthorizationStatus
Thuộc tính
Tài sản | Loại | Nội dung mô tả |
---|---|---|
REQUIRED | Enum | Người dùng cần cho phép 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 toàn bộ quyền mà tập lệnh đó yêu cầu. |
CalendarTriggerBuilder
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
create() | Trigger | Tạo và trả về điều kiện kích hoạt. |
onEventUpdated() | CalendarTriggerBuilder | Chỉ định điều kiện kích hoạt sẽ kích hoạt khi tạo, cập nhật hoặc xoá một mục trong lịch. |
ClockTriggerBuilder
Phương thức
Phương thức | Kiểu 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 điều kiện kích hoạt sẽ kích hoạt vào một ngày nhất định, theo mặc định là gần nửa đêm (+/- 15 phút). |
atHour(hour) | ClockTriggerBuilder | Chỉ định giờ mà trình kích hoạt này 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 n giờ một lần. |
everyMinutes(n) | ClockTriggerBuilder | Chỉ định chạy điều kiện kích hoạt n phút một lần. |
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 trình kích hoạt chạy. |
nearMinute(minute) | ClockTriggerBuilder | Chỉ định số 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 thức
Phương thức | Kiểu 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 trình kích hoạt sẽ kích hoạt khi tài liệu được mở. |
EventType
Thuộc tính
Tài sản | Loại | Nội dung mô tả |
---|---|---|
CLOCK | Enum | Trình kích hoạt kích hoạt sau khi sự kiện dựa trên 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 ô, giá trị này đượ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 này sẽ kích hoạt sau khi người dùng phản hồi một biểu mẫu trên Google Biểu mẫu. |
ON_CHANGE | Enum | Trình kích hoạt này 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 chứ không phải là một chỉnh sửa). |
ON_EVENT_UPDATED | Enum | Điều kiện kích hoạt này sẽ kích hoạt sau khi một sự kiện được tạo, cập nhật hoặc bị xoá trên Lịch Google đã chỉ định. |
FormTriggerBuilder
Phương thức
Phương thức | Kiểu 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 trình kích hoạt sẽ kích hoạt khi phản hồi được gửi tới biểu mẫu. |
onOpen() | FormTriggerBuilder | Chỉ định 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ở ra. |
InstallationSource
Thuộc tính
Tài sản | Loại | Nội dung 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 hiện không chạy dưới dạng tiện ích bổ sung. |
WEB_STORE_ADD_ON | Enum | Người dùng đã cài đặt tiện ích bổ sung từ Cửa hàng Chrome trực tuyến. |
ScriptApp
Thuộc tính
Tài sản | Loại | Nội dung mô tả |
---|---|---|
AuthMode | AuthMode | Một bảng liệt kê 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 | Nội dung liệt kê cho biết trạng thái uỷ quyền của một tập lệnh. |
EventType | EventType | Một bảng liệt kê cho biết loại sự kiện được kích hoạt. |
InstallationSource | InstallationSource | Bảng liệt kê cho biết cách tập lệnh được cài đặt cho người dùng dưới dạng tiện ích bổ sung. |
TriggerSource | TriggerSource | Bảng liệt kê cho biết 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ê các ngày trong tuần. |
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
deleteTrigger(trigger) | void | Xoá điều kiện kích hoạt nhất định để nó 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 cho phép 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ề một 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ó 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 hiệu quả. |
getProjectTriggers() | Trigger[] | Lấy tất cả các điều kiện kích hoạt có thể cài đặt được liên kết với dự án 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 một ứng dụng web. |
getUserTriggers(document) | Trigger[] | Lấy tất cả các điều kiện 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 này hoặc tiện ích bổ sung này. |
getUserTriggers(form) | Trigger[] | Lấy tất cả các điều kiện kích hoạt có thể cài đặt do người dùng này sở hữu ở dạng nhất định, chỉ dành cho tập lệnh này hoặc tiện ích bổ sung. |
getUserTriggers(spreadsheet) | Trigger[] | Lấy tất cả các điều kiện kích hoạt có thể cài đặt do người dùng này sở hữu trong bảng tính nhất định, chỉ dành cho tập lệnh này hoặc tiện ích bổ sung này. |
invalidateAuth() | void | Vô hiệu hoá lệnh uỷ quyền mà người dùng có hiệu lực 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ể dùng trong API gọi lại (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 sẽ gọi một hàm nhất định. |
Service
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
getUrl() | String | Trả về URL của ứng dụng web nếu đã được triển khai; nếu không thì trả về null . |
isEnabled() | Boolean | Trả về true nếu tập lệnh có thể truy cập được dưới dạng ứng dụng web. |
SpreadsheetTriggerBuilder
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
create() | Trigger | Tạo và trả về điều kiện kích hoạt. |
onChange() | SpreadsheetTriggerBuilder | Chỉ định 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 thay đổi. |
onEdit() | SpreadsheetTriggerBuilder | Chỉ định một trình kích hoạt sẽ kích hoạt khi bảng tính được chỉnh sửa. |
onFormSubmit() | SpreadsheetTriggerBuilder | Chỉ định trình kích hoạt sẽ kích hoạt khi bảng tính đã gửi một biểu mẫu tới bảng tính. |
onOpen() | SpreadsheetTriggerBuilder | Chỉ định trình 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 | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
createToken() | String | Tạo một chuỗi đại diện đã mã hoá 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 một hàm callback. |
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 | Kiểu 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 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 sự kiện sẽ khiến trình kích hoạt kích hoạt. |
getTriggerSourceId() | String | Trả về mã nhận dạng riêng của 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 trình kích hoạt với nhau. |
TriggerBuilder
Phương thức
Phương thức | Kiểu 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 gắn với biểu mẫu cho trước. |
forForm(key) | FormTriggerBuilder | Tạo và trả về một FormTriggerBuilder gắn 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 bằng mã nhận dạng nhất định. |
forUserCalendar(emailId) | CalendarTriggerBuilder | Trả về trình tạo để tạo điều kiện kích hoạt lịch. |
timeBased() | ClockTriggerBuilder | Tạo và trả về một ClockTriggerBuilder để tạo các điều kiện kích hoạt dựa trên thời gian. |
TriggerSource
Thuộc tính
Tài sản | Loại | Nội dung mô tả |
---|---|---|
SPREADSHEETS | Enum | Google Trang tính khiến trình kích hoạt kích hoạt. |
CLOCK | Enum | Một sự kiện diễn ra 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 kích hoạt. |
DOCUMENTS | Enum | Google Tài liệu khiến trình kích hoạt kích hoạt. |
CALENDAR | Enum | Lịch Google làm cho trình kích hoạt kích hoạt. |