- Richiesta HTTP
- Parametri percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ResponseMetaData
- SchemaRestrictionResponse
- ActiveMetricRestriction
- RestrictedMetricType
- Prova!
Recupera i contenuti di un'attività di report. Dopo aver richiesto reportTasks.create
, potrai recuperare i contenuti del report una volta che il report sarà ATTIVO. Questo metodo restituirà un errore se lo stato dell'attività di report non è ACTIVE
. Una risposta a una query restituirà la riga tabulare & valori di colonna del report.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/reportTasks/*}:query
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
name |
Obbligatorio. Il nome dell'origine del report. Formato: |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "offset": string, "limit": string } |
Campi | |
---|---|
offset |
(Facoltativo) Il conteggio delle righe della riga iniziale nel report. La prima riga viene conteggiata come riga 0. Durante il paging, la prima richiesta non specifica l'offset; o equivalente, imposta l'offset su 0; la prima richiesta restituisce il primo Per scoprire di più su questo parametro di impaginazione, consulta Pagination. |
limit |
(Facoltativo) Il numero di righe da restituire dal 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. L'API può anche restituire meno righe rispetto al valore Per scoprire di più su questo parametro di impaginazione, consulta Pagination. |
Corpo della risposta
I contenuti del report corrispondenti a un'attività di report.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "dimensionHeaders": [ { object ( |
Campi | |
---|---|
dimensionHeaders[] |
Descrive le colonne delle dimensioni. Il numero e l'ordine delle intestazioni DimensionHeaders corrispondono alle dimensioni presenti nelle righe. |
metricHeaders[] |
Descrive le colonne delle metriche. Il numero di MetricHeaders e l'ordine di MetricHeaders corrisponde alle metriche presenti nelle righe. |
rows[] |
Righe di combinazioni di valori di dimensioni e valori delle metriche nel report. |
totals[] |
Se richiesto, i valori totali delle metriche. |
maximums[] |
Se richiesto, i valori massimi delle metriche. |
minimums[] |
Se richiesto, i valori minimi delle metriche. |
rowCount |
Il numero totale di righe nel risultato della query. |
metadata |
Metadati per il report. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ResponseMetaData
Metadati della risposta con informazioni aggiuntive sui contenuti del report.
Rappresentazione JSON |
---|
{
"dataLossFromOtherRow": boolean,
"schemaRestrictionResponse": {
object ( |
Campi | |
---|---|
dataLossFromOtherRow |
Se il valore è true, indica che alcuni bucket di combinazioni di dimensioni vengono raggruppati nella categoria "(other)" riga di comando. Questo può accadere per i report ad alta cardinalità. Il parametro dei metadati dataLossFromOtherRow viene compilato in base alla tabella di dati aggregati utilizzata nel report. Il parametro verrà compilato con precisione indipendentemente dai filtri e dai limiti del report. Ad esempio, la riga (other) potrebbe essere eliminata dal report perché la richiesta contiene un filtro su sessionSource = google. Questo parametro verrà comunque compilato se è presente una perdita di dati da un'altra riga nei dati aggregati di input utilizzati per generare questo report. Per saperne di più, consulta Informazioni sulla riga (other) e sul campionamento dei dati. |
schemaRestrictionResponse |
Descrive le limitazioni dello schema applicate attivamente durante la creazione di questo report. Per scoprire di più, consulta Gestione delle restrizioni relative a dati e accessi. |
currencyCode |
Codice valuta utilizzato in questo report. Destinato all'utilizzo nella formattazione di metriche di valuta come I codici valuta sono codifiche stringa dei tipi di valuta secondo lo standard ISO 4217 (https://en.wikipedia.org/wiki/ISO_4217). ad esempio "USD", "EUR", "JPY". Per ulteriori informazioni, consulta la pagina https://support.google.com/analytics/answer/9796179. |
timeZone |
Il fuso orario attuale della proprietà. È destinata a essere utilizzata per interpretare dimensioni basate sul tempo come |
emptyReason |
Se viene specificato un motivo vuoto, il report è vuoto per questo motivo. |
subjectToThresholding |
Se |
SchemaRestrictionResponse
Limitazioni dello schema applicate attivamente durante la creazione di questo report. Per scoprire di più, consulta Gestione delle restrizioni relative a dati e accessi.
Rappresentazione JSON |
---|
{
"activeMetricRestrictions": [
{
object ( |
Campi | |
---|---|
activeMetricRestrictions[] |
Tutte le restrizioni sono state applicate attivamente durante la creazione del report. Ad esempio, |
ActiveMetricRestriction
Una metrica con limitazioni attiva per la creazione del report.
Rappresentazione JSON |
---|
{
"restrictedMetricTypes": [
enum ( |
Campi | |
---|---|
restrictedMetricTypes[] |
Il motivo della restrizione di questa metrica. |
metricName |
Il nome della metrica soggetta a limitazioni. |
RestrictedMetricType
Categorie di dati che potrebbero non essere visualizzate su determinate proprietà GA4.
Enum | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Tipo non specificato. |
COST_DATA |
Metriche relative ai costi come adCost . |
REVENUE_DATA |
Metriche relative alle entrate, ad esempio purchaseRevenue . |