Triển khai tiện ích bổ sung của Meet

Tiện ích bổ sung của Google Meet được tạo và định cấu hình trong một dự án trên Google Cloud.

Tạo một dự án trên Google Cloud

Để tạo một dự án trên Google Cloud, hãy xem bài viết Tạo Google Cloud dự án.

Bật SDK Google Workspace Marketplace và API Tiện ích bổ sung của Google Workspace

Bạn cần có SDK Google Workspace Marketplace và API Tiện ích bổ sung của Google Workspace để phát triển Tiện ích bổ sung của Meet. Cách bật các tính năng này:

  1. Mở Google Cloud Google Play Console.
  2. Ở trên cùng, nếu một dự án khác đã mở, hãy chọn tên dự án của dự án ứng dụng để chuyển đổi dự án.
  3. Ở trên cùng, trong thanh tìm kiếm, hãy nhập Google Workspace Marketplace SDK rồi nhấn Enter.
  4. Mở trang Google Workspace Marketplace SDK, nhấp vào Bật.

  5. Lặp lại các bước này để tìm và bật Google Workspace Add-ons API.

Tạo đợt triển khai

Để sử dụng tiện ích bổ sung trong Meet, bạn cần có một bản triển khai và tệp kê khai tiện ích bổ sung.

  1. Mở Google Cloud Google Play Console.
  2. Ở trên cùng, nếu một dự án khác đã mở, hãy chọn tên dự án của dự án ứng dụng để chuyển đổi dự án.
  3. Nhấp vào API & Dịch vụ.
  4. Chọn Google Workspace Marketplace SDK để xem trang chi tiết.

Tạo quá trình triển khai

Bạn có thể tạo bản triển khai ngay trong Google Cloud Console bằng cách tạo bản triển khai HTTP (nên dùng) hoặc bằng cách sử dụng Google Apps Script.

Triển khai HTTP

  1. Nhấp vào thẻ Bản triển khai HTTP.
  2. Nhấp vào Tạo bản triển khai mới rồi nhập mã bản triển khai của tiện ích bổ sung.

    Mã triển khai là một chuỗi tuỳ ý giúp nhà phát triển sử dụng tiện ích bổ sung để xác định việc triển khai chứa tệp kê khai tiện ích bổ sung. Triển khai Bạn phải cung cấp mã nhận dạng và mã nhận dạng có thể dài tối đa 100 ký tự.

  3. Nhấp vào Tiếp theo.

    Một bảng điều khiển bên sẽ mở ra để bạn gửi thông số kỹ thuật của tệp kê khai tiện ích bổ sung ở định dạng JSON. Đây cũng là có tên là DEPLOYMENT.JSON.

    Tệp kê khai tiện ích bổ sung là cấu hình trung tâm cho một tiện ích bổ sung của Google Meet. Chiến lược phát hành đĩa đơn mã mẫu sau đây cho thấy các trường hiện có trong Meet cho web trong tệp kê khai tiện ích bổ sung.

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUri": "SIDE_PANEL_URI",
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
            "logoUrl": "MEET_WEB_LOGO_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING
          }
        }
      }
    }
    

    Thay thế nội dung sau:

    • NAME: Chuỗi. Tên của tiện ích bổ sung Google Meet.
    • LOGO_URL: Chuỗi. URL của biểu trưng cho Tiện ích bổ sung Google Workspace. Mã này được dùng cho tiện ích bổ sung trên các sản phẩm của Google Workspace.
    • SIDE_PANEL_URI: Chuỗi. URL đến điểm truy cập của ứng dụng bổ sung. URL này hiển thị trong một iframe trong bảng điều khiển bên. Nguồn gốc của URL này phải là một phần của nguồn gốc được chỉ định trong trường ADD_ON_ORIGINS.
    • ADD_ON_ORIGINS: Danh sách các chuỗi. Danh sách nguồn gốc lưu trữ tiện ích bổ sung của bạn. Hai URL có cùng nguồn gốc khi chúng có cùng lược đồ, máy chủ lưu trữ và cổng. Nguồn gốc phụ giống như các miền con có ký tự đại diện cũng được cho phép. Để biết thêm thông tin, hãy xem phần Bảo mật tiện ích bổ sung.
    • DARK_MODE_LOGO_URL: Chuỗi. Bóng tối URL cụ thể của biểu trưng cho tiện ích bổ sung ở chế độ xem. Việc cung cấp biểu trưng ở chế độ tối sẽ đảm bảo tiện ích bổ sung của bạn trông đẹp nhất trong mọi giao diện Meet. Để biết nguyên tắc thiết kế biểu trưng, hãy xem phần Các phương pháp hay nhất.
    • MEET_WEB_LOGO_URL: Không bắt buộc. Chuỗi. Một URL dành riêng cho Meet của biểu trưng cho tiện ích bổ sung. Biểu trưng này được sử dụng trên toàn bộ Meet. Nếu không có, logoUrl trong phần chung sẽ được dùng. Để biết nguyên tắc thiết kế biểu trưng, hãy xem phần Các phương pháp hay nhất.
    • SUPPORTS_SCREENSHARING: Không bắt buộc. Boolean. Nếu được đặt thành false, người dùng phải sử dụng tiện ích bổ sung để xem những gì đang diễn ra trong phiên tiện ích bổ sung cộng tác. Nếu bạn đặt thành true, thì người bắt đầu phiên tiện ích bổ sung cộng tác có thể chia sẻ màn hình về chế độ xem của họ đối với tiện ích bổ sung.
  4. Nhấp vào Gửi.

    Để biết thêm thông tin về quy trình triển khai, hãy xem phần Tạo tài nguyên triển khai.

  5. Trong thẻ Cấu hình ứng dụng, trong mục Tích hợp ứng dụng, hãy chọn Tiện ích bổ sung Google Workspace. Chọn Triển khai bằng tài nguyên triển khai trên đám mây rồi chọn đúng Triển khai HTTP.

Google Apps Script

  1. Nhấp vào thẻ Cấu hình ứng dụng.

  2. Trong phần Tích hợp ứng dụng, hãy chọn Tiện ích bổ sung của Google Workspace. Chọn Triển khai bằng Google Apps Script mã triển khai rồi nhập mã triển khai của tập lệnh.

  3. Nhấp vào Lưu.

    Để biết thông tin chi tiết về cách tạo dự án Apps Script, hãy xem tài liệu về Apps Script. Chiến lược phát hành đĩa đơn Tiện ích bổ sung Meet chỉ dựa trên tệp kê khai appsscript.json, còn được gọi là tệp kê khai Tệp kê khai dự án Apps Script. Đảm bảo tệp kê khai trong dự án Apps Script chứa mã addOns và một phần meet. Các phần addOnsmeet tuân theo cùng một quy tắc như được mô tả trong thẻ triển khai HTTP.

    Không giống như các tiện ích bổ sung khác của Google Workspace, Tiện ích bổ sung của Meet không thể được tạo hoàn toàn trong Apps Script. Thay vào đó, bạn phải tạo một ứng dụng web đầy đủ bằng cách tạo bảng điều khiển bên và sân khấu chính. Sau đó, URL bảng điều khiển bên của ứng dụng web phải được chỉ định trong SIDE_PANEL_URI của tệp kê khai appsscript.json.

Cài đặt và thử nghiệm tiện ích bổ sung trong Meet

Để kiểm thử tiện ích bổ sung trong Meet, trước tiên, bạn phải cài đặt tiện ích bổ sung đó cho người dùng đã đăng nhập:

Triển khai HTTP

  1. Chuyển đến SDK Google Workspace Marketplace cho dự án của bạn trong Google Cloud Console.
  2. Nhấp vào thẻ Triển khai HTTP.
  3. Nhấp vào Cài đặt trong cột Hành động.

Google Apps Script

  1. Làm theo tài liệu về Tiện ích bổ sung của Google Workspace để Cài đặt tiện ích bổ sung chưa phát hành.

Giờ đây, bạn có thể sử dụng tiện ích bổ sung trong cuộc họp. Để dùng thử, hãy bắt đầu một cuộc họp tại meet.google.com. Chiến lược phát hành đĩa đơn tiện ích bổ sung đã cài đặt hiện hiển thị trong phần Hoạt động bảng điều khiển.

Ngoài việc cài đặt tiện ích bổ sung cho từng người dùng đã đăng nhập, bạn cũng có thể xuất bản ứng dụng đó. Khi phát hành tiện ích bổ sung của Google Workspace, bạn sẽ cung cấp tiện ích đó để người khác tìm, cài đặt và sử dụng.