Người dùng phải cài đặt và uỷ quyền một tiện ích bổ sung thì mới có thể mở và sử dụng tiện ích đó. Vì các bước này là phần đầu tiên trong trải nghiệm sử dụng tiện ích bổ sung dành cho người dùng, bạn nên hiểu rõ các bước này trước khi bắt đầu tạo tiện ích bổ sung của riêng mình.
Phần tài liệu này mô tả cách người dùng có thể cài đặt, uỷ quyền và bắt đầu sử dụng tiện ích bổ sung.
Cài đặt tiện ích bổ sung
Trước khi có thể sử dụng tiện ích bổ sung, bạn phải cài đặt tiện ích đó. Sau khi được cài đặt, tiện ích bổ sung này sẽ có trong ứng dụng lưu trữ Google Workspace mà tiện ích này mở rộng.
Bạn có thể cài đặt các tiện ích bổ sung đã phát hành từ ứng dụng lưu trữ Google Workspace hoặc từ Google Workspace Marketplace. Quản trị viên miền cũng có thể thay mặt người dùng cài đặt các tiện ích bổ sung trên Google Workspace Marketplace. Bạn cũng có thể cài đặt các tiện ích bổ sung chưa phát hành mà bạn đang phát triển để có thể kiểm thử. Trước khi có thể sử dụng tiện ích bổ sung đã cài đặt lần đầu tiên, bạn phải uỷ quyền tiện ích đó.
Để biết thêm thông tin chi tiết, hãy xem bài viết Phát hành tiện ích bổ sung.
Uỷ quyền tiện ích bổ sung
Sau khi cài đặt một tiện ích bổ sung, tiện ích bổ sung đó sẽ có trong ứng dụng lưu trữ của Google Workspace mà tiện ích đó mở rộng. Lần đầu tiên người dùng cố gắng sử dụng tiện ích bổ sung, ứng dụng lưu trữ sẽ hiển thị cho họ một thẻ hoặc hộp thoại uỷ quyền. Thẻ này giải thích những việc tiện ích bổ sung cần có quyền để làm cho người dùng, chẳng hạn như truy cập vào nội dung của Google Trang tính hiện tại. Sau đó, người dùng có thể cấp các quyền đó và cho phép tiện ích bổ sung tiếp tục. Nếu người dùng từ chối cấp quyền truy cập vào tiện ích bổ sung, thì họ sẽ không thể sử dụng tiện ích bổ sung.
Tiện ích bổ sung của Trình chỉnh sửa sử dụng một mô hình uỷ quyền khác với Tiện ích bổ sung của Google Workspace. Vì Tiện ích bổ sung của Trình chỉnh sửa hoạt động trên các tệp Google Drive, nên mô hình uỷ quyền của trình chỉnh sửa sẽ xác định nhiều chế độ uỷ quyền khi tiện ích bổ sung được dùng với từng tệp riêng lẻ. Khi phát triển Tiện ích bổ sung Trình chỉnh sửa, bạn cần nắm được các chế độ khác nhau và cách một tiện ích bổ sung di chuyển giữa các chế độ đó.
Cho phép tiện ích bổ sung đã phát hành
Sau khi bạn cài đặt một tiện ích bổ sung đã phát hành, quy trình uỷ quyền sẽ bắt đầu ngay lập tức:
- Bạn được nhắc Chọn tài khoản để cài đặt tiện ích bổ sung.
- Sau đó, bạn sẽ thấy danh sách các lệnh uỷ quyền mà tiện ích bổ sung yêu cầu phải hoạt động, để bạn biết những thao tác mà tiện ích bổ sung này sẽ thực hiện. Hãy xem kỹ danh sách này và nếu bạn vẫn muốn cấp quyền, hãy nhấp vào Allow (Cho phép). Thao tác này sẽ bật tiện ích bổ sung để sử dụng.
- Bây giờ, bạn có thể chạy hàm này từ ứng dụng lưu trữ mà chương trình mở rộng. Nếu ứng dụng đã mở trong một thẻ trình duyệt, thì có thể bạn cần làm mới thẻ trước khi có tiện ích bổ sung.
Nếu tiện ích bổ sung bạn đã cài đặt được cập nhật sau đó và yêu cầu uỷ quyền thêm mà bạn chưa cấp, thì bạn sẽ được nhắc cung cấp các quyền đó vào lần tiếp theo bạn sử dụng tiện ích bổ sung.
Cho phép tiện ích bổ sung chưa phát hành của Google Workspace
Các tiện ích bổ sung chưa xuất bản không có quy trình uỷ quyền giống như các tiện ích bổ sung đã phát hành vì chưa có tên trong Google Workspace Marketplace. Sau khi cài đặt một tiện ích bổ sung chưa phát hành, bạn sẽ không được yêu cầu cấp quyền ngay lập tức. Thay vào đó, quy trình uỷ quyền sẽ bắt đầu khi bạn cố gắng sử dụng tiện ích bổ sung lần đầu tiên.
Khi chạy, tiện ích bổ sung sẽ xác định xem có cần người dùng cho phép hay không. Nếu cần phải uỷ quyền, tiện ích bổ sung sẽ trình bày một thẻ uỷ quyền. Bạn luôn phải uỷ quyền trong lần đầu tiên một tiện ích bổ sung thực thi và cũng có thể cần thiết nếu phiên bản mới của tiện ích bổ sung sử dụng một dịch vụ chưa được uỷ quyền trước đó. Nút Cấp phép truy cập cung cấp một cửa sổ hộp thoại để người dùng cho phép hoặc Từ chối cấp quyền đối với tiện ích bổ sung.
Cho phép các dịch vụ không phải của Google sử dụng tiện ích bổ sung của Google Workspace
Một tiện ích bổ sung của Google Workspace có thể kết nối với một dịch vụ của bên thứ ba mà chính dịch vụ đó cần được cho phép. Tiện ích bổ sung của Google Workspace kết nối với những dịch vụ đó cần người dùng thực hiện 2 thao tác riêng biệt:
- Ủy quyền chính tiện ích bổ sung khi tiện ích bổ sung được cài đặt hoặc khởi động lần đầu.
- Ủy quyền dịch vụ không phải của Google khi dịch vụ này được truy cập lần đầu tiên.
Nếu một Tiện ích bổ sung của Google Workspace mà bạn đang phát triển cần dùng OAuth để truy cập vào một dịch vụ không phải của Google, thì bạn phải định cấu hình kết nối cho dịch vụ đó khi tạo tiện ích bổ sung.
Để biết thêm thông tin, hãy tham khảo bài viết Kết nối tiện ích bổ sung của Google Workspace với một dịch vụ bên thứ ba.
Hệ thống hội nghị truyền hình của bên thứ ba
Tiện ích bổ sung của Google Workspace mở rộng Lịch Google cũng có thể thêm Giải pháp hội nghị truyền hình bổ sung cho phép người dùng chọn một hệ thống hội nghị truyền hình của bên thứ ba khi chỉnh sửa các sự kiện trên Lịch Google. Nếu tiện ích bổ sung của bạn cung cấp các tuỳ chọn hội nghị truyền hình yêu cầu người dùng đăng nhập, thì tiện ích bổ sung của bạn phải cho phép người dùng làm như vậy.
Nếu người dùng cố gắng tạo một hội nghị bằng tiện ích bổ sung của bạn mà không cần đăng nhập, thì phương thức onCreateFunction của giải pháp hội nghị truyền hình sẽ trả về đối tượng ConferenceData chứa ConferenceError kèm theo URL xác thực.
Sau khi nhận được đối tượng này, Lịch Google sẽ tạo một nút ĐĂNG NHẬP trong giao diện người dùng chỉnh sửa sự kiện liên kết đến URL xác thực mà tiện ích bổ sung cung cấp. Sau đó, người dùng có thể sử dụng nút này để đăng nhập vào hệ thống của bên thứ ba trước khi sử dụng thêm tiện ích bổ sung.
Xem bài viết Tạo hội nghị của bên thứ ba để biết thêm thông tin chi tiết về cách xử lý việc uỷ quyền bằng ConferenceError.
Cho phép tiện ích bổ sung trình chỉnh sửa chưa được xuất bản
Đó là phương pháp hay nhất để kiểm thử Tiện ích bổ sung của Trình chỉnh sửa khi bạn phát triển các Tiện ích đó. Quy trình uỷ quyền giống với quy trình cho Tiện ích bổ sung trình chỉnh sửa đã phát hành, ngoại trừ quy trình sẽ bắt đầu khi bạn cố gắng kiểm thử tiện ích bổ sung lần đầu tiên. Nếu sau đó kiểm tra lại cùng một tiện ích bổ sung, thì bạn sẽ không được nhắc uỷ quyền lại.
Huỷ uỷ quyền tiện ích bổ sung
Khi phát triển tiện ích bổ sung, bạn nên huỷ uỷ quyền những tiện ích đó để có thể kiểm thử lại quy trình uỷ quyền.
Bạn có thể hủy cấp quyền tiện ích bổ sung bằng cách thực hiện như sau:
- Mở bảng điều khiển bảo mật tài khoản của bạn.
- Tìm và nhấp vào tiện ích bổ sung mà bạn muốn huỷ cấp quyền.
- Nhấp vào Xoá quyền truy cập.
Khi bạn chạy lại tiện ích bổ sung sau khi huỷ cấp quyền, quy trình uỷ quyền sẽ hiển thị lại.
Chủ đề có liên quan
- Mở và sử dụng tiện ích bổ sung đã cài đặt
- Kết nối tiện ích bổ sung của Google Workspace với một dịch vụ của bên thứ ba