Method: properties.audienceLists.list

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.readonly
  • https://www.googleapis.com/auth/analytics