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 dự án trên Google Cloud

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

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 các tiện ích bổ sung cho Meet. Cách bật các tính năng này:

  1. Mở Google Cloud 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 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 và 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 tiện ích bổ sung xác định bản triển khai chứa tệp kê khai tiện ích bổ sung. Mã nhận dạng triển khai là thông tin bắt buộc và có thể có 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. Tệp nà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 tiện ích bổ sung của Google Meet. Mẫu mã 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. 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 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ủ và cổng. Nguồn gốc phụ cũng được phép, cũng như miền con ký tự đại diện. Để 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. URL cụ thể của biểu trưng ở chế độ tối 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 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ó, hệ thống sẽ sử dụng logoUrl từ phần chung. Để 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ề các bản 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, sau đó chọn đúng phương thức triển khai HTTP.

Google Apps Script

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

  2. Trong mục 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ã triển khai Google Apps Script 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. Tiện ích bổ sung Meet chỉ dựa vào tệp kê khai appsscript.json, còn gọi là tệp kê khai dự án Apps Script. Đảm bảo tệp kê khai trong dự án Apps Script của bạn chứa một phần addOnsmeet. Các phần addOnsmeet tuân theo cùng một cấu trúc như 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 hoàn toàn tiện ích bổ sung Meet 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 một bảng điều khiển bên và sân khấu 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 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ẻ Bản 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 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 trên meet.google.com. Tiện ích bổ sung đã cài đặt hiện 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 người dùng đã đăng nhập, bạn cũng có thể phát hành tiện ích bổ sung đó. 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.