Method: spaces.get

返回聊天室的详细信息。如需示例，请参阅获取聊天室的详细信息。

支持以下类型的身份验证：

  • 应用身份验证，具有以下任一授权范围：

    • https://www.googleapis.com/auth/chat.bot
    • https://www.googleapis.com/auth/chat.app.spaces（已获得管理员批准）

  • 使用以下某个授权范围进行用户身份验证：

    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.spaces
    • 当管理员账号进行身份验证、useAdminAccess 为 true 且使用以下授权范围之一时，用户身份验证会授予管理员权限：
      • https://www.googleapis.com/auth/chat.admin.spaces.readonly
      • https://www.googleapis.com/auth/chat.admin.spaces

应用身份验证具有以下限制：

  • 仅在使用 chat.app.spaces 范围时才会填充 space.access_settings。
  • 只有在使用 chat.app.spaces 范围时，系统才会填充 space.predefind_permission_settings 和 space.permission_settings，并且仅针对应用创建的聊天室。

HTTP 请求

GET https://chat.googleapis.com/v1/{name=spaces/*}

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。聊天室的资源名称，格式为 spaces/{space}。

格式：spaces/{space}

查询参数

参数
useAdminAccess

boolean

可选。如果为 true，则该方法会使用用户的 Google Workspace 管理员权限运行。

发起通话的用户必须是拥有管理聊天和聊天室对话权限的 Google Workspace 管理员。

需要 chat.admin.spaces 或 chat.admin.spaces.readonly OAuth 2.0 范围。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 Space 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.app.spaces

如需了解详情，请参阅授权指南。