Các phương pháp hay nhất

Cải thiện trải nghiệm người dùng trải nghiệm chung bằng cách làm theo những hướng dẫn sau về Thiết kế của tiện ích bổ sung Google Meet.

Bản dùng thử cho nhà phát triển: Có sẵn như một phần của Chương trình dùng thử Google Workspace dành cho nhà phát triển, cho phép truy cập sớm vào một số tính năng.

Các phương pháp hay nhất về việc uỷ quyền

Bạn nên áp dụng các phương pháp hay nhất sau đây cho Tiện ích bổ sung của Google Meet cần phải xác thực hoặc cho phép.

Sử dụng tính năng Đăng nhập bằng Google

Nhiều người dùng Tiện ích bổ sung của Google Workspace trước đây đã đăng nhập vào Google đang tham gia cuộc họp. Do đó, việc yêu cầu Đăng nhập bằng Google có sẵn dưới dạng tùy chọn có thể lưu cho người dùng nhiều lần nhấp chuột khi quy trình đăng nhập.

Mở trang đăng nhập bên thứ ba trong cửa sổ mới

Ngoài đăng nhập bằng Google, ứng dụng của bạn có thể cung cấp tính năng đăng nhập bổ sung cơ chế cụ thể. Nếu có, hãy sử dụng cửa sổ hộp thoại thay vì mở trang đăng nhập trong . Bằng cách này, người dùng vẫn có thể xem và quay lại qua Meet và sẽ có ít lượt nhấp tổng thể hơn.

Lưu ý: Trang đăng nhập của bên thứ ba cho Tiện ích bổ sung Google Meet không có cùng một cách triển khai dưới dạng Tiện ích bổ sung của Google Workspace. Bạn có thể mở cửa sổ đăng nhập ngay từ iframe . Tiện ích bổ sung của Meet cũng không hỗ trợ Đăng nhập vào tiện ích bổ sung của Google Workspace các thẻ. Tuy nhiên, bạn vẫn cần chuyển hướng người dùng để hoàn tất quá trình xác thực và uỷ quyền trên trang web của bạn cơ sở hạ tầng.

Yêu cầu đúng phạm vi cho các API của Google

Nếu Tiện ích bổ sung Meet gọi API của Google, thì bạn phải cung cấp một danh sách đầy đủ các OAuth các phạm vi theo yêu cầu của tiện ích bổ sung. Việc này được thực hiện trên Trang Cấu hình ứng dụng trên Google Workspace Marketplace. Sau khi thêm các của bạn, người dùng sẽ nhận được lời nhắc khi họ cài đặt Tiện ích bổ sung của Meet cho người dùng biết họ đang xem loại dữ liệu nào cho phép ứng dụng của bạn truy cập.

Trước khi phát hành tiện ích bổ sung, bạn cũng phải thiết lập chế độ đồng ý OAuth màn hình. Bạn phải thêm chính xác cùng phạm vi uỷ quyền từ Cấu hình ứng dụng trên Google Workspace Marketplace. Định cấu hình OAuth màn hình xin phép cũng yêu cầu bạn đặt thông tin thương hiệu, chính sách quyền riêng tư và điều khoản dịch vụ được hiển thị khi phạm vi được yêu cầu. Để xuất bản công khai, tất cả thông tin này phải được gửi cho xác minh.

Lưu ý: Không giống như các Tiện ích bổ sung chung của Google Workspace, Tiện ích này không cần thiết cho Tiện ích bổ sung của Meet để thêm oauthScopes trong tệp kê khai.

Khi viết mã để gọi các API của Google Workspace, hãy tuân theo JavaScript Bắt đầu nhanh là cách dễ nhất để bắt đầu. Phương pháp này tuân thủ các phương pháp hay nhất để bằng cách sử dụng tính năng Đăng nhập bằng Google và cửa sổ hộp thoại. Xin lưu ý rằng việc khởi tạo mã thông báo khách hàng trong JavaScript yêu cầu yêu cầu riêng các phạm vi mà ứng dụng thực sự sử dụng trong thời gian chạy. Để mang lại trải nghiệm tốt nhất cho người dùng, các phạm vi bắt buộc này phải khớp với thông tin trong Cấu hình ứng dụng trên Google Workspace Marketplace . Việc dự phòng này cung cấp phương án dự phòng để xử lý trường hợp mà người dùng đã thu hồi các phạm vi.

Các phương pháp hay nhất về bảo trì

Các phương pháp hay nhất sau đây về cách ghi dễ bảo trì ứng dụng web nhưng chúng đặc biệt quan trọng khi viết bất kỳ Tiện ích bổ sung của Meet.

Sử dụng phiên bản mới nhất của SDK tiện ích bổ sung cho Google Meet

SDK Tiện ích bổ sung của Meet được cập nhật thường xuyên. SDK tuân thủ tạo phiên bản ngữ nghĩa. Cách tìm phiên bản mới nhất:

• Khi sử dụng gstatic: Phiên bản SDK mới nhất nằm trong gstatic URL có trong hướng dẫn sử dụng SDK.
• Khi sử dụng npm: Chạy npm update @googleworkspace/meet-add-ons từ bên trong thư mục chứa package.json cho trang web lưu trữ Tiện ích bổ sung Meet.

Tạo một dự án thử nghiệm trên Google Cloud

Sau khi tiện ích bổ sung Google Meet của bạn được xuất bản trên Google Workspace Marketplace, mọi hoạt động triển khai mới của Tiện ích bổ sung Google Meet đều được dành cho người dùng Meet. Người dùng sẽ thấy các nội dung cập nhật này ngay khi chúng sẽ làm trống bộ nhớ đệm hoặc bộ nhớ đệm sẽ hết hạn. Vì vậy, bạn không nên đẩy các thay đổi vào trang web sản xuất của bạn cho đến khi các thay đổi được kiểm tra kỹ lưỡng.

Lưu ý quan trọng: Người dùng có thể nhận thấy thông tin cập nhật cho ứng dụng của bạn bị chậm trễ Tiện ích bổ sung Meet tuỳ thuộc vào chính sách bộ nhớ đệm của . Đặt thời gian hết hạn bộ nhớ đệm đến giá trị thích hợp cho đăng ký—tốt nhất là không quá 24 giờ—để đảm bảo tính nhất quán trải nghiệm người dùng. Người dùng cũng sẽ thấy một phiên bản mới nếu họ xoá bộ nhớ đệm theo cách thủ công.

Để tránh việc triển khai thẳng vào giai đoạn sản xuất, bạn nên tạo một Dự án Google Cloud được xuất bản riêng tư cho tổ chức của bạn. Dự án Cloud này sẽ lưu trữ cả quá trình thử nghiệm và môi trường phát triển riêng cho Tiện ích bổ sung Meet. Quyền truy cập cho dự án Cloud này nên được giới hạn ở một nhóm nhỏ hơn trực tiếp phụ trách việc phát triển tiện ích bổ sung.

Để tạo các môi trường thay thế này cho tiện ích bổ sung, trước tiên, bạn cần lưu trữ các môi trường thay thế của ứng dụng web chứa tiện ích bổ sung trên miền mà bạn sở hữu. Sau đó: bạn có thể tạo môi trường thay thế cho Tiện ích bổ sung Meet bằng cách thêm triển khai cho dự án Google Cloud thử nghiệm của mình. Những hoạt động triển khai mới này cần phải tệp kê khai trỏ đến môi trường thay thế của ứng dụng web. Sau đó, bạn nên cài đặt từng tiện ích bổ sung môi trường như sau:

• Thử nghiệm: Xuất bản phiên bản thử nghiệm ở chế độ riêng tư để bất cứ ai trong tổ chức của bạn đều có thể hỗ trợ thử nghiệm.
• Phát triển: Nhấp vào Cài đặt trong cột Hành động để cài đặt Phiên bản phát triển của Tiện ích bổ sung Meet chỉ dành cho tài khoản của bạn.

Viết mã kiểm thử

Trước khi triển khai Tiện ích bổ sung của Meet cho một quá trình phát triển hãy viết mã kiểm thử đơn vị. Bài kiểm thử đơn vị của bạn nên bao gồm:

• Mô phỏng SDK tiện ích bổ sung cho Meet, sau đó xác minh rằng Tiện ích bổ sung Meet gọi các chức năng SDK như dự kiến.
• Kiểm thử đơn vị tất cả chức năng không liên quan đến SDK của tiện ích bổ sung với khung kiểm tra web mà bạn ưa thích.

Các phương pháp hay nhất về trải nghiệm người dùng

Các phương pháp hay nhất sau đây giúp tạo tiện ích bổ sung cho Meet trực quan và tinh tế hơn.

Quản lý tất cả trạng thái bắt đầu trong bảng điều khiển bên

Chúng tôi đặc biệt khuyến khích bạn thiết lập tiện ích bổ sung dựa trên hành động của người dùng mà người dùng đã thực hiện trong bảng điều khiển bên. Bạn có thể thực hiện việc này bằng cách bắt đầu cộng tác trạng thái ở JavaScript. Tất cả dữ liệu chuyển vào CollaborationStartingState phải do người khởi tạo tiện ích bổ sung thiết lập (thường người tổ chức cuộc họp) trong bảng điều khiển bên. Bạn có thể nghĩ đến chế độ xem đầu tiên của bảng điều khiển bên dưới dạng biểu mẫu kiểm soát việc thiết lập tiện ích bổ sung.

Đóng bảng điều khiển bên khi không sử dụng

Sau khi bắt đầu hoạt động bằng cách gọi startCollaboration! bạn chỉ nên giữ lại bảng điều khiển bên mở nếu đó là một phần thiết yếu trong trải nghiệm người dùng Tiện ích bổ sung của Google Meet. Bạn có thể đóng bảng điều khiển bên sau khi nút chính giai đoạn được mở bằng cách gọi unloadSidePanel.

Quảng bá tiện ích bổ sung của Meet thông qua tính năng chia sẻ màn hình

Tiện ích bổ sung của Meet mang đến trải nghiệm phong phú hơn so với tính năng chia sẻ màn hình. Tuy nhiên, nhiều người dùng quen với việc sử dụng tính năng chia sẻ màn hình của Meet của chúng tôi. Nếu người dùng chia sẻ một thẻ hiển thị trang web lưu trữ Tiện ích bổ sung của Meet, Meet có thể được định cấu hình thành hiển thị một biểu ngữ cho tất cả những người tham gia cuộc gọi để nhắc họ cài đặt hoặc sử dụng Tiện ích bổ sung tương ứng của Meet. Để biết thêm thông tin, hãy xem quảng bá tiện ích bổ sung qua màn hình chia sẻ.