- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- AudienceRow
- AudienceDimensionValue
- Prova!
Recupera un'esportazione del segmento di pubblico degli utenti. Dopo aver creato un segmento di pubblico, gli utenti non sono immediatamente disponibili per l'esportazione. Innanzitutto, è necessaria una richiesta a audienceExports.create
per creare un'esportazione del segmento di pubblico degli utenti e, in secondo luogo, questo metodo viene utilizzato per recuperare gli utenti nell'esportazione del segmento di pubblico.
Consulta Creare un'esportazione dei segmenti di pubblico per un'introduzione alle esportazioni dei segmenti di pubblico con esempi.
I segmenti di pubblico in Google Analytics 4 ti permettono di suddividere gli utenti in base agli aspetti più importanti per la tua attività. Per scoprire di più, consulta https://support.google.com/analytics/answer/9267572.
Le API Audience Export hanno alcuni metodi in versione alpha e altri in versione beta. L'intenzione è di far progredire i metodi fino alla stabilità beta dopo aver raccolto feedback e averli adottati. Per inviare il tuo feedback su questa API, compila il modulo Feedback sull'API Audience Export di Google Analytics.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
name |
Obbligatorio. Il nome dell'esportazione 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 |
Facoltativo. Il conteggio delle righe della riga iniziale. La prima riga viene conteggiata come riga 0. Quando viene utilizzata la paginazione, la prima richiesta non specifica l'offset; in alternativa, imposta l'offset su 0; la prima richiesta restituisce le prime Per scoprire di più su questo parametro di paginazione, consulta la sezione Paginazione. |
limit |
Facoltativo. Il numero di righe da restituire. Se non specificato, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente da quante ne richiedi. L'API può anche restituire meno righe rispetto al Per scoprire di più su questo parametro di paginazione, consulta la sezione Paginazione. |
Corpo della risposta
Un elenco di utenti in un'esportazione del segmento di pubblico.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "audienceRows": [ { object ( |
Campi | |
---|---|
audience |
Righe per ogni utente in un'esportazione del segmento di pubblico. Il numero di righe in questa risposta sarà inferiore o uguale alle dimensioni della pagina della richiesta. |
audience |
Dati di configurazione relativi alla query di AudienceExport. Restituito per aiutare a interpretare le righe del segmento di pubblico in questa risposta. Ad esempio, le dimensioni in questo file AudienceExport corrispondono alle colonne in AudienceRows. |
row |
Il numero totale di righe nel risultato di AudienceExport. Per scoprire di più su questo parametro di paginazione, consulta la sezione Paginazione. |
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 delle dimensioni per la riga utente del segmento di pubblico.
Rappresentazione JSON |
---|
{
"dimensionValues": [
{
object ( |
Campi | |
---|---|
dimension |
Ogni attributo del valore della 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 unione one_value . Un tipo di valore della dimensione. one_value può essere solo uno dei seguenti: |
|
value |
Valore come stringa se il tipo di dimensione è una stringa. |