Google Workspace 組織の特定のユーザーが Google Chat スペースを検索できるようにする

このページでは、Google Chat API を使用して Google Workspace 組織内の特定のユーザーと Google Chat スペースを共有し、そのユーザーがスペースを見つけて参加できるようにする方法について説明します。

スペースを検出して参加できる組織内のユーザーを指定するには、対象グループを作成します。対象グループとは、Chat スペースを共有して、スペースの認知度と共有可能性を高めることができるユーザーのグループ（特定の部門や組織全体など）のことです。対象ユーザーを使用すると、個々のユーザーをスペースに招待するのではなく、スペースのメンバーシップを管理、カスタマイズすることもできます。詳細については、ターゲット ユーザーについてをご覧ください。

名前付きスペースは、対象グループに対してのみ検出可能にできます。ダイレクト メッセージやグループの会話など、他のタイプのスペースを対象グループと共有することはできません。

前提条件

ターゲット オーディエンス ID を取得する

ターゲット ユーザーの ID を取得する手順は次のとおりです。

  1. Google 管理コンソールで、メニュー アイコン > [ディレクトリ] > [対象グループ] に移動します。

    [対象グループ] に移動

  2. [対象グループ] テーブルで、対象グループの [名前] フィールドをクリックします。

  3. 対象ユーザーの ID は、ページの URL で確認できます。URL の形式は https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID です。ここで、TARGET_AUDIENCE_ID はターゲット ユーザーの英数字の ID です。

次のセクションでは、ターゲット オーディエンス ID を使用して、検索可能なスペースを作成するか、既存のスペースを更新してターゲット オーディエンスが検索できるようにします。

Chat API リクエストで対象ユーザーを指定する

特定のターゲット ユーザー向けのスペースを作成するには、Space リソースの create() メソッドまたは setup() メソッドを使用します。既存のスペースを検出可能にするには、Space リソースで update() メソッドを使用します。名前付きスペースのみをターゲット ユーザーと共有できるため、スペースタイプ（spaceType フィールドで表される）は SPACE である必要があります。

対象ユーザーがスペースを検索できるようにするには、Chat API リクエストの一部として Space リソースに AccessSettings オブジェクトを含めます。オブジェクトで、audience フィールドを指定します。

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

TARGET_AUDIENCE_ID は、前のセクションで取得したターゲット ユーザーの ID に置き換えます。Google Workspace 組織のデフォルトの Chat スペース共有設定を使用するには、default に置き換えます。

Chat API を使用してスペースを作成または更新する方法については、次のガイドをご覧ください。