Method: accounts.list

傳回呼叫端可存取的所有帳戶。

請注意,這些帳戶目前可能沒有 GA4 資源。根據預設,系統會排除虛刪除的帳戶 (例如「垃圾桶」)。如果找不到相關帳戶,則傳回空白清單。

HTTP 要求

GET https://analyticsadmin.googleapis.com/v1beta/accounts

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

查詢參數

參數
pageSize

integer

要傳回的資源數量上限。即使有其他網頁,服務傳回的數量仍可能少於這個值。如未指定,最多會傳回 50 項資源。許可的最大值為 200;(系統會將較高的值轉換為最大值)

pageToken

string

屬於接收自前一個 accounts.list 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時,提供至 accounts.list 的所有其他參數須與提供網頁權杖的呼叫相符。

showDeleted

boolean

是否在結果中包含虛刪除的帳戶 (例如:「垃圾桶」)。可供檢查帳戶是否已刪除。

要求主體

要求主體必須為空白。

回應主體

accounts.list RPC 的要求訊息。

如果成功,回應主體會含有以下結構的資料:

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

object (Account)

呼叫端可查看的結果。

nextPageToken

string

可做為 pageToken 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit