このページでは、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 管理コンソールで、 [メニュー アイコン] > [ディレクトリ] > [対象グループ] に移動します。
[対象グループ] 表で、対象グループの [名前] フィールドをクリックします。
ページの URL で対象グループ ID を確認します。URL の形式は
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_IDです。 ここで、TARGET_AUDIENCE_IDは 対象グループの英数字の ID です。
次のセクションでは、対象グループ ID を使用して、検索可能なスペースを作成するか、既存のスペースを更新して対象グループが検索できるようにします。
Chat API リクエストで対象グループを指定する
特定の対象グループのスペースを作成するには、create() または
setup() メソッドを Space リソースで使用します。既存のスペース
を検出可能にするには、update() メソッドを Space リソースで使用します。対象グループと共有できるのは名前付きスペースのみであるため、スペースタイプ（spaceType
フィールドで表される）は SPACE である必要があります。
スペースを対象グループが検出できるようにするには、Chat API リクエストの一部として、
AccessSettings
オブジェクトをSpaceリソースに含めます。オブジェクトで、audience フィールドを指定します。
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
TARGET_AUDIENCE_ID は、前のセクションで取得した対象グループの ID に置き換えます。Google Workspace 組織のデフォルトの Chat スペース共有設定を使用するには、 を default に置き換えます。
Chat API を使用してスペースを作成または更新する方法について詳しくは、次のガイドをご覧ください。