Prova il server MCP per Google Analytics. Installa da
GitHub e consulta l'
annuncio per maggiori dettagli.
Method: accountSummaries.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Restituisce i riepiloghi di tutti gli account accessibili al chiamante.
Richiesta HTTP
GET https://analyticsadmin.googleapis.com/v1beta/accountSummaries
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
| Parametri |
pageSize |
integer
Il numero massimo di risorse AccountSummary da restituire. Il servizio potrebbe restituire meno di questo valore, anche se sono presenti pagine aggiuntive. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200; i valori superiori verranno forzati al massimo
|
pageToken |
string
Un token di pagina ricevuto da una chiamata accountSummaries.list precedente. Fornisci questo valore per recuperare la pagina successiva. Quando viene applicata la paginazione, tutti gli altri parametri forniti a accountSummaries.list devono corrispondere alla chiamata che ha fornito il token pagina.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio di risposta per l'RPC accountSummaries.list.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"accountSummaries": [
{
object (AccountSummary)
}
],
"nextPageToken": string
} |
| Campi |
accountSummaries[] |
object (AccountSummary)
Riepiloghi degli account a cui ha accesso chi chiama.
|
nextPageToken |
string
Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics.edit
AccountSummary
Una risorsa virtuale che rappresenta una panoramica di un account e di tutte le relative proprietà Google Analytics secondarie.
| Rappresentazione JSON |
{
"name": string,
"account": string,
"displayName": string,
"propertySummaries": [
{
object (PropertySummary)
}
]
} |
| Campi |
name |
string
Nome della risorsa per questo riepilogo dell'account. Formato: accountSummaries/{account_id} Esempio: "accountSummaries/1000"
|
account |
string
Nome della risorsa dell'account a cui fa riferimento questo riepilogo dell'account Formato: accounts/{account_id} Esempio: "accounts/1000"
|
displayName |
string
Nome visualizzato dell'account a cui si fa riferimento in questo riepilogo.
|
propertySummaries[] |
object (PropertySummary)
Elenco di riepiloghi per gli account secondari di questo account.
|
PropertySummary
Una risorsa virtuale che rappresenta i metadati di una proprietà Google Analytics.
| Rappresentazione JSON |
{
"property": string,
"displayName": string,
"propertyType": enum (PropertyType),
"parent": string
} |
| Campi |
property |
string
Nome della risorsa della proprietà a cui fa riferimento questo riepilogo della proprietà Formato: properties/{property_id} Esempio: "properties/1000"
|
displayName |
string
Nome visualizzato della proprietà a cui si fa riferimento in questo riepilogo.
|
propertyType |
enum (PropertyType)
Il tipo di proprietà.
|
parent |
string
Nome della risorsa del padre logico di questa proprietà. Nota: l'interfaccia utente per lo spostamento delle proprietà può essere utilizzata per modificare la proprietà principale. Formato: accounts/{account}, properties/{property} Esempio: "accounts/100", "properties/200"
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 2025-07-26 UTC."],[[["\u003cp\u003eThis endpoint returns summaries of all Google Analytics 4 accounts and their properties accessible by the caller.\u003c/p\u003e\n"],["\u003cp\u003eSummaries provide an overview of account details such as name, display name, and associated properties including their types and parent information.\u003c/p\u003e\n"],["\u003cp\u003eThe response can be paginated using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters for retrieving large sets of account data.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires either \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics.edit\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003eTry it!\u003c/code\u003e section to experiment with the API directly.\u003c/p\u003e\n"]]],["This document details how to retrieve summaries of Google Analytics accounts. It uses a `GET` HTTP request to `https://analyticsadmin.googleapis.com/v1beta/accountSummaries`. Optional query parameters include `pageSize` (up to 200) and `pageToken` for pagination. The request body is empty. The response contains `accountSummaries` (an array with each element being `AccountSummary`), and `nextPageToken`. Each `AccountSummary` contains account details and an array of `PropertySummary`, which includes a property's metadata. The request requires either `analytics.readonly` or `analytics.edit` 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/v1beta/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/v1beta/accountSummaries/list#AccountSummary) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accountSummaries[]` | `object (`[AccountSummary](/analytics/devguides/config/admin/v1/rest/v1beta/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/v1beta/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/v1beta/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/v1beta/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/v1beta/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\" |"]]
