Essayez le serveur MCP pour Google Analytics. Installez-le depuis
GitHub et consultez l'
annonce pour en savoir plus.
Method: accountSummaries.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renvoie des récapitulatifs de tous les comptes accessibles par l'appelant.
Requête HTTP
GET https://analyticsadmin.googleapis.com/v1beta/accountSummaries
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de requête
Paramètres |
pageSize |
integer
Nombre maximal de ressources AccountSummary à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur, même si des pages supplémentaires sont disponibles. Si aucune valeur n'est spécifiée, 50 ressources au maximum sont renvoyées. La valeur maximale est 200 (les valeurs supérieures sont réduites à la valeur maximale).
|
pageToken |
string
Jeton de page reçu d'un appel accountSummaries.list précédent. Fournissez-le pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis à accountSummaries.list doivent correspondre à l'appel ayant fourni le jeton de page.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Message de réponse pour la requête RPC accountSummaries.list.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
{
"accountSummaries": [
{
object (AccountSummary )
}
],
"nextPageToken": string
} |
Champs |
accountSummaries[] |
object (AccountSummary )
Résumés des comptes pour lesquels l'appelant dispose d'un accès.
|
nextPageToken |
string
Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.
|
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
AccountSummary
Ressource virtuelle représentant une vue d'ensemble d'un compte et de toutes ses propriétés Google Analytics enfants.
Représentation JSON |
{
"name": string,
"account": string,
"displayName": string,
"propertySummaries": [
{
object (PropertySummary )
}
]
} |
Champs |
name |
string
Nom de la ressource pour ce récapitulatif de compte. Format: accountSummaries/{account_id} Exemple: "accountSummaries/1000"
|
account |
string
Nom de la ressource du compte auquel fait référence ce récapitulatif de compte Format: accounts/{account_id} Exemple: "accounts/1000"
|
displayName |
string
Nom à afficher du compte auquel fait référence ce récapitulatif.
|
propertySummaries[] |
object (PropertySummary )
Liste des récapitulatifs des comptes enfants de ce compte.
|
PropertySummary
Ressource virtuelle représentant les métadonnées d'une propriété Google Analytics.
Représentation JSON |
{
"property": string,
"displayName": string,
"propertyType": enum (PropertyType ),
"parent": string
} |
Champs |
property |
string
Nom de la ressource de la propriété référencée par ce récapitulatif de propriété Format: properties/{property_id} Exemple: "properties/1000"
|
displayName |
string
Nom à afficher de la propriété mentionnée dans ce récapitulatif.
|
propertyType |
enum (PropertyType )
Type de propriété
|
parent |
string
Nom de la ressource du parent logique de cette propriété. Remarque: Vous pouvez modifier le parent à l'aide de l'UI de déplacement de propriété. Format: accounts/{account}, properties/{property} Exemple: "accounts/100", "properties/200"
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 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\" |"]]