REST Resource: properties.audienceExports

Risorsa: AudienceExport

Un'esportazione dei segmenti di pubblico è un elenco degli utenti di un segmento di pubblico al momento della creazione dell'elenco. Un segmento di pubblico potrebbe avere più esportazioni dei segmenti di pubblico create per giorni diversi.

Rappresentazione JSON
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number
}
Campi
name

string

Solo output. Identificatore. Il nome della risorsa di esportazione dei segmenti di pubblico assegnato durante la creazione. Il nome di questa risorsa identifica questo AudienceExport.

Formato: properties/{property}/audienceExports/{audienceExport}

audience

string

Obbligatoria. Il nome della risorsa pubblico. Questo nome risorsa identifica il segmento di pubblico elencato ed è condiviso tra le API Analytics e di dati di Analytics.

Formato: properties/{property}/audiences/{audience}

audienceDisplayName

string

Solo output. Il nome visualizzato descrittivo per questo segmento di pubblico. Ad esempio, "Acquirenti".

dimensions[]

object (AudienceDimension)

Obbligatoria. Le dimensioni richieste e visualizzate nella risposta alla query.

creationQuotaTokensCharged

integer

Solo output. Il totale dei token di quota addebitati durante la creazione di AudienceExport. Poiché questo conteggio dei token si basa sull'attività dello stato CREATING, i token addebitati verranno corretti una volta che AudienceExport entrerà nello stato ACTIVE o FAILED.

state

enum (State)

Solo output. Lo stato attuale di AudienceExport.

beginCreatingTime

string (Timestamp format)

Solo output. La data e l'ora in cui è stata chiamata la richiesta di audienceExports.create e allo stato CREATING di AudienceExport.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

rowCount

integer

Solo output. Il numero totale di righe nel risultato AudienceExport.

errorMessage

string

Solo output. Il messaggio di errore viene visualizzato quando un'esportazione del segmento di pubblico non va a buon fine durante la creazione. Un motivo comune di questo errore è l'esaurimento della quota.

percentageCompleted

number

Solo output. La percentuale completata per l'esportazione di questo segmento di pubblico compresa tra 0 e 100.

AudienceDimension

Una dimensione Pubblico è un attributo utente. Gli utenti specifici attribuiti vengono richiesti e poi restituiti in un secondo momento nel QueryAudienceExportResponse.

Rappresentazione JSON
{
  "dimensionName": string
}
Campi
dimensionName

string

Campo facoltativo. Il nome API della dimensione. Consulta Dimensioni API per l'elenco dei nomi delle dimensioni.

Stato

AudienceExport attualmente esiste in questo stato.

Enum
STATE_UNSPECIFIED Lo stato non specificato non verrà mai utilizzato.
CREATING AudienceExport è in fase di creazione e sarà disponibile in futuro. La creazione avviene immediatamente dopo la chiamata audienceExports.create.
ACTIVE AudienceExport è stata creata ed è pronta per l'esecuzione di query. Un elemento AudienceExport viene aggiornato in modo da essere attivo in modo asincrono da una richiesta; ciò si verifica un po' di tempo (ad esempio 15 minuti) dopo la chiamata di creazione iniziale.
FAILED Impossibile creare AudienceExport. È possibile che la richiesta di una nuova esportazione dei segmenti di pubblico vada a buon fine.

Metodi

create

Crea un'esportazione dei segmenti di pubblico da recuperare in un secondo momento.

get

Recupera i metadati di configurazione relativi all'esportazione di un segmento di pubblico specifico.

list

Elenca tutte le esportazioni dei segmenti di pubblico per una proprietà.

query

Recupera un'esportazione dei segmenti di pubblico degli utenti.