Method: spaces.create

スペースを作成します。名前付きスペースや Import mode のグループ チャットを作成するために使用できます。例については、スペースを作成するをご覧ください。

次のタイプの認証をサポートしています。

アプリとして認証する場合は、リクエストで space.customer フィールドを設定する必要があります。

作成時のスペースの参加資格は、スペースが Import mode で作成されたかどうかによって異なります。

  • インポート モード: メンバーは作成されません。
  • その他のすべてのモード: 呼び出し元のユーザーがメンバーとして追加されます。以下に例を示します。
    • アプリ認証を使用している場合、アプリ自体。
    • ユーザー認証を使用している場合は、人間のユーザー。

スペースの作成時にエラー メッセージ ALREADY_EXISTS が表示された場合は、別の displayName を試してください。Google Workspace 組織内の既存のスペースで、この表示名がすでに使用されている可能性があります。

HTTP リクエスト

POST https://chat.googleapis.com/v1/spaces

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
requestId

string

省略可。このリクエストの一意の識別子。ランダムな 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

詳しくは、認可ガイドをご覧ください。