Meet アドオンをデプロイする

Google Meet アドオンは、Google Cloud プロジェクトの一部として作成、構成されます。

Google Cloud プロジェクトを作成する

Google Cloud プロジェクトを生成するには、Google Cloud プロジェクトを作成するをご覧ください。

Google Workspace Marketplace SDK と Google Workspace Add-ons 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 を選択して詳細ページを表示します。

Deployment を作成する

デプロイメントは、HTTP デプロイメントを作成するか(推奨)、Google Apps Script を使用して Google Cloud コンソールで直接作成できます。

HTTP デプロイ

  1. [HTTP deployments] タブをクリックします。
  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 アドオンのロゴの URL。これは、Google Workspace プロダクト全体のアドオンに使用されます。
    • SIDE_PANEL_URI: 文字列。アドオン アプリのエントリ ポイントの URL。これはサイドパネル内の iframe に表示されます。この URL のオリジンは、ADD_ON_ORIGINS フィールドで指定されたオリジンの一部である必要があります。
    • ADD_ON_ORIGINS: 文字列のリスト。アドオンがホストされている送信元のリスト。2 つの URL が同じスキーム、ホスト、ポートを共有している場合、2 つの URL のオリジンは同じです。サブオリジンも、ワイルドカード サブドメインと同様に使用できます。詳細については、アドオンのセキュリティをご覧ください。
    • DARK_MODE_LOGO_URL: 文字列。ダークモード専用のアドオンのロゴの URL。ダークモードのロゴを指定すると、どの Meet テーマでもアドオンが最適に表示されます。ロゴのデザイン ガイドラインについては、ベスト プラクティスをご覧ください。
    • MEET_WEB_LOGO_URL: 省略可。文字列。アドオンのロゴの Meet 固有の URL。このロゴは Meet 全体で使用されます。存在しない場合、共通セクションの logoUrl が使用されます。ロゴの設計ガイドラインについては、ベスト プラクティスをご覧ください。
    • SUPPORTS_SCREENSHARING: 省略可。ブール値。false に設定した場合、ユーザーはアドオンを使用して、共同編集のアドオン セッションで何が起こっているかを確認する必要があります。true に設定すると、共同編集アドオン セッションを開始したユーザーは、アドオンのビューを画面共有できます。
  4. [送信] をクリックします。

    Deployment の詳細については、Deployment リソースを作成するをご覧ください。

  5. [アプリの構成] タブの [アプリの統合] で、[Google Workspace アドオン] を選択します。[Cloud Deployment リソースを使用してデプロイする] を選択し、適切な HTTP デプロイを選択します。

Google Apps Script

  1. [アプリの設定] タブをクリックします。

  2. [アプリの統合] で [Google Workspace アドオン] を選択します。[Google Apps Script のデプロイ ID を使用してデプロイする] を選択し、スクリプトのデプロイ ID を入力します。

  3. [保存] をクリックします。

    Apps Script プロジェクトの作成方法については、Apps Script のドキュメントをご覧ください。Meet アドオンは、Apps Script プロジェクト マニフェストとも呼ばれる appsscript.json マニフェスト ファイルにのみ依存します。Apps Script プロジェクトのマニフェスト ファイルに addOns セクションと meet セクションが含まれていることを確認します。addOns セクションと meet セクションは、[HTTP デプロイ] タブで説明されている構造と同じです。

    他の Google Workspace アドオンとは異なり、Meet アドオンは Apps Script で完全に構築することはできません。代わりに、サイドパネルとメインステージを作成して、完全なウェブアプリを構築する必要があります。ウェブアプリのサイドパネル URL は、appsscript.json マニフェスト ファイルの SIDE_PANEL_URI で指定する必要があります。

Meet でアドオンをインストールしてテストする

Meet でアドインをテストするには、まずログインしたユーザーにアドインをインストールする必要があります。

HTTP デプロイ

  1. Google Cloud コンソールで、プロジェクトの Google Workspace Marketplace SDK に移動します
  2. [HTTP deployments] タブをクリックします。
  3. [アクション] 列で [インストール] をクリックします。

Google Apps Script

  1. Google Workspace アドオンのドキュメントに沿って、公開されていないアドオンをインストールします。

これで、会議でアドオンを使用できるようになります。試すには、meet.google.com で会議を開始します。インストールしたアドオンが [アクティビティ] パネルに表示されます。

ログインした個々のユーザーにアドオンをインストールするだけでなく、公開することもできます。Google Workspace アドオンを公開すると、他のユーザーがアドオンを見つけてインストールして使用できるようになります。