REST Resource: properties.audienceLists

Risorsa: AudienceList

Un elenco del segmento di pubblico è l'elenco degli utenti presenti in un segmento di pubblico al momento della creazione dell'elenco. Un segmento di pubblico potrebbe avere più elenchi dei segmenti di pubblico creati 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,
  "recurringAudienceList": string
}
Campi
name

string

Solo output. Identificatore. Il nome della risorsa dell'elenco del segmento di pubblico assegnato durante la creazione. Il nome di questa risorsa identifica questo AudienceList.

Formato: properties/{property}/audienceLists/{audienceList}
audience

string

Obbligatorio. Il nome della risorsa di pubblico. Questo nome risorsa identifica il segmento di pubblico elencato ed è condiviso tra le API di amministrazione 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)

Obbligatorio. Le dimensioni richieste e visualizzate nella risposta alla query.
creationQuotaTokensCharged

integer

Solo output. I token di quota totale addebitati durante la creazione di AudienceList. Poiché questo conteggio dei token si basa sull'attività dello stato CREATING, questo addebito verrà risolto quando un elenco di segmenti di pubblico entrerà negli stati ACTIVE o FAILED.
state

enum (State)

Solo output. Lo stato attuale di questo elenco di segmenti di pubblico.
beginCreatingTime

string (Timestamp format)

Solo output. La data e l'ora in cui AudienceLists.create è stata chiamata e ha iniziato lo stato CREATING.

Un timestamp in formato "Zulu" UTC RFC3339, 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 AudienceList.
errorMessage

string

Solo output. Il messaggio di errore viene compilato quando un elenco 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.
recurringAudienceList

string

Solo output. L'elenco del segmento di pubblico ricorrente che ha creato questo elenco. Gli elenchi dei segmenti di pubblico ricorrenti li creano quotidianamente.

Se vengono creati direttamente, gli elenchi dei segmenti di pubblico non saranno associati a un elenco del segmento di pubblico ricorrente e questo campo rimarrà vuoto.

Stato

Al momento, AudienceList esiste in questo stato.

Enum
STATE_UNSPECIFIED Lo stato non specificato non verrà mai utilizzato.
CREATING Al momento, AudienceList è in fase di creazione e sarà disponibile in futuro. La creazione avviene immediatamente dopo la chiamata audienceLists.create.
ACTIVE AudienceList è stato creato completamente ed è pronto per l'esecuzione di query. Un elenco di segmenti di pubblico viene aggiornato in modo che si attivi in modo asincrono da una richiesta. Questo avviene un po' di tempo (ad esempio 15 minuti) dopo la chiamata di creazione iniziale.
FAILED Impossibile creare l'elenco di segmenti di pubblico. È possibile che la richiesta di questo elenco del segmento di pubblico vada a buon fine.

Metodi

create

 Crea un elenco del segmento di pubblico da recuperare in un secondo momento.

exportSheet

 Esporta un elenco del segmento di pubblico di utenti in un foglio Google.

get

 Recupera i metadati di configurazione relativi a un elenco del segmento di pubblico specifico.

list

 Elenca tutti gli elenchi dei segmenti di pubblico di una proprietà.

query

 Recupera un elenco del segmento di pubblico di utenti.