Các tiện ích bổ sung của Google Workspace có thể cung cấp giao diện tuỳ chỉnh khi người dùng đang xem hoặc chỉnh sửa lịch và sự kiện trên Lịch. Nhờ đó, bạn có thể cung cấp cho người dùng thông tin bổ sung có liên quan, tự động hoá các việc cần làm và kết nối các hệ thống của bên thứ ba với Lịch.
Khi tạo giao diện tiện ích bổ sung Google Workspace cho Lịch, bạn có thể cung cấp một trang chủ. Bạn có thể dùng cùng một trang chủ cho nhiều máy chủ lưu trữ hoặc thiết kế một trang chủ cụ thể cho Lịch.
Tiện ích bổ sung của bạn cũng có thể xác định một giao diện xuất hiện khi người dùng mở một sự kiện trên Lịch.
Truy cập vào giao diện người dùng của tiện ích bổ sung
Giao diện người dùng của bạn có thể xuất hiện theo nhiều cách, tuỳ thuộc vào ngữ cảnh. Ví dụ: một tiện ích bổ sung có thể xác định giao diện trang chủ, giao diện sự kiện trên Lịch, giao diện chọn tệp đính kèm hoặc cả ba:
- Nếu người dùng nhấp vào biểu tượng tiện ích bổ sung trong chế độ xem lịch, thì tiện ích bổ sung sẽ thực thi hàm
calendar.homepageTriggertương ứng (nếu có). Hàm này tạo và trả về một thẻ trên trang chủ cho Lịch để hiển thị. Nếu không có hàmcalendar.homepageTriggernào được xác định, thì một thẻ trang chủ chung sẽ xuất hiện. - Nếu người dùng mở một sự kiện trên Lịch rồi nhấp vào biểu tượng tiện ích bổ sung hoặc tiện ích bổ sung đang mở khi người dùng mở một sự kiện, thì tiện ích bổ sung sẽ thực thi hàm
eventOpenTriggertương ứng (nếu có). Hàm này tạo giao diện sự kiện trên Lịch của tiện ích bổ sung và trả về Lịch để hiển thị. - Nếu tiện ích bổ sung xác định một hàm
eventAttachmentTrigger, thì tiện ích bổ sung sẽ xuất hiện dưới dạng một trình cung cấp tệp đính kèm khi người dùng nhấp vào Thêm tệp đính kèm trong khi chỉnh sửa một sự kiện trên Lịch. Khi tiện ích bổ sung được chọn, hàmeventAttachmentTriggersẽ tạo giao diện chọn tệp đính kèm của tiện ích bổ sung và trả về giao diện đó cho Lịch để hiển thị.
Tạo giao diện Lịch của tiện ích bổ sung
Hãy làm theo các bước sau để tạo giao diện người dùng. Bạn có thể mở rộng Lịch bằng một tiện ích bổ sung Google Workspace bằng cách làm theo các bước sau:
- Quyết định xem bạn có muốn tiện ích bổ sung của mình có một trang chủ dành riêng cho Lịch hay không. Ngoài ra, hãy quyết định xem bạn có muốn cung cấp giao diện tuỳ chỉnh trong khi người dùng đang chỉnh sửa sự kiện trên Lịch hay không.
- Thêm
addOns.commonvàaddOns.calendarthích hợp vào tệp kê khai dự án tập lệnh Tiện ích bổ sung, bao gồm cả mọi phạm vi bắt buộc. - Nếu bạn đang cung cấp một trang chủ dành riêng cho Lịch, hãy triển khai hàm
calendar.homepageTriggerđể tạo giao diện này. Bạn cũng có thể chọn sử dụng giao diệncommon.homepageTriggercho nhiều ứng dụng lưu trữ. - Nếu bạn đang cung cấp một giao diện sự kiện trên Lịch, hãy triển khai hàm
calendar.eventOpenTriggerđể tạo giao diện này. Hãy xem phần Mở rộng giao diện sự kiện trên Lịch để biết thông tin chi tiết. - Triển khai các hàm gọi lại được liên kết cần thiết để phản hồi các hoạt động tương tác của người dùng với giao diện người dùng, chẳng hạn như lượt nhấp vào nút.
Trang chủ của Lịch
tiện ích bổ sung hỗ trợ hiển thị trang chủ của tiện ích bổ sung Google Workspace. Để hiển thị trang chủ chung của tiện ích bổ sung trong Lịch, hãy đảm bảo rằng có trường addOns.calendar trong tệp kê khai của tiện ích bổ sung.
Ngoài ra, hãy thêm calendar.homepageTrigger vào tệp kê khai tiện ích bổ sung để cung cấp một trang chủ dành riêng cho Lịch.
Trong cả hai trường hợp, bạn phải cung cấp tên của một hàm kích hoạt trang chủ trong dự án tập lệnh của tiện ích bổ sung. Hàm này được gọi tự động để tạo trang chủ Lịch khi cần. Triển khai hàm này để tạo và trả về một Card duy nhất hoặc một mảng các đối tượng Card tạo nên trang chủ. Hàm kích hoạt trang chủ được truyền một đối tượng sự kiện làm tham số chứa một số thông tin chung, chẳng hạn như nền tảng của ứng dụng. Sử dụng dữ liệu đối tượng sự kiện để điều chỉnh cấu trúc của trang chủ.
Mở rộng giao diện sự kiện trên Lịch
Lịch dựa vào một điều kiện kích hoạt theo bối cảnh để xác định giao diện (nếu có) cần hiển thị khi người dùng chỉnh sửa một sự kiện trên Lịch. Khi điều kiện kích hoạt hoạt động, điều kiện này sẽ thực thi hàm điều kiện kích hoạt theo bối cảnh do trường calendar.eventOpenTrigger chỉ định trong tệp kê khai tiện ích bổ sung.
Triển khai hàm có tên trong trường calendar.eventOpenTrigger. Hàm này chấp nhận một đối tượng sự kiện làm đối số và phải trả về một đối tượng Card duy nhất hoặc một mảng các đối tượng Card để Lịch hiển thị trong khi người dùng mở sự kiện.
Đối tượng sự kiện
Một đối tượng sự kiện được tạo và truyền đến hàm kích hoạt theo bối cảnh calendar.eventOpenTrigger khi người dùng mở một sự kiện trên Lịch.
Hàm kích hoạt có thể dùng thông tin trong đối tượng sự kiện này để xác định cách tạo thẻ bổ sung hoặc kiểm soát hành vi của tiện ích bổ sung. Các đối tượng sự kiện cũng được tạo và truyền đến các hàm homepageTrigger khi tiện ích bổ sung được mở lần đầu tiên và khi người dùng nhấp hoặc chọn các tiện ích tương tác.
Cấu trúc đầy đủ của các đối tượng sự kiện được mô tả trong phần Đối tượng sự kiện. Khi Lịch là ứng dụng lưu trữ đang hoạt động của tiện ích bổ sung, các đối tượng sự kiện tương tác với tiện ích và trình kích hoạt theo bối cảnh sẽ bao gồm trường Đối tượng sự kiện trên Lịch mang thông tin cụ thể về ứng dụng Lịch.
Cập nhật sự kiện trên Lịch
Ngoài calendar.eventOpenTrigger theo bối cảnh kích hoạt khi người dùng mở một sự kiện trên Lịch để chỉnh sửa, bạn cũng có thể xác định một calendar.eventUpdateTrigger kích hoạt khi người dùng cập nhật và lưu một sự kiện trên Lịch.
Điều kiện kích hoạt này chỉ hoạt động nếu người dùng thực hiện một hoặc nhiều thao tác chỉnh sửa sau đây:
- Thêm một hoặc nhiều người tham dự.
- Xoá một hoặc nhiều người tham dự.
- Thêm hoặc chuyển sang một giải pháp hội nghị truyền hình khác.
Khi trình kích hoạt này kích hoạt, nó sẽ thực thi hàm kích hoạt do trường calendar.eventUpdateTrigger trong tệp kê khai chỉ định. Hàm này được thực thi trước khi nội dung chỉnh sửa sự kiện trên Lịch được lưu.
calendar.eventUpdateTrigger thường được dùng để thực hiện một hoặc nhiều thao tác sau:
- Cập nhật giao diện sự kiện trên Lịch của tiện ích bổ sung để phản hồi các thay đổi của người dùng đối với sự kiện trên Lịch.
- Đồng bộ hoá dữ liệu sự kiện trên Lịch với một hệ thống bên thứ ba, chẳng hạn như một hệ thống hội nghị được kết nối với Lịch.
Nếu bạn cần tiện ích bổ sung điều chỉnh dữ liệu của một sự kiện trên Lịch (chẳng hạn như danh sách người tham dự), hãy đặt trường tệp kê khai calendar.currentEventAccess của tiện ích bổ sung thành WRITE hoặc READ_WRITE. Điều này cũng yêu cầu tiện ích bổ sung phải có phạm vi https://www.googleapis.com/auth/calendar.addons.current.event.write.
Thêm giải pháp hội nghị truyền hình
Nếu duy trì một hệ thống hội nghị truyền hình của bên thứ ba, bạn có thể tích hợp hệ thống đó với Lịch bằng cách thêm giải pháp hội nghị truyền hình. Trước đây, tính năng này ở giai đoạn thử nghiệm beta dưới dạng Tiện ích bổ sung hội nghị truyền hình trên Lịch.
Giải pháp hội nghị truyền hình là các lựa chọn hội nghị truyền hình của bên thứ ba mà người dùng có thể đính kèm vào sự kiện trên Lịch. Tài liệu Tổng quan về hội nghị truyền hình của bên thứ ba cung cấp thông tin chi tiết về cách tạo một tiện ích bổ sung để thêm các giải pháp hội nghị truyền hình mới. Bạn không cần phải tạo giao diện người dùng cho loại tiện ích này; các giải pháp đã thêm sẽ xuất hiện dưới dạng lựa chọn trong trình đơn thả xuống của giao diện người dùng sự kiện trên Lịch.