Người dùng phải cài đặt và cho phép tiện ích bổ sung thì mới có thể mở và sử dụng tiện ích đó. Vì đây là phần đầu tiên của trải nghiệm người dùng đối với tiện ích bổ sung, nên 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
Để có thể sử dụng một 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 các tiện ích bổ sung chưa xuất bản mà bạn đang phát triển để có thể kiểm thử các tiện ích đó. Trước khi có thể sử dụng một tiện ích bổ sung đã cài đặt lần đầu tiên, bạn phải uỷ quyền cho tiện ích bổ sung đó.
Để biết thêm thông tin chi tiết, 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 ứng dụng lưu trữ Google Workspace mà tiện ích bổ sung đó 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 cấp quyền cho tiện ích bổ sung, họ sẽ không thể sử dụng tiện ích bổ sung đó.
Tiện ích bổ sung cho Trình chỉnh sửa sử dụng mô hình uỷ quyền khác với tiện ích bổ sung cho Google Workspace. Vì các 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 các tiện ích bổ sung cho Trình chỉnh sửa, điều quan trọng là bạn phải hiểu đượ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ế độ đó.
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 sẽ được nhắc Chọn một 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.
- Giờ đây, bạn có thể chạy ứng dụng này từ ứng dụng lưu trữ mà ứng dụng này mở rộng. Nếu ứng dụng đã mở trong một thẻ trình duyệt, bạn có thể phải làm mới thẻ đó trước khi tiện ích bổ sung hoạt động.
Nếu tiện ích bổ sung mà bạn đã cài đặt được cập nhật sau này 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
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 đã xuất bản vì các tiện ích bổ sung này chưa được liệt kê trong Google Workspace Marketplace. Sau khi cài đặt một tiện ích bổ sung chưa xuất bản, 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 sẽ bắt đầu khi bạn cố gắng sử dụng tiện ích bổ sung lần đầu.
Khi chạy, tiện ích bổ sung sẽ xác định xem có cần phải uỷ quyền cho người dùng hay không. Nếu cần uỷ quyền, tiện ích bổ sung sẽ hiển thị một 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.
Uỷ quyền cho các dịch vụ không phải của Google cho 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. Các tiện ích bổ sung của Google Workspace kết nối với các dịch vụ như vậy yêu cầu người dùng thực hiện hai thao tác riêng biệt:
- Uỷ quyền cho 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.
- Uỷ quyền dịch vụ không phải của Google khi truy cập lần đầu.
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
Các tiện ích bổ sung của Google Workspace mở rộng Lịch Google cũng có thể thêm các giải pháp hội nghị khác để cho phép người dùng chọn hệ thống hội nghị 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 tuỳ 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 bên thứ ba trước khi sử dụng tiện ích bổ sung.
Hãy xem phần 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.
Uỷ quyền cho tiện ích bổ sung chưa phát hành của Trình chỉnh sửa
Bạn nên kiểm thử các tiện ích bổ sung của Trình chỉnh sửa khi phát triển các tiện ích đó. Quy trình uỷ quyền giống hệt như quy trình uỷ quyền cho các tiện ích bổ sung đã xuất bản cho Trình chỉnh sửa, 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ỷ uỷ 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ẽ xuất hiện 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.
Để gỡ cài đặt một tiện ích bổ sung chưa phát hành được tích hợp trong Apps Script, hãy tham khảo bài viết Gỡ cài đặt một tiện ích bổ sung chưa phát hành.
Chủ đề có liên quan
- Mở và sử dụng các 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