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

詳情請參閱授權指南。