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, uỷ quyền 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ài đặt, tiện ích bổ sung sẽ có trong ứng dụng lưu trữ Google Workspace mà tiện ích bổ sung đó mở rộng.
Bạn có thể cài đặt các tiện ích bổ sung đã xuất bản 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 tiện ích bổ sung 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 phần Xuất bản tiện ích bổ sung.
Uỷ quyền cho 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 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 mà tiện ích bổ sung cần có quyền thực hiện 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 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. 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 xác định nhiều chế độ uỷ quyền xuất hiện khi các tiện ích bổ sung được sử dụng với từng tệp. Khi phát triển Tiện ích bổ sung cho trình chỉnh sửa, điều quan trọng là bạn phải hiểu rõ các chế độ khác nhau và cách một tiện ích bổ sung di chuyển giữa các chế độ đó.
Uỷ quyền cho tiện ích bổ sung đã xuất bản
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 quyền mà tiện ích bổ sung cần có để hoạt động, nhờ đó bạn biết được tiện ích bổ sung đó muốn làm gì. Hãy xem xét 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 Cho phép. Thao tác này sẽ cho phép sử dụng tiện ích bổ sung.
- Bây giờ, 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 mà bạn đã cài đặt được cập nhật sau đó và yêu cầu thêm quyền mà bạn chưa cấp, thì bạn sẽ được nhắc cấp những quyền đó vào lần tiếp theo bạn sử dụng tiện ích bổ sung.
Uỷ quyền cho các 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 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 uỷ 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 phải được uỷ quyền trong lần đầu tiên một tiện ích bổ sung thực thi và cũng có thể phải được uỷ quyền 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 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 uỷ 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 với một dịch vụ 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 tự động tiện ích bổ sung 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 tiện ích bổ sung Google Workspace mà bạn đang phát triển cần truy cập vào một dịch vụ không phải của Google bằng OAuth, 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 dịch vụ của bên thứ ba.
Hệ thống hội nghị của bên thứ ba
Tiện ích bổ sung của Google Workspace giúp mở rộng Lịch Google 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 lựa chọn hội nghị 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 thực hiện việc này.
Nếu người dùng cố gắng tạo một cuộc họp 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ị sẽ trả về một đối tượng ConferenceData chứa ConferenceError có URL xác thực.
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. Nút này sẽ 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.
Uỷ quyền cho Tiện ích bổ sung chưa phát hành dành cho Trình chỉnh sửa
Bạn nên kiểm thử Tiện ích bổ sung cho Trình chỉnh sửa trong khi phát triển các tiện ích đó. Quy trình uỷ quyền giống với quy trình uỷ quyền cho Tiện ích bổ sung cho Trình chỉnh sửa đã xuất bản, ngoại trừ việc quy trình này bắt đầu khi bạn thử kiểm thử tiện ích bổ sung lần đầu tiên. Sau này, nếu kiểm thử lại cùng một tiện ích bổ sung, 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 cho các tiện ích bổ sung đó để có thể kiểm thử lại quy trình uỷ quyền.
Bạn có thể huỷ uỷ quyền cho một tiện ích bổ sung bằng cách làm như sau:
- Mở bảng điều khiển bảo mật tài khoả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.
Gỡ cài đặt tiện ích bổ sung
Để gỡ cài đặt một tiện ích bổ sung mà bạn đã cài đặt từ Google Workspace Marketplace, hãy tham khảo bài viết Gỡ cài đặt ứng dụng hoặc tiện ích bổ sung trên Marketplace.
Cách gỡ cài đặt tiện ích bổ sung chưa phát hành, được tích hợp sẵn Apps Script, tham khảo phần Gỡ cài đặt ứng dụng chưa xuất bản .
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ụ bên thứ ba