Prova il server MCP per Google Analytics. Installa da
GitHub e consulta l'
annuncio per maggiori dettagli.
Method: properties.recurringAudienceLists.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 ricorrenti per una proprietà. Questo metodo può essere utilizzato per trovare e riutilizzare gli elenchi dei segmenti di pubblico ricorrenti esistenti anziché creare nuovi elenchi dei segmenti di pubblico ricorrenti non necessari. Lo stesso segmento di pubblico può avere più elenchi di segmenti di pubblico ricorrenti che rappresentano combinazioni diverse di dimensioni, ad esempio solo la dimensione deviceId o entrambe le dimensioni deviceId e userId.
Questo metodo è stato introdotto nella fase di stabilità alfa allo scopo di raccogliere feedback sulla sintassi e sulle funzionalità prima del passaggio alla versione beta. 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/*}/recurringAudienceLists
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Obbligatorio. Nella risposta verranno elencati tutti gli elenchi dei segmenti di pubblico ricorrenti per questa proprietà. Formato: properties/{property}
|
Parametri di query
| Parametri |
pageSize |
integer
Facoltativo. Il numero massimo di elenchi dei segmenti di pubblico ricorrenti da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, verranno restituiti al massimo 200 elenchi dei segmenti di pubblico ricorrenti. Il valore massimo è 1000 (i valori superiori verranno forzati al massimo).
|
pageToken |
string
Facoltativo. Un token di pagina ricevuto da una chiamata recurringAudienceLists.list precedente. Fornisci questo valore per recuperare la pagina successiva. Quando viene applicata la paginazione, tutti gli altri parametri forniti a recurringAudienceLists.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 ricorrenti per una proprietà.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"recurringAudienceLists": [
{
object (RecurringAudienceList)
}
],
"nextPageToken": string
} |
| Campi |
recurringAudienceLists[] |
object (RecurringAudienceList)
Ogni elenco dei segmenti di pubblico ricorrenti 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 recurring audience lists for a given Google Analytics property, allowing for reuse of existing lists.\u003c/p\u003e\n"],["\u003cp\u003eEnables finding audience lists with different dimension combinations (e.g., deviceId, userId).\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large numbers of recurring audience lists.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eCurrently in alpha, with a feedback form available for user input.\u003c/p\u003e\n"]]],["This document details how to list recurring audience lists for a property using the Google Analytics Audience Export API. The API uses a `GET` request to a specified URL with the property ID as a path parameter. Optional query parameters (`pageSize`, `pageToken`) manage pagination. The request body is empty. The response is a JSON object containing an array of recurring audience lists and a `nextPageToken` for further pagination, if required. Authorization requires specific OAuth scopes.\n"],null,["# Method: properties.recurringAudienceLists.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.ListRecurringAudienceListsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all recurring audience lists for a property. This method can be used for you to find and reuse existing recurring audience lists rather than creating unnecessary new recurring audience lists. The same audience can have multiple recurring audience lists that represent different dimension combinations; for example, just the dimension `deviceId` or both the dimensions `deviceId` and `userId`.\n\nThis method is introduced at alpha stability with the intention of gathering feedback on syntax and capabilities before entering beta. 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/*}/recurringAudienceLists`\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 recurring 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 recurring audience lists to return. The service may return fewer than this value. If unspecified, at most 200 recurring 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 `recurringAudienceLists.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `recurringAudienceLists.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 recurring audience lists for a property.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"recurringAudienceLists\": [ { object (/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `recurring``Audience``Lists[]` | `object (`[RecurringAudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList)`)` Each recurring 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`"]]
