Method: accounts.list

列出已驗證使用者的所有帳戶。包括使用者擁有的所有帳戶，以及使用者擁有管理權限的所有帳戶。

HTTP 要求

GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
parentAccount

string

選用設定。要擷取直接存取帳戶清單的帳戶資源名稱。這個方式僅適用於「機構」和「使用者群組」。如果空白，系統會為已驗證使用者傳回 accounts.list。accounts/{account_id}.
pageSize

integer

選用設定。每頁要擷取的帳戶數量。預設值為 20。
pageToken

string

選用設定。指定後，系統會擷取帳戶的下一頁。如果呼叫 accounts.list 傳回的結果超過要求的頁面大小，就會傳回 pageToken。
filter

string

選用設定。篩選器會限制要傳回的帳戶。回應只會包含符合篩選條件的項目。如果 filter 空白，系統就不會套用任何限制條件，且會為要求的帳戶擷取所有帳戶 (分頁)。

舉例來說，含有 type=USER_GROUP 篩選器的要求只會傳回使用者群組。

type 欄位是唯一支援的篩選器。

要求主體

要求主體必須為空白。

回應主體

Account.ListAccounts 的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "accounts": [
    {
      object (Account)
    }
  ],
  "nextPageToken": string
}
欄位
accounts[]

object (Account)

使用者有權存取的帳戶集合。除非已篩除，否則執行查詢者的個人帳戶一律是搜尋結果的第一個項目。
nextPageToken

string

如果帳戶數量超過請求的頁面大小，系統會在這個欄位填入權杖，以便在後續呼叫 accounts.list 時擷取下一個帳戶。如果沒有更多帳戶，回應中就不會出現這個欄位。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/business.manage

詳情請參閱 OAuth 2.0 總覽。