このページでは、Google Chat API を使用して Google Workspace 組織の特定のユーザーと Google Chat スペースを共有し、スペースを見つけて参加できるようにする方法について説明します。
スペースを見つけて参加できる組織内のユーザーを指定するには、対象グループを作成します。対象グループとは、スペースの認知度や共有可能性を高めるために Chat スペースを共有できるユーザーのグループ（特定の部門や組織全体など）です。対象グループを使用すると、個々のユーザーをスペースに招待する必要なく、スペース メンバーシップの管理とカスタマイズを行うことができます。詳細については、ターゲット オーディエンスについてをご覧ください。
対象グループが検索可能にできるのは名前付きスペースのみです。ダイレクト メッセージやグループの会話など、他の種類のスペースを対象グループと共有することはできません。
前提条件
- Google Chat へのアクセス権を持つ Google Workspace アカウント。アカウントには、Google Workspace 組織の特権管理者ロールが必要です。
- Chat でアクセスできる対象グループ。対象グループを作成するには、対象グループを作成するをご覧ください。既存の対象グループを Chat スペースで使用できるようにするには、Chat 用のスペースへのアクセスを設定するをご覧ください。
対象グループの ID を取得する
対象グループの ID を取得する手順は次のとおりです。
Google 管理コンソールで、メニュー > [ディレクトリ] > [対象グループ] に移動します。
[対象グループ] テーブルで、対象グループの [名前] フィールドをクリックします。
対象グループの 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 を使用したスペースの作成または更新の詳細については、次のガイドをご覧ください。