创建没有任何成员的聊天室。可用于创建命名的聊天室,或在 Import mode
中创建群聊。不支持按主题分组的聊天室。如需查看示例,请参阅创建聊天室。
如果您在创建聊天室时收到 ALREADY_EXISTS
错误消息,请尝试改用其他 displayName
。Google Workspace 组织中可能已经有聊天室在使用此显示名称。
支持以下类型的身份验证:
以应用身份进行身份验证时,必须在请求中设置 space.customer
字段。
HTTP 请求
POST https://chat.googleapis.com/v1/spaces
网址采用 gRPC 转码语法。
查询参数
参数 | |
---|---|
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
有关详情,请参阅授权指南。