Method: runPivotReport

Restituisce un report pivot personalizzato dei dati sugli eventi di Google Analytics. I report pivot sono formati più avanzati ed espressivi rispetto ai report normali. In un report pivot, le dimensioni sono visibili solo se sono incluse in un pivot. È possibile specificare più pivot per analizzare ulteriormente i dati.

Richiesta HTTP

POST https://analyticsdata.googleapis.com/v1alpha:runPivotReport

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Campi
entity

object (Entity)

Una proprietà i cui eventi vengono monitorati. All'interno di una richiesta batch, questa entità non deve essere specificata o deve essere coerente con l'entità a livello di batch.

dimensions[]

object (Dimension)

Le dimensioni richieste. Tutte le dimensioni definite devono essere utilizzate da uno dei seguenti valori: dimensionEspressione, dimensionFilter, pivots, orderBys.

metrics[]

object (Metric)

Le metriche richieste. È necessario specificare almeno una metrica. Tutte le metriche definite devono essere utilizzate da uno dei seguenti valori: metric_expression, metricFilter, orderBys.

dimensionFilter

object (FilterExpression)

La clausola di filtro delle dimensioni. Per l'utilizzo in questo filtro è necessario richiedere le dimensioni. Impossibile utilizzare metriche in questo filtro.

metricFilter

object (FilterExpression)

La clausola di filtro delle metriche. Applicato in fase di post-aggregazione, in modo simile alla clausola SQL. L'utilizzo delle metriche in questo filtro è obbligatorio. Impossibile utilizzare le dimensioni in questo filtro.

pivots[]

object (Pivot)

Descrive il formato visivo delle dimensioni del report in colonne o righe. L'unione dei nomi dei campi (nomi delle dimensioni) in tutti i pivot deve essere un sottoinsieme di nomi delle dimensioni definiti in Dimensioni. Due pivot non possono condividere una dimensione. Una dimensione è visibile solo se compare in un pivot.

dateRanges[]

object (DateRange)

L'intervallo di date in cui recuperare i dati sugli eventi per il report. Se vengono specificati più intervalli di date, nel report vengono utilizzati i dati sugli eventi di ogni intervallo. Una dimensione speciale con nome campo "dateRange" può essere inclusa nei nomi dei campi di un pivot; se inclusa, il report confronta tra intervalli di date. In una richiesta di coorte, questo dateRanges non deve essere specificato.

currencyCode

string

Un codice valuta in formato ISO4217, ad esempio "AED", "USD", "JPY". Se il campo è vuoto, il report utilizza la valuta predefinita dell'entità.

cohortSpec

object (CohortSpec)

Gruppo di coorte associato a questa richiesta. Se la richiesta include un gruppo di coorte, deve essere presente la dimensione "coorte".

keepEmptyRows

boolean

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

returnPropertyQuota

boolean

Consente di attivare/disattivare la restituzione dello stato corrente della quota di questa proprietà Analytics. La quota viene restituita in PropertyQuota.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RunPivotReportResponse.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics