Method: accounts.list
傳回呼叫端可存取的所有帳戶。
請注意,這些帳戶目前可能沒有 GA 資源。根據預設,系統會排除已軟刪除 (即「已刪除」) 的帳戶。如果找不到相關帳戶,則會傳回空白清單。
HTTP 要求
GET https://analyticsadmin.googleapis.com/v1beta/accounts
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 |
pageSize |
integer
要傳回的資源數量上限。即使有其他頁面,服務傳回的產品數量可能會少於這個值。如未指定,系統會傳回最多 50 項資源。許可的最大值為 200;超出的數值將一律指定為 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
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-01-14 (世界標準時間)。
[null,null,["上次更新時間:2025-01-14 (世界標準時間)。"],[[["Retrieves all Google Analytics 4 accounts accessible by the authenticated user, including pagination options."],["Allows filtering to include or exclude soft-deleted accounts."],["Returns an empty list if no matching accounts are found."],["Requires specific authorization scopes for data access."],["Provides details on the HTTP request, query parameters, and response structure."]]],["This document details how to retrieve a list of accessible accounts using the Analytics Admin API. The core action is sending a `GET` request to the specified URL. Optional query parameters, `pageSize` and `pageToken`, enable pagination. The `showDeleted` parameter allows inclusion of soft-deleted accounts. The request body must be empty. A successful response returns a JSON object containing an array of `accounts` and a `nextPageToken` for subsequent pages. Authorization requires specific OAuth scopes.\n"]]