Người dùng phải cài đặt và uỷ quyền tiện ích bổ sung trước khi có thể mở và sử dụng thư viện đó. Vì các bước này là phần đầu tiên của trải nghiệm người dùng tiện ích bổ sung, bạn nên hiểu chúng 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, cấp phép và hãy 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ẽ hoạt động trong Google Workspace ứng dụng lưu trữ nó sẽ mở rộng.
Bạn có thể cài đặt các tiện ích bổ sung đã phát hành trên Google Workspace hoặc từ Google Workspace Marketplace. Quản trị viên miền cũng có thể cài đặt các tiện ích bổ sung thay cho người dùng trên Google Workspace Marketplace. Bạn cũng có thể cài đặt tiện ích bổ sung chưa phát hành bạn đang phát triển để có thể thử nghiệm chúng. Trước khi bạn có thể sử dụng "tiện ích bổ sung" mới nhất, bạn phải uỷ quyền nó.
Để biết thêm thông tin, hãy xem Xuất bản tiện ích bổ sung.
Uỷ quyền tiện ích bổ sung
Sau khi cài đặt, tiện ích bổ sung sẽ có trong Google Workspace ứng dụng lưu trữ nó sẽ mở rộng. Lần đầu tiên người dùng cố gắng sử dụng Ứng dụng lưu trữ sẽ hiển thị cho họ một tiện ích bổ sung hộp thoại hoặc thẻ uỷ quyền. Thẻ này giải thích những gì tiện ích bổ sung cần 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 quyền truy cập và cho phép tiện ích bổ sung tiếp tục. Nếu người dùng từ chối tiện ích bổ sung uỷ quyền, họ 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ô hình uỷ quyền khác với Tiện ích bổ sung của Google Workspace. Do Tiện ích bổ sung trình chỉnh sửa hoạt động trên các tệp Google Drive, mô hình uỷ quyền của người chỉnh sửa xác định nhiều chế độ uỷ quyền, dẫn đến việc tiện ích bổ sung được dùng với các tệp riêng lẻ. Khi phát triển Tiện ích bổ sung của trình chỉnh sửa, bạn cần hiểu rõ các chế độ khác nhau và cách tiện ích bổ sung di chuyển giữa chúng.
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ần uỷ quyền mà tiện ích bổ sung này yêu cầu vận hành, để bạn biết phần mềm sẽ cố gắng làm gì. Xem lại nội dung này một cách cẩn thận và nếu bạn vẫn muốn cấp quyền, hãy nhấp vào Cho phép. Thao tác này sẽ bật tiện ích bổ sung để sử dụng.
- Giờ đây, bạn có thể chạy quy trình này trong ứng dụng lưu trữ nó sẽ mở rộng. Nếu ứng dụng đã mở trong một thẻ trình duyệt, bạn có thể cần làm mới thẻ trước khi có thể sử dụng tiện ích bổ sung.
Nếu tiện ích bổ sung bạn đã cài đặt được cập nhật sau đó và đòi hỏi phải bổ sung các quyền bạn chưa cấp, 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
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 đã xuất bản vì họ chưa có tên trong Google Workspace Marketplace. Sau 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 kể từ lần đầu tiên bạn sử dụng tiện ích bổ sung.
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 uỷ quyền là cần thiết, tiện ích bổ sung sẽ cung cấp thẻ uỷ quyền. Bạn luôn bắt buộc phải uỷ quyền trong lần đầu tiên thực thi tiện ích bổ sung và cũng có thể là 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 từng có được uỷ quyền. Nút Uỷ quyền 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 cho 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
Tiện ích bổ sung của Google Workspace có thể kết nối cho một dịch vụ của bên thứ ba mà chính dịch vụ đó yêu cầu phải được uỷ quyền. Tiện ích bổ sung của Google Workspace kết nối với những dịch vụ đó yêu cầu người dùng thực hiện hai thao tác riêng biệt:
- Uỷ quyền tiện ích bổ sung ngay khi cài đặt hoặc trước khi tạo tiện ích bổ sung đầ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 bạn đang cần một tiện ích bổ sung của Google Workspace để truy cập vào một dịch vụ không phải của Google bằng OAuth, 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 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.
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 giúp mở rộng Lịch Google bạn cũng có thể thêm Giải pháp hội nghị truyền hình 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 Sự kiện trên Lịch Google. Nếu tiện ích bổ sung của bạn cung cấp các chế độ hội nghị truyền hình yêu cầu người dùng đăng nhập vào các ứng dụng đó, thì tiện ích bổ sung phải cung cấp cho người dùng khả năng để làm điều đó.
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, phương thức onCreateFunction của giải pháp hội nghị truyền hình
sẽ trả về một
ConferenceData
đối tượng có chứa
ConferenceError
có
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 bằng cách sử dụng tiện ích bổ sung.
Xem bài viết Tạo hội nghị truyền hình của bên thứ ba
để biết thêm chi tiết về việc xử lý yêu cầu 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 chúng. 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 đã xuất bản, ngoại trừ quy trình kể từ lần đầu bạn thử kiểm thử tiện ích bổ sung. Nếu sau đó bạn kiểm tra lại cùng một 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, có thể hữu ích nếu bạn ngừng cho phép chúng để bạn có thể kiểm tra 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ẽ được trình bày 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