- Richiesta HTTP
- Parametri percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Esporta un elenco del segmento di pubblico di utenti in un foglio Google. Dopo aver creato un segmento di pubblico, gli utenti non sono immediatamente disponibili per la scheda. Innanzitutto, è necessaria una richiesta a audienceLists.create
per creare un elenco del segmento di pubblico di utenti, dopodiché viene utilizzato questo metodo per esportare questi utenti dall'elenco del segmento di pubblico in un foglio Google.
Consulta la sezione Creazione di un elenco del segmento di pubblico per un'introduzione agli elenchi dei segmenti di pubblico con esempi.
I segmenti di pubblico in Google Analytics 4 ti consentono di segmentare gli utenti in base agli aspetti più importanti per la tua attività. Per saperne di più, consulta la pagina https://support.google.com/analytics/answer/9267572.
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 dare 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/*}:exportSheet
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
name |
Obbligatorio. 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 |
(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 Pagination. |
limit |
(Facoltativo) Il numero di righe da restituire. Se non vengono specificate, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente da quante sono le richieste. L'API può anche restituire meno righe rispetto al valore Per scoprire di più su questo parametro di impaginazione, consulta Pagination. |
Corpo della risposta
Il foglio Google creato con l'elenco degli 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 |
---|
{
"spreadsheetUri": string,
"spreadsheetId": string,
"rowCount": integer,
"audienceList": {
object ( |
Campi | |
---|---|
spreadsheetUri |
Un URI da visitare nel browser per visualizzare il foglio Google. |
spreadsheetId |
Un ID che identifica la risorsa di Fogli Google creata. |
rowCount |
Il numero totale di righe nel risultato AudienceList. Per scoprire di più su questo parametro di impaginazione, consulta Pagination. |
audienceList |
Dati di configurazione relativi all'esportazione di AudienceList. È tornata per aiutare a interpretare l'elenco dei segmenti di pubblico nel foglio Google di questa risposta. Ad esempio, AudienceList potrebbe avere più righe di quelle presenti nel foglio Google e, in questo caso, potresti inviare un'ulteriore richiesta di esportazione del foglio con un valore |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets