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