このページでは、Google Chat API を使用して Google Workspace 組織内の特定のユーザーと Google Chat スペースを共有し、ユーザーがスペースを検出して参加できるようにする方法について説明します。
スペースを検出して参加できる組織内のユーザーを指定するには、対象グループを作成します。対象グループとは、Chat スペースを共有してスペースの認知度と共有性を高めることができるグループ（特定の部署や組織全体など）のことです。 対象グループを使用すると、スペースに個々のユーザーを招待するのではなく、スペースのメンバーシップを管理してカスタマイズできます。詳しくは、対象グループについての記事をご覧ください。
対象グループから検出できるように設定できるのは、名前付きスペースのみです。ダイレクト メッセージやグループ会話など、他のスペースタイプを対象グループと共有することはできません。
前提条件
- Google Chat にアクセスできる Business または Enterprise Google Workspace アカウント Google Chat。 アカウントには、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 を使用して、検出可能なスペースを作成するか、既存のスペースを更新して対象グループから検出できるようにします。
対象グループと詳細な権限を指定する
特定のアクセス権を持つスペースを作成するには、
create または
setup メソッドを
Space リソースで使用します。既存のスペースの権限を更新するには、
update メソッドを使用します。名前付きスペースのみを対象グループと共有できるため、スペースタイプ（spaceType
フィールドで表される）は SPACE である必要があります。
スペースを検出または参加できるユーザーを指定するには、
AccessSettings
オブジェクトを Space リソースに含めます。オブジェクトで、accessPermissionSettings フィールドを使用して、次の権限を 1
つ以上指定します。
- 検出可能:
discoverSpaceSettingを使用して、スペースの名前 と説明を検索し、Google Chat 内で検索できるユーザーを定義します。検出用に複数の対象グループを指定できます。 - 参加可能:
joinSpaceSettingを使用して、明示的な招待なしでスペースに参加し、スペース メッセージをプレビューできるユーザーを定義します。スペースに参加できるユーザーは、スペースを検出できる必要があります。Google Chat では、この権限に対して 1 つの対象グループがサポートされています。
次の例では、スペースを 2 つの対象グループから検出可能にしつつ、そのうち 1 つのグループのみが参加できるように設定する方法を示します。
"accessSettings": {
"accessPermissionSettings": {
"discoverSpaceSetting": {
"principals": [
{ "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
{ "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
]
},
"joinSpaceSetting": {
"principals": [
{ "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
]
}
}
}
TARGET_AUDIENCE_ID_1 と
TARGET_AUDIENCE_ID_2 は、対象
グループの ID を取得する
で取得した対象グループの ID に置き換えます。
Google Workspace 組織のデフォルトの Chat スペース共有設定を使用するには、 を default に置き換えます。
下位互換性を維持するために audience フィールドを使用する
下位互換性を維持するために、引き続き audience フィールドを使用して
スペースに参加できる単一の対象グループを指定できますが、
対象グループと詳細な権限を指定するを使用することをおすすめします。
audience フィールドの設定は、joinSpaceSetting と discoverSpaceSetting の両方で対象グループを指定するのと同じです。
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
TARGET_AUDIENCE_ID は、対象グループの ID を取得するで取得した対象グループの ID に置き換えます。Google Workspace 組織のデフォルトの Chat スペース共有設定を使用するには、 を default に置き換えます。
API レスポンスのアクセス設定について
スペースを取得すると、レスポンスの
AccessSettings
オブジェクトに、スペースに設定されている詳細な権限が反映されます。
AccessSettings の次のフィールドは、スペースの検索可能性と参加権限を示します。
accessState: 検出権限（discoverSpaceSetting）から派生します。1 つ以上の対象グループに検出権限が付与されている場合、このフィールドはDISCOVERABLEになります。それ以外の場合はPRIVATEです。audience: 参加権限（joinSpaceSetting）に固有のマッピング。単一の対象グループに参加権限が付与されている場合、このフィールドにはその対象グループのリソース名が含まれます。
参加オーディエンスのない検出可能なスペース
スペースは対象グループから検出可能でも、直接参加できない場合があります（たとえば、参加するには明示的に招待される必要がある場合など）。
この場合、AccessSettings オブジェクトの値は次のようになります。
accessState:DISCOVERABLEaudience: 省略またはnull
accessState が DISCOVERABLE に設定されているのに audience が存在しない場合、スペースは discoverSpaceSetting で指定された対象グループから検出できますが、招待によってのみ参加できます。スペースを検出できる対象グループを確認するには、
accessPermissionSettings.discoverSpaceSetting
フィールドを確認します。
関連トピック
対象グループの詳細については、次のガイドをご覧ください。
Chat API を使用してスペースを作成または更新する方法については、次のガイドをご覧ください。