このページでは、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 リクエストで対象グループを指定する
特定のターゲット オーディエンス用のスペースを作成するには、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 を使用してスペースを作成または更新する方法については、次のガイドをご覧ください。