Prova il server MCP per Google Analytics. Installa da
GitHub e consulta l'
annuncio per maggiori dettagli.
Method: properties.keyEvents.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Restituisce un elenco di eventi chiave nella proprietà principale specificata. Restituisce un elenco vuoto se non vengono trovati eventi chiave.
Richiesta HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/keyEvents
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Obbligatorio. Il nome della risorsa della proprietà principale. Esempio: "properties/123"
|
Parametri di query
| Parametri |
pageSize |
integer
Il numero massimo di risorse da restituire. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200. (i valori più alti verranno forzati al valore massimo)
|
pageToken |
string
Un token di pagina, ricevuto da una precedente chiamata a keyEvents.list. Forniscilo per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a keyEvents.list devono corrispondere alla chiamata che ha fornito il token della pagina.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio di risposta per RPC keyEvents.list.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"keyEvents": [
{
object (KeyEvent)
}
],
"nextPageToken": string
} |
| Campi |
keyEvents[] |
object (KeyEvent)
Gli eventi chiave richiesti
|
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
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\u003eRetrieves a list of Key Events, which are significant changes or occurrences within a Google Analytics property.\u003c/p\u003e\n"],["\u003cp\u003eAllows for filtering by parent property and pagination to manage large result sets.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access, including read-only or edit permissions for Google Analytics data.\u003c/p\u003e\n"],["\u003cp\u003eProvides details about the HTTP request structure, including path and query parameters, for interacting with the API.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of Key Events and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of Key Events associated with a specific property. A `GET` request to the provided URL, including the property's ID in the `parent` path parameter, is used. Optional `pageSize` and `pageToken` query parameters facilitate pagination. The request body must be empty. The response, formatted as JSON, contains an array of `keyEvents` and an optional `nextPageToken` for subsequent pages. It requires specific OAuth authorization scopes.\n"],null,["# Method: properties.keyEvents.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListKeyEventsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns a list of Key Events in the specified parent property. Returns an empty list if no Key Events are found.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/keyEvents`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The resource name of the parent property. Example: 'properties/123' |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of resources to return. 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 `keyEvents.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `keyEvents.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 keyEvents.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"keyEvents\": [ { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents#KeyEvent) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `keyEvents[]` | `object (`[KeyEvent](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents#KeyEvent)`)` The requested Key Events |\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`"]]
