- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ResponseMetaData
- SchemaRestrictionResponse
- ActiveMetricRestriction
- RestrictedMetricType
- Prova!
Recupera i contenuti di un'attività report. Dopo aver richiesto reportTasks.create
, puoi recuperare i contenuti del report quando diventa ATTIVO. Questo metodo restituirà un errore se lo stato dell'attività di report non è ACTIVE
. Una risposta alla query restituirà i valori di righe e colonne tabulari 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 |
Obbligatoria. 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 |
Campo 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 Impaginazione. |
limit |
Campo facoltativo. Il numero di righe da restituire dal report. Se non specificati, vengono restituite 10.000 righe. L'API restituisce un massimo di 250.000 righe per richiesta, indipendentemente da quante ne chiedi. L'API può anche restituire meno righe rispetto al valore Per scoprire di più su questo parametro di impaginazione, consulta Impaginazione. |
Corpo della risposta
I contenuti del report corrispondenti a un'attività 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 di QuoteHeader e l'ordine di QuoteHeaders corrisponde 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 che includono informazioni aggiuntive sui contenuti del report.
Rappresentazione JSON |
---|
{
"dataLossFromOtherRow": boolean,
"schemaRestrictionResponse": {
object ( |
Campi | |
---|---|
dataLossFromOtherRow |
Se true, indica che alcuni bucket di combinazioni di dimensioni vengono raggruppati nella riga "(other)". 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 nei dati aggregati di input utilizzati per generare il report era presente una perdita di dati da un'altra riga. Per scoprire di più, consulta Informazioni sulla riga (other) e sul campionamento dei dati. |
schemaRestrictionResponse |
Descrive le limitazioni dello schema applicate attivamente nella creazione di questo report. Per scoprire di più, consulta Gestione delle restrizioni relative a dati e accessi. |
currencyCode |
Il codice valuta utilizzato in questo report. Destinato a essere utilizzato nella formattazione di metriche di valuta come I codici valuta sono codifiche di stringhe dei tipi di valuta dello 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 corrente della proprietà. Destinato a essere utilizzato per interpretare le dimensioni basate sul tempo come |
emptyReason |
Se viene specificato un motivo vuoto, il report sarà vuoto per questo motivo. |
subjectToThresholding |
Se |
SchemaRestrictionResponse
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.
Rappresentazione JSON |
---|
{
"activeMetricRestrictions": [
{
object ( |
Campi | |
---|---|
activeMetricRestrictions[] |
Tutte le restrizioni sono applicate attivamente durante la creazione del report. Ad esempio, |
ActiveMetricRestriction
Una metrica attivamente limitata durante la creazione del report.
Rappresentazione JSON |
---|
{
"restrictedMetricTypes": [
enum ( |
Campi | |
---|---|
restrictedMetricTypes[] |
Il motivo della limitazione di questa metrica. |
metricName |
Il nome della metrica con restrizioni. |
RestrictedMetricType
Categorie di dati la cui visualizzazione potrebbe essere limitata in determinate proprietà GA4.
Enum | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Tipo non specificato. |
COST_DATA |
Metriche dei costi come adCost . |
REVENUE_DATA |
Metriche relative alle entrate, come purchaseRevenue . |