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 phần Tạo một dự án trên Google Cloud.

Bật Google Workspace Marketplace SDK và Google Workspace Add-ons API

Bạn cần có Bộ công cụ phát triển phần mềm Google Workspace Marketplace và API tiện ích bổ sung của Google Workspace để phát triển tiện ích bổ sung cho Meet. Cách bật các tính năng này:

  1. Mở Bảng điều khiển Google Cloud.
  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 phím 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 một tiện ích bổ sung trong Meet, bạn cần có một tệp triển khai và một tệp kê khai tiện ích bổ sung.

  1. Mở Bảng điều khiển Google Cloud.
  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 và Dịch vụ.
  4. Chọn biểu tượng Google Workspace Marketplace SDK để xem trang chi tiết.

Tạo quy 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 một 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ẻ Triển khai HTTP.

  2. Nhấp vào Tạo lượt triển khai mới rồi nhập mã nhận dạng lượt triển khai của tiện ích bổ sung.

    Mã nhận dạng triển khai là một chuỗi tuỳ ý giúp nhà phát triển tiện ích bổ sung xác định bản triển khai chứa tệp kê khai tiện ích bổ sung. Bạn phải cung cấp mã nhận dạng triển khai và mã này có thể chứa 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 quy cách của tệp kê khai tiện ích bổ sung ở định dạng JSON. Đây cũng được gọi 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. Đoạn mã mẫu sau đây cho thấy các trường Meet có sẵn 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. Đây là biểu trưng đượ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ổ trợ. URL này xuất hiện 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 nơi lưu trữ tiện ích bổ sung của bạn. Hai URL có cùng nguồn gốc khi chúng dùng chung lược đồ, máy chủ lưu trữ và cổng. Bạn cũng được phép sử dụng nguồn gốc phụ, cũng như miền con có ký tự đại diện. Để biết thêm thông tin, hãy xem phần Bảo mật bổ sung.
    • DARK_MODE_LOGO_URL: Chuỗi. URL dành riêng cho chế độ tối của biểu trưng cho tiện ích bổ sung. 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 của Meet. Để biết nguyên tắc thiết kế biểu trưng, hãy xem Các phương pháp hay nhất.
    • MEET_WEB_LOGO_URL: Không bắt buộc. Chuỗi. 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 dùng trên toàn bộ Meet. Nếu không có, logoUrl trong phần chung sẽ được sử 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 bạn đặ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 một phiên tiện ích bổ sung cộng tác. Nếu bạn đặt chính sách này thành true, thì người khởi tạo phiên cộng tác bằng tiện ích bổ sung có thể chia sẻ màn hình về chế độ xem tiện ích bổ sung của họ.

  4. Nhấp vào Gửi.

    Để biết thêm thông tin về việc 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 chế độ triển khai HTTP phù hợp.

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 mã nhận dạng triển khai Google Apps Script rồi nhập mã nhận dạng 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. Tiện ích bổ sung Meet chỉ dựa vào tệp kê khai appsscript.json, còn được gọi là tệp kê khai dự án Apps Script. Đảm bảo rằng tệp kê khai trong dự án Apps Script của bạn có một phần addOns và một phần meet. Các phần addOns và meet có cấu trúc giống như cấu trúc đượ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, bạn không thể tạo tiện ích bổ sung Meet hoàn toàn trong Apps Script. Thay vào đó, bạn phải tạo một ứng dụng web hoàn chỉnh bằng cách tạo một bảng điều khiển bên và giai đoạn chính. Sau đó, bạn phải chỉ định URL của bảng điều khiển bên của ứng dụng web trong SIDE_PANEL_URI của tệp kê khai appsscript.json.

Cài đặt và kiểm thử 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 đó cho người dùng đã đăng nhập:

Triển khai HTTP

  1. Chuyển đến Google Workspace Marketplace SDK 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 Thao tác.

Google Apps Script

  1. Làm theo tài liệu về tiện ích bổ sung của Google Workspace để Cài đặt một tiện ích bổ sung chưa được xuất bản.

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. Tiện ích bổ sung đã cài đặt hiện sẽ xuất hiện trong bảng điều khiển Hoạt động.

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 tiện ích bổ sung đó. Khi xuất bản tiện ích bổ sung Google Workspace, bạn sẽ cung cấp tiện ích đó cho người khác tìm, cài đặt và sử dụng.