Wypróbuj serwer MCP w Google Analytics. Zainstaluj go z
GitHub. Więcej informacji znajdziesz w
ogłoszeniu.
Method: accountSummaries.list
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zwraca podsumowania wszystkich kont dostępnych dla wywołującego.
Żądanie HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/accountSummaries
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry |
pageSize |
integer
Maksymalna liczba zwracanych zasobów AccountSummary. Usługa może zwrócić mniej niż tę wartość, nawet jeśli są dodatkowe strony. Jeśli nie określisz inaczej, zwróci się maksymalnie 50 zasobów. Maksymalna wartość to 200 (wyższe wartości zostaną przymusowo ustawione na maksymalną).
|
pageToken |
string
Token strony otrzymany z poprzedniego wywołania funkcji accountSummaries.list . Podaj ten parametr, aby pobrać kolejną stronę. Podczas podziału na strony wszystkie inne parametry przekazane do funkcji accountSummaries.list muszą być zgodne z wywołaniem, które dostarczyło token strony.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Komunikat odpowiedzi na wywołanie procedury zdalnej accountSummaries.list.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
{
"accountSummaries": [
{
object (AccountSummary )
}
],
"nextPageToken": string
} |
Pola |
accountSummaries[] |
object (AccountSummary )
podsumowania wszystkich kont, do których ma dostęp dzwoniący;
|
nextPageToken |
string
token, który można wysłać jako pageToken , aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.
|
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
AccountSummary
Wirtualny zasób przedstawiający przegląd konta i wszystkich jego usług w Google Analytics.
Zapis JSON |
{
"name": string,
"account": string,
"displayName": string,
"propertySummaries": [
{
object (PropertySummary )
}
]
} |
Pola |
name |
string
Nazwa zasobu tego podsumowania konta. Format: accountSummaries/{identyfikator_konta} Przykład: „accountSummaries/1000”
|
account |
string
Nazwa zasobu konta, do którego odnosi się to podsumowanie konta. Format: accounts/{identyfikator_konta}. Przykład: „accounts/1000”.
|
displayName |
string
Wyświetlana nazwa konta, którego dotyczy to podsumowanie.
|
propertySummaries[] |
object (PropertySummary )
Lista podsumowań dotyczących kont podrzędnych tego konta.
|
PropertySummary
Wirtualny zasób reprezentujący metadane usługi w Google Analytics.
Zapis JSON |
{
"property": string,
"displayName": string,
"propertyType": enum (PropertyType ),
"parent": string
} |
Pola |
property |
string
Nazwa zasobu usługi, do której odnosi się to podsumowanie właściwości. Format: properties/{property_id} Przykład: „properties/1000”
|
displayName |
string
Wyświetlana nazwa usługi, o której mowa w tym podsumowaniu.
|
propertyType |
enum (PropertyType )
Typ nieruchomości.
|
parent |
string
Nazwa zasobu nadrzędnego tej usługi. Uwaga: do zmiany elementu nadrzędnego możesz użyć interfejsu przenoszenia usługi. Format: accounts/{account}, properties/{property} Przykład: „accounts/100”, „properties/200”
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eLists and summarizes all Google Analytics 4 (GA4) accounts and their properties accessible to the authenticated user.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to handle large numbers of accounts using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eEach account summary includes the account name, display name, and a list of associated property summaries.\u003c/p\u003e\n"],["\u003cp\u003eProvides property details such as property name, display name, type, and its parent resource.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access, including 'analytics.readonly' or 'analytics.edit'.\u003c/p\u003e\n"]]],["This document details how to retrieve summaries of accessible Google Analytics accounts via an HTTP GET request to `https://analyticsadmin.googleapis.com/v1alpha/accountSummaries`. Key actions include setting optional `pageSize` and `pageToken` query parameters for pagination. The request body is empty. The response provides a list of `accountSummaries`, each containing account details and `propertySummaries`, with the possibility of a `nextPageToken` for subsequent pages. Authorization requires specific OAuth scopes.\n"],null,["# Method: accountSummaries.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.ListAccountSummariesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [AccountSummary](#AccountSummary)\n - [JSON representation](#AccountSummary.SCHEMA_REPRESENTATION)\n- [PropertySummary](#PropertySummary)\n - [JSON representation](#PropertySummary.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nReturns summaries of all accounts accessible by the caller.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1alpha/accountSummaries`\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 AccountSummary 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 `accountSummaries.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `accountSummaries.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for accountSummaries.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"accountSummaries\": [ { object (/analytics/devguides/config/admin/v1/rest/v1alpha/accountSummaries/list#AccountSummary) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accountSummaries[]` | `object (`[AccountSummary](/analytics/devguides/config/admin/v1/rest/v1alpha/accountSummaries/list#AccountSummary)`)` Account summaries of all accounts the caller has access to. |\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`\n\nAccountSummary\n--------------\n\nA virtual resource representing an overview of an account and all its child Google Analytics properties.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"account\": string, \"displayName\": string, \"propertySummaries\": [ { object (/analytics/devguides/config/admin/v1/rest/v1alpha/accountSummaries/list#PropertySummary) } ] } ``` |\n\n| Fields ||\n|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name for this account summary. Format: accountSummaries/{account_id} Example: \"accountSummaries/1000\" |\n| `account` | `string` Resource name of account referred to by this account summary Format: accounts/{account_id} Example: \"accounts/1000\" |\n| `displayName` | `string` Display name for the account referred to in this account summary. |\n| `propertySummaries[]` | `object (`[PropertySummary](/analytics/devguides/config/admin/v1/rest/v1alpha/accountSummaries/list#PropertySummary)`)` List of summaries for child accounts of this account. |\n\nPropertySummary\n---------------\n\nA virtual resource representing metadata for a Google Analytics property.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"property\": string, \"displayName\": string, \"propertyType\": enum (/analytics/devguides/config/admin/v1/rest/v1alpha/properties#PropertyType), \"parent\": string } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `property` | `string` Resource name of property referred to by this property summary Format: properties/{property_id} Example: \"properties/1000\" |\n| `displayName` | `string` Display name for the property referred to in this property summary. |\n| `propertyType` | `enum (`[PropertyType](/analytics/devguides/config/admin/v1/rest/v1alpha/properties#PropertyType)`)` The property's property type. |\n| `parent` | `string` Resource name of this property's logical parent. Note: The Property-Moving UI can be used to change the parent. Format: accounts/{account}, properties/{property} Example: \"accounts/100\", \"properties/200\" |"]]