スペースを作成します。Import mode
で名前付きスペースまたはグループ チャットを作成するために使用できます。例については、スペースを作成するをご覧ください。
次のタイプの認証をサポートしています。
アプリとして認証する場合は、リクエストで space.customer
フィールドを設定する必要があります。
作成時のスペースの参加資格は、スペースが Import mode
で作成されたかどうかによって異なります。
- インポート モード: メンバーは作成されません。
- その他のすべてのモード: 呼び出し元のユーザーがメンバーとして追加されます。次のようにします。
- アプリ認証を使用している場合、アプリ自体。
- ユーザー認証を使用している場合は、人間のユーザー。
スペースの作成時にエラー メッセージ ALREADY_EXISTS
が表示された場合は、別の displayName
を試してください。Google Workspace 組織内の既存のスペースで、この表示名がすでに使用されている可能性があります。
HTTP リクエスト
POST https://chat.googleapis.com/v1/spaces
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ | |
---|---|
request |
省略可。このリクエストの一意の識別子。ランダムな 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
詳しくは、認可ガイドをご覧ください。