Tiện ích bổ sung của Google Workspace có thể giúp 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 thêm thông tin có liên quan cho người dùng, tự động hoá công việc và kết nối hệ thống của bên thứ ba với Lịch Google.
Khi xây dựng giao diện tiện ích bổ sung cho Lịch Google, bạn có thể cung cấp trang chủ. Bạn có thể sử dụng cùng một cho nhiều máy chủ lưu trữ hoặc thiết kế một máy chủ cụ thể cho Lịch Google.
Tiện ích bổ sung của bạn cũng có thể xác định giao diện xuất hiện khi người dùng một sự kiện trên Lịch đang mở.
Truy cập vào giao diện người dùng tiện ích bổ sung
Tuỳ thuộc vào cách mở ứng dụng, Tiện ích bổ sung của Google Workspace có thể xác định giao diện trang chủ, giao diện sự kiện trên Lịch Google, giao diện lựa 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 khi đang ở chế độ xem lịch, thì tiện ích bổ sung đó sẽ thực thi
calendar.homepageTriggertương ứng (nếu có). Hàm này tạo và trả về một thẻ trang chủ vào Lịch để hiển thị. Nếu khôngcalendar.homepageTriggerđược xác định thì thẻ trang chủ chung sẽ được hiển thị thay thế. - 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 mở khi người dùng mở một sự kiện, tiện ích bổ sung
thực thi lệnh tương ứng
eventOpenTrigger(nếu có). Hàm này tạo sự kiện trên Lịch của tiện ích bổ sung và quay lại Lịch Google để hiển thị. - Nếu tiện ích bổ sung xác định một hàm
eventAttachmentTrigger, tiện ích bổ sung sẽ xuất hiện dưới dạng 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 bạn chọn tiện ích bổ sung, hàmeventAttachmentTriggertạo tệp đính kèm của tiện ích bổ sung giao diện chọn và trả về Lịch Google để hiển thị.
Xây dựng giao diện Lịch tiện ích bổ sung
Bạn có thể mở rộng Lịch Google bằng Tiện ích bổ sung của 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ó chế độ cài đặt dành riêng cho Lịch Google hay không trang chủ. 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 chỉnh sửa Sự kiện trên lịch.
- Thêm thông tin thích hợp
addOns.commonvàaddOns.calendarvào tệp kê khai của dự án tập lệnh tiện ích bổ sung, bao gồm mọi phạm vi cần thiết. - Nếu bạn đang cung cấp một phiên bản Lịch
homepage,
triển khai
calendar.homepageTriggerđể tạo giao diện này. Bạn cũng có thể chọn sử dụngcommon.homepageTriggercho nhiều máy chủ Google Workspace. - Nếu đang cung cấp giao diện Sự kiện trên Lịch, bạn phải triển khai
calendar.eventOpenTriggerđể tạo giao diện này. Xem 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 callback được liên kết để phản hồi các lệnh gọi lại của người dùng Lượt tương tác trên giao diện người dùng, chẳng hạn như lượt nhấp vào nút.
Trang chủ lịch
Lịch Google hỗ trợ hiển thị trang chủ của Tiện ích bổ sung của Google Workspace.
Để hiển thị trang chủ chung của tiện ích bổ sung trong Lịch Google, chỉ cần đảm bảo ở đó
là 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 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 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 tự động được gọi để tạo
trang chủ của Lịch Google khi cần. Bạn phải triển khai hàm này để tạo
và trả về một giá trị duy nhất
Card hoặc một mảng
Card
tạo nên trang chủ. Hàm kích hoạt trang chủ được truyền
đối tượng sự kiện
dưới dạng tham số chứa một số thông tin chung như thông tin
chủ. Bạn có thể 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 Google dựa vào trình kích hoạt theo ngữ cảnh để xác định giao diện nào
(nếu có) để hiển thị khi người dùng chỉnh sửa một sự kiện trên Lịch. Khi trình kích hoạt
kích hoạt, nó sẽ thực thi hàm kích hoạt theo ngữ cảnh được chỉ định bởi hàm
calendar.eventOpenTrigger
trong tệp kê khai của tiện ích bổ sung.
Bạn phải triển khai hàm có tên trong
calendar.eventOpenTrigger
. Hàm này chấp nhận đối tượng sự kiện làm đối tượng
và phải trả về một đối số duy nhất
Card hoặc một mảng
Card đối tượng dành cho Lịch Google
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à
được chuyển đến
calendar.eventOpenTrigger
hàm kích hoạt theo ngữ cảnh khi người dùng mở
một sự kiện trên Lịch. Hàm kích hoạt có thể sử dụng thông tin trong sự kiện này
đối tượng để xác định cách tạo thẻ bổ sung hoặc điều khiển tiện ích bổ sung đó
hành vi. Các đối tượng sự kiện cũng được tạo và chuyển đến
homepageTrigger
hoạt động khi một tiện ích bổ sung được mở lần đầu tiên cũng như khi người dùng nhấp hoặc chọn
tiện ích tương tác.
Toàn bộ cấu trúc của đối tượng sự kiện được mô tả trong Đối tượng sự kiện. Khi Lịch là ứng dụng lưu trữ hoạt động của tiện ích bổ sung, trình kích hoạt theo ngữ cảnh và các đối tượng sự kiện tương tác tiện ích bao gồm Đối tượng sự kiện trên lịch chứa thông tin ứng dụng khách dành riêng cho Lịch.
Đang cập nhật sự kiện trên Lịch
Ngoài bối cảnh
calendar.eventOpenTrigger
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
calendar.eventUpdateTrigger
kích hoạt khi người dùng cập nhật và lưu sự kiện trên Lịch. Chỉ điều kiện kích hoạt này
kích hoạt 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 được chỉ định bởi
calendar.eventUpdateTrigger
trường tệp kê khai. Hàm này được thực thi trước khi chỉnh sửa sự kiện trên Lịch là
đã 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 của bên thứ ba, chẳng hạn như hội nghị truyền hình được kết nối với Lịch Google.
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ư
làm danh sách người tham dự), bạn phải đặt tiện ích bổ sung
calendar.currentEventAccess
trường tệp kê khai sang WRITE hoặc READ_WRITE. Việc này cũng
tiện ích bổ sung phải có
https://www.googleapis.com/auth/calendar.addons.current.event.write
phạm vi.
Thêm các giải pháp hội nghị truyền hình
Giải pháp hội nghị trình bày các lựa chọn hội nghị của bên thứ ba mà người dùng có thể đính kèm Sự kiện trên Lịch Google. Chiến lược phát hành đĩa đơn Tổng quan về hội nghị truyền hình của bên thứ ba tài liệu cung cấp thông tin chi tiết về cách tạo một tiện ích bổ sung giúp thêm hội nghị truyền hình. Bạn không cần xây dựng giao diện người dùng cho loại tiện ích mở rộng; các giải pháp đã thêm chỉ xuất hiện dưới dạng các lựa chọn trong trình đơn thả xuống của giao diện người dùng cho sự kiện trên Lịch Google.