REST Resource: properties.reportTasks

{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}

string

Solo output. Identificatore. Il nome della risorsa dell'attività di report assegnato durante la creazione. Formato: "properties/{property}/reportTasks/{reportTask}"

object (ReportDefinition)

(Facoltativo) Una definizione di report per recuperare i dati del report, che descrive la struttura di un report. In genere, include i campi che verranno inclusi nel report e i criteri che verranno utilizzati per filtrare i dati.

object (ReportMetadata)

Solo output. I metadati del report per una specifica attività di report, che forniscono informazioni su un report. In genere include le seguenti informazioni: nome risorsa del report, stato del report, timestamp in cui è stato creato il report e così via.

{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean
}

object (Dimension)

(Facoltativo) Le dimensioni richieste e visualizzate.

object (Metric)

(Facoltativo) Le metriche richieste e visualizzate.

object (DateRange)

(Facoltativo) Intervalli di date dei dati da leggere. Se sono richiesti più intervalli di date, ogni riga di risposta conterrà un indice di intervallo di date basato su zero. Se due intervalli di date si sovrappongono, i dati sugli eventi per i giorni che si sovrappongono vengono inclusi nelle righe di risposta per entrambi gli intervalli di date. In una richiesta di coorte, questo dateRanges non deve essere specificato.

object (FilterExpression)

(Facoltativo) I filtri delle dimensioni ti consentono di richiedere solo valori di dimensione specifici nel report. Per ulteriori informazioni, consulta la sezione Concetti fondamentali dei filtri delle dimensioni per alcuni esempi. Le metriche non possono essere utilizzate in questo filtro.

object (FilterExpression)

(Facoltativo) La clausola di filtro delle metriche. Applicato dopo aver aggregato le righe del report, in modo simile alla clausola SQL. Le dimensioni non possono essere utilizzate in questo filtro.

string (int64 format)

(Facoltativo) Il conteggio delle righe della riga iniziale dello spazio di archiviazione di Google Analytics. La prima riga viene conteggiata come riga 0.

Quando crei un'attività per il report, i parametri offset e limit definiscono il sottoinsieme di righe di dati dello spazio di archiviazione di Google Analytics da includere nel report generato. Ad esempio, se lo spazio di archiviazione di Google Analytics contiene un totale di 300.000 righe, l'attività di report iniziale potrebbe includere le prime 10.000 righe con un limite di 10.000 e un offset pari a 0. Successivamente, un'altra attività di report potrebbe coprire le successive 10.000 righe con un limite di 10.000 e un offset di 10.000.

string (int64 format)

(Facoltativo) Il numero di righe da restituire nel report. 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. limit deve essere positivo.

L'API può anche restituire meno righe rispetto al valore limit richiesto, se il numero di valori di dimensione è inferiore a quello di limit. Ad esempio, esistono meno di 300 valori possibili per la dimensione country. Di conseguenza, quando generi report solo su country, non puoi ottenere più di 300 righe, anche se imposti limit su un valore più alto.

enum (MetricAggregation)

(Facoltativo) Aggregazione delle metriche. I valori aggregati delle metriche verranno mostrati nelle righe in cui i valori di dimensionValue sono impostati su "RESERVED_(MetricAggregation)".

object (OrderBy)

(Facoltativo) Specifica l'ordine delle righe nella risposta.

string

(Facoltativo) Un codice valuta in formato ISO4217, ad esempio "AED", "USD", "JPY". Se il campo è vuoto, il report utilizza la valuta predefinita della proprietà.

object (CohortSpec)

(Facoltativo) Gruppo di coorti associato a questa richiesta. Se nella richiesta è presente un gruppo di coorte, la "coorte" deve essere presente.

boolean

(Facoltativo) Se il valore è false o non specificato, non verrà restituita ogni riga con tutte le metriche uguali a 0. Se impostato su true, queste righe vengono restituite se non vengono rimosse separatamente da un filtro.

Indipendentemente da questa impostazione di keepEmptyRows, in un report possono essere visualizzati solo i dati registrati dalla proprietà Google Analytics (GA4).

Ad esempio, se una proprietà non registra mai un evento purchase, una query per la dimensione eventName e la metrica eventCount non avrà una riga contenente eventName: "purchase" e eventCount: 0.

{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}

string

Il nome della dimensione. Consulta la pagina Dimensioni API per l'elenco dei nomi delle dimensioni supportati dai principali metodi di generazione dei report, come runReport e batchRunReports. Consulta Dimensioni in tempo reale per l'elenco dei nomi delle dimensioni supportati dal metodo runRealtimeReport. Consulta Dimensioni canalizzazione per l'elenco dei nomi delle dimensioni supportati dal metodo runFunnelReport.

Se dimensionExpression viene specificato, name può essere qualsiasi stringa tu voglia all'interno del set di caratteri consentito. Ad esempio, se un elemento dimensionExpression concatena country e city, puoi chiamare questa dimensione countryAndCity. I nomi delle dimensioni scelti devono corrispondere all'espressione regolare ^[a-zA-Z0-9_]$.

name fa riferimento alle dimensioni in dimensionFilter, orderBys, dimensionExpression e pivots.

object (DimensionExpression)

Una dimensione può essere il risultato di un'espressione di più dimensioni. Ad esempio, la dimensione "paese, città": concatenate(paese, ", ", città).

{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}

object (CaseExpression)

Utilizzato per convertire un valore di dimensione in minuscolo.

object (CaseExpression)

Utilizzato per convertire un valore di dimensione in lettere maiuscole.

object (ConcatenateExpression)

Utilizzato per combinare i valori delle dimensioni in una singola dimensione. Ad esempio, la dimensione "paese, città": concatenate(paese, ", ", città).

{
  "dimensionName": string
}

string

Nome di una dimensione. Il nome deve fare riferimento a un nome nel campo delle dimensioni della richiesta.

{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}

string

Nomi delle dimensioni. I nomi devono fare riferimento ai nomi nel campo delle dimensioni della richiesta.

string

Il delimitatore posizionato tra i nomi delle dimensioni.

I delimitatori sono spesso caratteri singoli, come "|" o "," ma possono essere stringhe più lunghe. Se il valore di una dimensione contiene il delimitatore, entrambi saranno presenti in risposta senza alcuna distinzione. Ad esempio,se il valore della dimensione 1 = "US,FR", il valore della dimensione 2 = "JP" e il delimitatore = ",", la risposta conterrà "US,FR,JP".

{
  "name": string,
  "expression": string,
  "invisible": boolean
}

string

Il nome della metrica. Consulta Metriche API per un elenco dei nomi delle metriche supportati dai principali metodi di generazione dei report, come runReport e batchRunReports. Consulta Metriche in tempo reale per l'elenco dei nomi delle metriche supportati dal metodo runRealtimeReport. Consulta Metriche della canalizzazione per l'elenco dei nomi delle metriche supportati dal metodo runFunnelReport.

Se expression viene specificato, name può essere qualsiasi stringa tu voglia all'interno del set di caratteri consentito. Ad esempio, se expression è screenPageViews/sessions, puoi chiamare questa metrica per il nome = viewsPerSession. I nomi delle metriche scelti devono corrispondere all'espressione regolare ^[a-zA-Z0-9_]$.

Le metriche fanno riferimento da name in metricFilter, orderBys e nella metrica expression.

string

Un'espressione matematica per le metriche derivate. Ad esempio, la metrica Conteggio eventi per utente è eventCount/totalUsers.

boolean

Indica se una metrica è invisibile nella risposta del report. Se una metrica non è visibile, non genera una colonna nella risposta, ma può essere utilizzata in metricFilter, orderBys o in una metrica expression.

{
  "startDate": string,
  "endDate": string,
  "name": string
}

string

La data di inizio inclusa per la query nel formato YYYY-MM-DD. Non può essere successiva a endDate. È accettato anche il formato NdaysAgo, yesterday o today; in questo caso, la data viene dedotta in base al fuso orario dei report della proprietà.

string

La data di fine inclusa per la query nel formato YYYY-MM-DD. Non può essere precedente al giorno startDate. È accettato anche il formato NdaysAgo, yesterday o today; in questo caso, la data viene dedotta in base al fuso orario dei report della proprietà.

string

Assegna un nome a questo intervallo di date. Questo nome viene assegnato alla dimensione dateRange in una risposta a un report. Se impostato, non può iniziare con date_range_ o RESERVED_. Se non viene configurato, gli intervalli di date vengono denominati in base al relativo indice con base zero nella richiesta: date_range_0, date_range_1 e così via.

{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}

object (FilterExpressionList)

Le espressioni filtro in andGroup hanno una relazione AND.

object (FilterExpressionList)

Le espressioni filtro in orGroup hanno una relazione OR.

object (FilterExpression)

Filtro Expression NON è di notExpression.

object (Filter)

Un filtro primitivo. Nella stessa espressione di filtro, tutti i nomi dei campi del filtro devono essere relativi a tutte le dimensioni o a tutte le metriche.

{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}

object (FilterExpression)

Un elenco di espressioni di filtro.

{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}

string

Il nome della dimensione o della metrica. Deve essere un nome definito nelle dimensioni o nelle metriche.

object (StringFilter)

Filtro correlato alle stringhe.

object (InListFilter)

Un filtro per i valori nell'elenco.

object (NumericFilter)

Un filtro per i valori numerici o relativi alle date.

object (BetweenFilter)

Un filtro per tra due valori.

{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}

enum (MatchType)

Il tipo di corrispondenza per questo filtro.

string

Il valore della stringa utilizzato per la corrispondenza.

boolean

Se true, il valore della stringa è sensibile alle maiuscole.

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

L'elenco di valori stringa. Il campo non può essere vuoto.

boolean

Se true, il valore della stringa è sensibile alle maiuscole.

{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}

enum (Operation)

Il tipo di operazione per questo filtro.

object (NumericValue)

Un valore numerico o un valore di data.

{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}

string (int64 format)

Valore Integer

number

Valore doppio

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

Inizia con questo numero.

object (NumericValue)

Termina con questo numero.

{
  "desc": boolean,

  // Union field one_order_by can be only one of the following:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of list of possible types for union field one_order_by.
}

boolean

Se true, ordina i dati in ordine decrescente.

object (MetricOrderBy)

Ordina i risultati in base ai valori di una metrica.

object (DimensionOrderBy)

Ordina i risultati in base ai valori di una dimensione.

{
  "metricName": string
}

string

Il nome di una metrica nella richiesta in base a cui ordinare.

{
  "dimensionName": string,
  "orderType": enum (OrderType)
}

string

Un nome di dimensione nella richiesta in base a cui ordinare.

enum (OrderType)

Controlla la regola per l'ordinamento dei valori delle dimensioni.

{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}

object (Cohort)

Definisce i criteri di selezione per raggruppare gli utenti in coorti.

La maggior parte dei report sulle coorti definisce una sola coorte. Se vengono specificate più coorti, ciascuna può essere riconosciuta nel report con il proprio nome.

object (CohortsRange)

I report sulle coorti seguono le coorti per un intervallo di date del report esteso. Questo intervallo specifica una durata dell'offset da seguire per le coorti.

object (CohortReportSettings)

Impostazioni facoltative per un report sulle coorti.

{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}

string

Assegna un nome a questa coorte. Questo nome viene assegnato alla dimensione cohort in una risposta a un report. Se impostato, non può iniziare con cohort_ o RESERVED_. Se non viene impostato, le coorti vengono chiamate in base al loro indice su base zero cohort_0, cohort_1 e così via.

string

Dimensione utilizzata dalla coorte. Obbligatorio e supporta solo firstSessionDate.

object (DateRange)

La coorte seleziona gli utenti la cui data del primo contatto è compresa tra la data di inizio e quella di fine definite in dateRange. Questo dateRange non specifica l'intervallo di date completo dei dati sugli eventi presenti in un report sulle coorti. In un report sulle coorti, questo valore di dateRange è esteso dalla granularità e dall'offset presenti nel cohortsRange; i dati sugli eventi per l'intervallo di date del report esteso sono presenti in un report sulle coorti.

In una richiesta di coorte, questo valore dateRange è obbligatorio e il valore dateRanges in RunReportRequest o RunPivotReportRequest non deve essere specificato.

Questo dateRange deve generalmente essere in linea con la granularità della coorte. Se CohortsRange utilizza una granularità giornaliera, il valore di dateRange può essere un solo giorno. Se CohortsRange utilizza una granularità settimanale, questo dateRange può essere allineato a una settimana, da domenica a sabato. Se CohortsRange utilizza una granularità mensile, questo dateRange può essere allineato a un mese, iniziando dal primo fino all'ultimo giorno del mese.

{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}

enum (Granularity)

Obbligatorio. La granularità utilizzata per interpretare i valori startOffset e endOffset per l'intervallo di date del report esteso per un report sulle coorti.

integer

startOffset specifica la data di inizio dell'intervallo di date del report esteso per un report sulle coorti. Il valore startOffset viene generalmente impostato su 0 per far sì che i report contengano i dati relativi all'acquisizione della coorte in poi.

Se granularity è DAILY, il startDate dell'intervallo di date esteso del report è startDate della coorte più startOffset giorni.

Se granularity è WEEKLY, il startDate dell'intervallo di date esteso del report è startDate della coorte più startOffset * 7 giorni.

Se granularity è MONTHLY, il startDate dell'intervallo di date esteso del report è startDate della coorte più startOffset * 30 giorni.

integer

Obbligatorio. endOffset specifica la data di fine dell'intervallo di date del report esteso per un report sulle coorti. endOffset può essere qualsiasi numero intero positivo, ma di solito è impostato da 5 a 10 in modo che i report contengano dati sulla coorte per i successivi periodi di tempo con granularità.

Se granularity è DAILY, il endDate dell'intervallo di date esteso del report è endDate della coorte più endOffset giorni.

Se granularity è WEEKLY, il endDate dell'intervallo di date esteso del report è endDate della coorte più endOffset * 7 giorni.

Se granularity è MONTHLY, il endDate dell'intervallo di date esteso del report è endDate della coorte più endOffset * 30 giorni.

{
  "accumulate": boolean
}

boolean

Se impostato su true, accumula il risultato dal giorno del primo contatto al giorno di fine. Non supportata nel seguente paese: RunReportRequest.

{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}

integer

Solo output. I token di quota totali addebitati durante la creazione del report. Poiché questo conteggio dei token si basa sull'attività nello stato CREATING, l'addebito dei token verrà risolto una volta che un'attività di report entra nello stato ACTIVE o FAILED.

enum (State)

Solo output. Stato attuale di questa attività di report.

string (Timestamp format)

Solo output. L'ora in cui è stato chiamato reportTasks.create e in cui il report ha iniziato lo stato CREATING.

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

integer

Solo output. Il numero totale di righe nel risultato del report. Questo campo verrà compilato quando lo stato sarà attivo. Puoi utilizzare taskRowCount per l'impaginazione entro i confini del report esistente.

string

Solo output. Il messaggio di errore viene compilato se un'attività di report non riesce durante la creazione.

integer

Solo output. Il numero totale di righe nello spazio di archiviazione di Google Analytics. Se vuoi eseguire query su righe di dati aggiuntive oltre a quelle del report corrente, è possibile avviare una nuova attività relativa al report in base all'totalRowCount.

taskRowCount rappresenta il numero di righe specifiche del report corrente, mentre totalRowCount include il conteggio totale delle righe per tutti i dati recuperati dallo spazio di archiviazione di Google Analytics.

Ad esempio, supponiamo che il valore taskRowCount del report corrente sia 20 e mostra i dati delle prime 20 righe. Allo stesso tempo, il valore totalRowCount è 30 e indica la presenza di dati per tutte e 30 le righe. taskRowCount può essere utilizzato per impaginare le 20 righe iniziali. Per espandere il report e includere i dati di tutte le 30 righe, puoi creare una nuova attività di report utilizzando totalRowCount per accedere all'insieme completo di 30 righe quantità di dati.