Questa pagina è stata tradotta dall'API Cloud Translation.

Method: properties.runPivotReport

Richiesta HTTP
Parametri del percorso
Corpo della richiesta
- Rappresentazione JSON
Corpo della risposta
Ambiti di autorizzazione
Prova!

Restituisce un report pivot personalizzato dei dati sugli eventi di Google Analytics. I report pivot sono formati più avanzati ed espressivi rispetto ai report standard. 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/v1beta/{property=properties/*}:runPivotReport

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri

Parametri
`property`	`string` Un identificatore della proprietà Google Analytics di cui vengono monitorati gli eventi. Specificato nel percorso dell'URL e non nel corpo. Per scoprire di più, consulta dove trovare l'ID proprietà. All'interno di una richiesta batch, questa proprietà deve essere non specificata o coerente con la proprietà a livello di batch. Esempio: properties/1234

property

string

Un identificatore della proprietà Google Analytics di cui vengono monitorati gli eventi. Specificato nel percorso dell'URL e non nel corpo. Per scoprire di più, consulta dove trovare l'ID proprietà. All'interno di una richiesta batch, questa proprietà deve essere non specificata o coerente con la proprietà a livello di batch.

Esempio: properties/1234

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON

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

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

Campi
`dimensions[]`	`object (Dimension)` Le dimensioni richieste. Tutte le dimensioni definite devono essere utilizzate da uno dei seguenti elementi: dimensionExpression, 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 elementi: metric_expression, metricFilter, orderBys.
`dateRanges[]`	`object (DateRange)` L'intervallo di date per 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. Nei nomi di campo di un pivot è possibile includere una dimensione speciale con il nome di campo "dateRange". Se è inclusa, il report esegue un confronto tra gli intervalli di date. In una richiesta di coorte, questo `dateRanges` deve essere non specificato.
`pivots[]`	`object (Pivot)` Descrive il formato visivo delle dimensioni del report in colonne o righe. L'unione dei nomi di campo (nomi delle dimensioni) in tutti i pivot deve essere un sottoinsieme dei nomi delle dimensioni definiti in Dimensioni. Nessuno dei due pivot può condividere una dimensione. Una dimensione è visibile solo se viene visualizzata in un pivot.
`dimensionFilter`	`object (FilterExpression)` La clausola di filtro delle dimensioni. Le dimensioni devono essere richieste per essere utilizzate in questo filtro. Le metriche non possono essere utilizzate in questo filtro.
`metricFilter`	`object (FilterExpression)` La clausola di filtro delle metriche. Applicato nella fase post aggregazione, in modo simile alla clausola having di SQL. Le metriche devono essere richieste per essere utilizzate in questo filtro. Le dimensioni non possono essere utilizzate in questo filtro.
`currencyCode`	`string` Un codice valuta in formato ISO4217, ad esempio "AED", "USD", "JPY". Se il campo è vuoto, il report utilizza la valuta predefinita della proprietà.
`cohortSpec`	`object (CohortSpec)` Gruppo di coorte associato a questa richiesta. Se nella richiesta è presente un gruppo di coorti, deve essere presente la dimensione "cohort".
`keepEmptyRows`	`boolean` Se è false o non specificato, ogni riga con tutte le metriche uguali a 0 non verrà restituita. Se true, queste righe verranno restituite se non vengono rimosse separatamente da un filtro. Indipendentemente da questa impostazione `keepEmptyRows`, in un report possono essere visualizzati solo i dati registrati dalla proprietà Google Analytics. 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 eventName: "purchase" e eventCount: 0.
`returnPropertyQuota`	`boolean` Attiva/disattiva la restituzione dello stato corrente della quota di questa proprietà Google Analytics. La quota viene restituita in PropertyQuota.
`comparisons[]`	`object (Comparison)` (Facoltativo) La configurazione dei confronti richiesti e visualizzati. La richiesta richiede sia un campo di confronti sia una dimensione di confronti per ricevere una colonna di confronto nella risposta.

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