スペースを作成します。Import mode で名前付きスペースまたはグループ チャットを作成するために使用できます。例については、スペースを作成するをご覧ください。
次のタイプの認証をサポートしています。
- 管理者による承認と次のいずれかの認可スコープを使用したアプリ認証: - https://www.googleapis.com/auth/chat.app.spaces.create
- https://www.googleapis.com/auth/chat.app.spaces
 
- 次のいずれかの認可スコープを使用したユーザー認証: - https://www.googleapis.com/auth/chat.spaces.create
- https://www.googleapis.com/auth/chat.spaces
- https://www.googleapis.com/auth/chat.import(インポート モードのスペースのみ)
 
アプリとして認証する場合は、リクエストで space.customer フィールドを設定する必要があります。
アプリとして認証すると、Chat 用アプリがスペースのメンバーとして追加されます。ただし、ユーザー認証とは異なり、Chat 用アプリはスペース管理者として追加されません。デフォルトでは、スペースのすべてのメンバーが Chat 用アプリをスペースから削除できます。スペース管理者のみがスペースからアプリを削除できるようにするには、space.permission_settings.manage_apps を managersAllowed に設定します。
作成時のスペース メンバーシップは、スペースが Import mode で作成されたかどうかによって異なります。
- インポート モード: メンバーは作成されません。
- その他のすべてのモード: 通話中のユーザーがメンバーとして追加されます。これは次のようになります。
          - アプリ認証を使用している場合はアプリ自体。
- ユーザー認証を使用する場合のユーザー。
 
スペースの作成時にエラー メッセージ ALREADY_EXISTS が表示された場合は、別の displayName を試してください。Google Workspace 組織内の既存のスペースで、この表示名がすでに使用されている可能性があります。
HTTP リクエスト
POST https://chat.googleapis.com/v1/spaces
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
| パラメータ | |
|---|---|
| requestId | 
 省略可。このリクエストの一意の識別子。ランダムな UUID をおすすめします。既存のリクエスト ID を指定すると、新しいスペースが作成されるのではなく、その ID で作成されたスペースが返されます。同じ Chat 用アプリの既存のリクエスト ID を別の認証済みユーザーで指定すると、エラーが返されます。 | 
リクエストの本文
リクエストの本文には Space のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Space のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
- https://www.googleapis.com/auth/chat.app.spaces.create
- https://www.googleapis.com/auth/chat.app.spaces
- https://www.googleapis.com/auth/chat.import
- https://www.googleapis.com/auth/chat.spaces
- https://www.googleapis.com/auth/chat.spaces.create
詳しくは、承認ガイドをご覧ください。