Prova il server MCP per Google Analytics. Installa da
GitHub e consulta l'
annuncio per maggiori dettagli.
Method: properties.audienceLists.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca tutti gli elenchi dei segmenti di pubblico per una proprietà. Questo metodo può essere utilizzato per trovare e riutilizzare gli elenchi dei segmenti di pubblico esistenti anziché creare nuovi elenchi dei segmenti di pubblico non necessari. Lo stesso segmento di pubblico può avere più elenchi che rappresentano l'elenco degli utenti che appartenevano a un segmento di pubblico in giorni diversi.
Consulta Creare un elenco del segmento di pubblico per un'introduzione agli elenchi dei segmenti di pubblico con esempi.
Questo metodo è disponibile nella versione beta stabile in audienceExports.list. Per inviare il tuo feedback su questa API, compila il modulo Feedback sull'API Audience Export di Google Analytics.
Richiesta HTTP
GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Obbligatorio. Tutti gli elenchi dei segmenti di pubblico per questa proprietà verranno elencati nella risposta. Formato: properties/{property}
|
Parametri di query
| Parametri |
pageSize |
integer
Facoltativo. Il numero massimo di elenchi dei segmenti di pubblico da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, verranno restituiti al massimo 200 elenchi dei segmenti di pubblico. Il valore massimo è 1000 (i valori superiori verranno forzati al massimo).
|
pageToken |
string
Facoltativo. Un token di pagina ricevuto da una chiamata audienceLists.list precedente. Fornisci questo valore per recuperare la pagina successiva. Quando viene applicata la paginazione, tutti gli altri parametri forniti a audienceLists.list devono corrispondere alla chiamata che ha fornito il token pagina.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Un elenco di tutti gli elenchi dei segmenti di pubblico per una proprietà.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"audienceLists": [
{
object (AudienceList)
}
],
"nextPageToken": string
} |
| Campi |
audienceLists[] |
object (AudienceList)
Ogni elenco dei segmenti di pubblico per una proprietà.
|
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
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\u003eLists all audience lists for a given Google Analytics property, allowing for reuse of existing lists.\u003c/p\u003e\n"],["\u003cp\u003eProvides pagination to handle large numbers of audience lists, with customizable page size.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access, either read-only or full Analytics access.\u003c/p\u003e\n"],["\u003cp\u003eUses a standard HTTP GET request with path and query parameters to specify the property and retrieval options.\u003c/p\u003e\n"],["\u003cp\u003eReturns a JSON response containing an array of audience lists and a token for retrieving subsequent pages.\u003c/p\u003e\n"]]],["This document outlines how to retrieve a list of audience lists for a specific property using the Google Analytics Data API. It utilizes a `GET` HTTP request to the `audienceLists` endpoint, specifying the property in the `parent` path parameter. Optional query parameters include `pageSize` to limit results and `pageToken` for pagination. The request body must be empty. Successful responses include an array of `audienceLists` and a `nextPageToken` for subsequent pages. This operation requires `analytics.readonly` or `analytics` authorization scopes.\n"],null,["# Method: properties.audienceLists.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.ListAudienceListsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all audience lists for a property. This method can be used for you to find and reuse existing audience lists rather than creating unnecessary new audience lists. The same audience can have multiple audience lists that represent the list of users that were in an audience on different days.\n\nSee [Creating an Audience List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics) for an introduction to Audience Lists with examples.\n\nThis method is available at beta stability at [audienceExports.list](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/list). To give your feedback on this API, complete the [Google Analytics Audience Export API Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.\n\n### HTTP request\n\n`GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. All audience lists for this property will be listed in the response. Format: `properties/{property}` |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `page``Size` | `integer` Optional. The maximum number of audience lists to return. The service may return fewer than this value. If unspecified, at most 200 audience lists will be returned. The maximum value is 1000 (higher values will be coerced to the maximum). |\n| `page``Token` | `string` Optional. A page token, received from a previous `audienceLists.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `audienceLists.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\nA list of all audience lists for a property.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"audienceLists\": [ { object (/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.audienceLists#AudienceList) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `audience``Lists[]` | `object (`[AudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.audienceLists#AudienceList)`)` Each audience list for a property. |\n| `next``Page``Token` | `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`"]]
