tiện ích bổ sung cần được người dùng cho phép trước khi chúng có thể hoạt động. Điều này đúng đối với cả tiện ích bổ sung đã phát hành mà bạn cài đặt từ Google Workspace Marketplace và các tiện ích bổ sung mà bạn đang tự phát triển.
Cho phép tiện ích bổ sung đã phát hành
Sau khi bạn cài đặ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 tài khoản để cài đặt tiện ích bổ sung.
- Sau đó, bạn sẽ thấy danh sách các uỷ quyền mà tiện ích bổ sung yêu cầu để hoạt động để biết những việc mà tiện ích bổ sung cần 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 Cho phép. Thao tác này sẽ bật tiện ích bổ sung để sử dụng.
- Bạn hiện có thể chạy tệp này từ ứng dụng lưu trữ mà nó mở rộng. Nếu ứng dụng đã mở trong một thẻ trình duyệt, thì 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 bạn đã cài đặt sau đó được cập nhật và cần thêm các quyền mà bạn chưa cấp, thì bạn sẽ được nhắc cấp các quyền đó vào lần tiếp theo bạn sử dụng tiện ích bổ sung.
Ủy quyền cho 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úng chưa được liệt kê 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 sẽ bắt đầu khi bạn thử sử dụng tiện ích bổ sung lần đầu tiên.
Khi chạy tiện ích bổ sung, tiện ích bổ sung sẽ xác định xem có cần sự cho phép của người dùng hay không. Nếu cần uỷ quyền, tiện ích bổ sung sẽ hiển thị thẻ uỷ quyền. Bạn luôn phải uỷ quyền vào lần đầu tiên tiện ích bổ sung thực thi và cũng có thể cần phải 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 Cấp 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 đối với tiện ích bổ sung.
Cấp phép 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 được cho phép. Tiện ích bổ sung của Google Workspace kết nối với các 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 của 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.
- Cấp quyền cho dịch vụ không phải của Google khi dịch vụ đó đượ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 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.
Khi cần được cho phép một dịch vụ không phải của Google, Tiện ích bổ sung của Google Workspace sẽ hiển thị cho người dùng thẻ lời nhắc cấp quyền cho dịch vụ đó. Bạn có thể tuỳ chỉnh lời nhắc uỷ quyền này nếu muốn hoặc sử dụng thẻ mặc định.
Để biết thêm thông tin chi tiết, vui lòng tham khảo hướng dẫn Kết nối với các dịch vụ không phải của Google.
Hệ thống hội nghị truyền hình của bên thứ ba
Tiện ích bổ sung cho Google Workspace giúp mở rộng Lịch Google cũng có thể thêm các 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 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 thực hiện việc đó.
Nếu người dùng cố gắng tạo hội nghị truyền hình 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 các giải pháp hội nghị truyền hình sẽ trả về đối tượng ConferenceData chứa ConferenceError với một URL xác thực.
Khi nhận được đối tượng này, Lịch Google sẽ tạo nút ĐĂNG NHẬP trong giao diện người dùng chỉnh sửa sự kiện. Nút này 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 thêm tiện ích bổ sung.
Xem bài viết Tạo hội nghị 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.
Ủy quyền Tiện ích bổ sung dành cho trình chỉnh sửa chưa được xuất bản
Đây là phương pháp hay nhất để kiểm thử Tiện ích bổ sung trình chỉnh sửa khi bạn phát triển các Tiện ích bổ sung đó. Quy trình uỷ quyền giống với quy trình đối với Tiện ích bổ sung dành cho trình chỉnh sửa đã phát hành, ngoại trừ 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. Nếu sau này bạn thử nghiệm lại tiện ích bổ sung đó, thì bạn sẽ không thấy lời nhắc uỷ quyền nữa.
Đang hủy cấp phép cho tiện ích bổ sung
Khi phát triển tiện ích bổ sung, bạn nên huỷ uỷ quyền để 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 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 LOẠI BỎ 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 hiển thị lại.