- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- AudienceRow
- AudienceDimensionValue
- Prova!
Recupera un elenco del segmento di pubblico di utenti. Dopo aver creato un segmento di pubblico, gli utenti non saranno immediatamente disponibili per la scheda. Prima di tutto, una richiesta a audienceLists.create
è necessaria per creare un elenco del segmento di pubblico e, in secondo luogo, questo metodo viene utilizzato per recuperare gli utenti nell'elenco del segmento di pubblico.
Consulta la sezione Creare un elenco dei segmenti di pubblico per un'introduzione agli elenchi dei segmenti di pubblico completa di esempi.
I segmenti di pubblico in Google Analytics 4 ti consentono di suddividere gli utenti in base agli obiettivi più importanti per la tua attività. Per saperne di più, consulta la pagina https://support.google.com/analytics/answer/9267572.
Questo metodo è disponibile nella versione beta in audienceExports.query. Per inviare il tuo feedback su questa API, compila il modulo di feedback sull'API Audience Export di Google Analytics.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/audienceLists/*}:query
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
name |
Obbligatoria. Il nome dell'elenco del segmento di pubblico da cui recuperare gli utenti. Formato: |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "offset": string, "limit": string } |
Campi | |
---|---|
offset |
Campo facoltativo. Il conteggio delle righe della riga iniziale. La prima riga viene conteggiata come riga 0. Durante il paging, la prima richiesta non specifica l'offset o, equivalente, imposta l'offset su 0. La prima richiesta restituisce il primo Per scoprire di più su questo parametro di impaginazione, consulta Impaginazione. |
limit |
Campo facoltativo. Il numero di righe da restituire. Se non specificati, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente da quante ne chiedi. L'API può anche restituire meno righe rispetto al valore Per scoprire di più su questo parametro di impaginazione, consulta Impaginazione. |
Corpo della risposta
Un elenco di utenti in un elenco del segmento di pubblico.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "audienceRows": [ { object ( |
Campi | |
---|---|
audienceRows[] |
Righe per ogni utente in un elenco del segmento di pubblico. Il numero di righe in questa risposta sarà inferiore o uguale alle dimensioni della pagina della richiesta. |
audienceList |
Dati di configurazione relativi all'elenco di segmenti di pubblico sottoposto a query. Restituito per aiutarci a interpretare le righe del segmento di pubblico in questa risposta. Ad esempio, le dimensioni in questo AudienceList corrispondono alle colonne in AudienceRows. |
rowCount |
Il numero totale di righe nel risultato AudienceList. Per scoprire di più su questo parametro di impaginazione, consulta Impaginazione. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
AudienceRow
Attributi dei valori di dimensione per la riga dell'utente del segmento di pubblico.
Rappresentazione JSON |
---|
{
"dimensionValues": [
{
object ( |
Campi | |
---|---|
dimensionValues[] |
Ogni attributo del valore di dimensione per un utente del segmento di pubblico. Verrà aggiunto un valore di dimensione per ogni colonna di dimensione richiesta. |
AudienceDimensionValue
Il valore di una dimensione.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione one_value . Un tipo di valore di dimensione. one_value può essere solo uno dei seguenti: |
|
value |
Valore come stringa se il tipo di dimensione è una stringa. |