試用 Google Analytics 的 MCP 伺服器。從
GitHub 安裝,詳情請參閱
公告。
Method: accounts.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
傳回呼叫端可存取的所有帳戶。
請注意,這些帳戶目前可能沒有 GA 資源。根據預設,系統會排除已虛刪 (即「已刪除」) 的帳戶。如果找不到相關帳戶,則會傳回空白清單。
HTTP 要求
GET https://analyticsadmin.googleapis.com/v1alpha/accounts
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 |
pageSize |
integer
要傳回的資源數量上限。即使有其他頁面,服務傳回的產品數量可能會少於這個值。如未指定,最多將傳回 50 個資源。許可的最大值為 200;超出的數值將一律指定為 200
|
pageToken |
string
從先前 accounts.list 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時,提供至 accounts.list 的所有其他參數須與提供網頁權杖的呼叫相符。
|
showDeleted |
boolean
是否要在結果中納入已虛刪 (即「已刪除」) 的帳戶。您可以檢查帳戶,判斷帳戶是否已刪除。
|
回應主體
帳戶資訊列舉 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-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eRetrieves and lists all Google Analytics 4 accounts accessible by the caller, excluding soft-deleted accounts by default.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to handle large result sets using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eOptionally includes soft-deleted accounts using the \u003ccode\u003eshowDeleted\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific scopes for data access.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of accessible accounts using a `GET` request to `https://analyticsadmin.googleapis.com/v1alpha/accounts`. The request body must be empty. Optional query parameters `pageSize` (max 200) and `pageToken` support pagination, and `showDeleted` includes trashed accounts. The response includes an array of \"accounts\" and `nextPageToken` for pagination. Authorization requires either `analytics.readonly` or `analytics.edit` OAuth scopes.\n"],null,["# Method: accounts.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAccountsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns all accounts accessible by the caller.\n\nNote that these accounts might not currently have GA properties. Soft-deleted (ie: \"trashed\") accounts are excluded by default. Returns an empty list if no relevant accounts are found.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1alpha/accounts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of resources to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum) |\n| `pageToken` | `string` A page token, received from a previous `accounts.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `accounts.list` must match the call that provided the page token. |\n| `showDeleted` | `boolean` Whether to include soft-deleted (ie: \"trashed\") Accounts in the results. Accounts can be inspected to determine whether they are deleted or not. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nRequest message for accounts.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"accounts\": [ { object (/analytics/devguides/config/admin/v1/rest/v1alpha/accounts#Account) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `accounts[]` | `object (`[Account](/analytics/devguides/config/admin/v1/rest/v1alpha/accounts#Account)`)` Results that were accessible to the caller. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics.edit`"]]