部署 Meet 外掛程式

Google Meet 外掛程式是 Google Cloud 專案的一部分,因此必須在該專案中建立及設定。

建立 Google Cloud 專案

如要產生 Google Cloud 專案,請參閱「建立 Google Cloud 專案」。

啟用 Google Workspace Marketplace SDK 和 Google Workspace 外掛程式 API

如要開發 Meet 外掛程式,您必須使用 Google Workspace Marketplace SDK 和 Google Workspace Add-ons API。如要啟用這些功能,請按照下列步驟操作:

  1. 開啟 Google Cloud 控制台
  2. 如果已開啟其他專案,請選取應用程式專案的專案名稱,切換專案。
  3. 在頂端的搜尋列中輸入 Google Workspace Marketplace SDK,然後按下 Enter 鍵。
  4. 開啟 Google Workspace Marketplace SDK 頁面,然後按一下「啟用」

  5. 重複執行這些步驟,找出並啟用 Google Workspace add-ons API

建立 Deployment

如要在 Meet 中使用外掛程式,您需要部署和外掛程式資訊清單檔案

  1. 開啟 Google Cloud 控制台
  2. 如果已開啟其他專案,請選取應用程式專案的專案名稱,切換專案。
  3. 按一下「API 和服務」
  4. 選取 Google Workspace Marketplace SDK 即可查看詳細資料頁面。

建立部署作業

您可以直接在 Google Cloud 控制台中建立部署作業,方法是建立 HTTP 部署作業 (建議做法),或是使用 Google Apps 指令碼。

HTTP 部署

  1. 按一下「HTTP 部署」分頁標籤。
  2. 按一下「建立新部署作業」,然後輸入外掛程式的部署 ID。

    部署 ID 是任意字串,可協助外掛程式開發人員識別包含外掛程式資訊清單的部署作業。部署作業 ID 為必填欄位,且長度不得超過 100 個半形字元。

  3. 點選「下一步」

    側邊面板會隨即開啟,您可以使用 JSON 格式提交外掛程式資訊清單規格。這也稱為 DEPLOYMENT.JSON。

    外掛程式資訊清單檔案是 Google Meet 外掛程式的中央設定檔。以下程式碼範例顯示外掛程式資訊清單檔案中可用的 Meet 網頁版欄位。

    {
      "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
          }
        }
      }
    }
    

    更改下列內容:

    • NAME:字串。Google Meet 外掛程式的名稱。
    • LOGO_URL:字串。Google Workspace 外掛程式標誌的網址。這個屬性適用於 Google Workspace 產品中的外掛程式。
    • SIDE_PANEL_URI:字串。外掛應用程式進入點的網址。這個網址會顯示在側邊面板中的 iframe 中。這個網址的來源必須是 ADD_ON_ORIGINS 欄位中指定的來源之一。
    • ADD_ON_ORIGINS:字串清單。代管外掛程式的來源清單。如果兩個網址共用相同的配置、主機和通訊埠,則屬於同一來源。子網域來源和萬用字元子網域也允許使用。詳情請參閱外掛程式安全性
    • DARK_MODE_LOGO_URL:字串。擴充功能的深色模式專屬標誌網址。提供深色模式標誌,可確保您的外掛程式在任何 Meet 主題中都能呈現最佳效果。如需標誌設計規範,請參閱「最佳做法」。
    • MEET_WEB_LOGO_URL:選用。字串。外掛程式標誌的 Meet 專屬網址。這個標誌會用於 Meet 的各個部分。如果未提供,系統會使用一般部分的 logoUrl。如需標誌設計規範,請參閱「最佳做法」。
    • SUPPORTS_SCREENSHARING:選用。布林值。如果設為 false,使用者必須使用外掛程式,才能查看協作外掛程式工作階段中的情況。如果設為 true,協作外掛程式工作階段的發起者就能分享他們對外掛程式的觀點。
  4. 按一下「提交」

    如要進一步瞭解部署作業,請參閱「建立部署資源」。

  5. 在「應用程式設定」分頁的「應用程式整合」下方,選取「Google Workspace 外掛程式」。選取「使用雲端部署作業資源執行部署工作」,然後選擇正確的 HTTP 部署作業。

Google Apps Script

  1. 按一下「App configuration」分頁標籤。

  2. 在「應用程式整合」下方,選取「Google Workspace 外掛程式」。選取「使用 Google Apps Script 部署 ID 部署」,然後輸入指令碼的部署 ID。

  3. 點按「儲存」

    如要進一步瞭解如何建立 Apps Script 專案,請參閱 Apps Script 說明文件。Meet 外掛程式只會使用 appsscript.json 資訊清單檔案,也稱為 Apps Script 專案資訊清單。請確認 Apps 指令碼專案中的資訊清單檔案包含 addOnsmeet 區段。addOnsmeet 部分的結構與 HTTP 部署分頁中所述的相同。

    與其他 Google Workspace 外掛程式不同,Meet 外掛程式無法完全在 Apps Script 中建構。您必須建立側邊面板和主要階段,建構完整的網頁應用程式。接著,您必須在 appsscript.json 資訊清單檔案的 SIDE_PANEL_URI 下方指定網路應用程式的側邊面板網址。

在 Meet 中安裝及測試外掛程式

如要在 Meet 中測試外掛程式,您必須先為已登入的使用者安裝外掛程式:

HTTP 部署

  1. 在 Google Cloud 控制台中前往專案的 Google Workspace Marketplace SDK
  2. 按一下「HTTP 部署」分頁標籤。
  3. 按一下「動作」欄下方的「安裝」

Google Apps Script

  1. 請按照 Google Workspace 外掛程式說明文件的說明安裝未發布的外掛程式

你現在應該可以在會議中使用外掛程式。 如要試用,請前往 meet.google.com 發起會議。現在,您可以在「活動」面板中看到已安裝的外掛程式。

除了為個別登入使用者安裝外掛程式,您也可以發布外掛程式。發布 Google Workspace 外掛程式後,其他人就能找到、安裝及使用這項外掛程式。