列出聊天室中的成員。如需範例,請參閱「列出聊天室中的使用者和 Google Chat 應用程式」。列出具有應用程式驗證功能的成員資格,會列出 Chat 應用程式可存取的聊天室成員,但不含 Chat 應用程式成員資格 (包括其所屬聊天室)。透過使用者驗證功能列出成員資格,會列出已驗證使用者可以存取的聊天室中的成員資格。
HTTP 要求
GET https://chat.googleapis.com/v1/{parent=spaces/*}/members
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
parent |
必要欄位。要擷取成員清單的聊天室資源名稱。 格式:空格/{space} |
查詢參數
參數 | |
---|---|
pageSize |
選用設定。要傳回的成員資格數量上限。服務傳回的產品數量可能會少於這個值。 如未指定,最多會傳回 100 個成員資格。 最大值是 1000。如果您使用的值超過 1000,系統會自動變更為 1000。 負值會傳回 |
pageToken |
選用設定。來自先前的呼叫,用來列出成員資格的網頁權杖。提供這個參數即可擷取後續網頁。 進行分頁時,提供的所有其他參數應與提供網頁權杖的呼叫相符。如果將不同的值傳遞給其他參數,可能會導致非預期的結果。 |
filter |
選用設定。查詢篩選器。 您可以按照成員的角色 ( 如要依角色篩選,請將 如要依類型篩選,請將 如要同時依角色和類型進行篩選,請使用 當 舉例來說,以下是有效的查詢:
下列查詢無效:
伺服器拒絕無效的查詢,並顯示 |
showGroups |
選用設定。當 |
showInvited |
選用設定。如果為 目前需要使用者驗證。 |
useAdminAccess |
true 時,這個方法會使用使用者的 Google Workspace 管理員權限執行。通話使用者必須是具備管理即時通訊和聊天室對話權限的 Google Workspace 管理員。 需要 使用管理員存取權時,無法列出聊天室中的應用程式成員資格。 |
要求主體
要求主體必須為空白。
回應主體
回應清單聊天室成員。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"memberships": [
{
object ( |
欄位 | |
---|---|
memberships[] |
未排序的清單。要求 (或第一個) 頁面中的成員清單。 |
nextPageToken |
可做為 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.admin.memberships.readonly
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
詳情請參閱授權指南。