Method: publishers.items.queryMetrics

Esegui una query sulle metriche di un elemento.

Richiesta HTTP

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:queryMetrics

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
name

string

Obbligatorio. Il nome dell'elemento per cui eseguire la query sulle metriche. Formato: publishers/{publisher}/items/{item}

Parametri di query

Parametri
timeSpec

object (TimeSpec)

Obbligatorio. La specifica temporale per cui eseguire la query sul set di metriche.
metrics[]

string

Obbligatorio. Le metriche per cui eseguire query sul set di metriche.

Metriche supportate:

  • installs: il numero di installazioni dell'elemento.
  • installs-7d: numero di installazioni dell'elemento negli ultimi 7 giorni.
  • uninstalls: numero di disinstallazioni dell'elemento.
  • users: numero di utenti attivi giornalieri dell'elemento.
  • users-7d: numero di utenti attivi in 7 giorni dell'elemento.
  • impressions: numero di impressioni dell'articolo nell'intero negozio.
  • page-views: il numero di singole visualizzazioni della pagina dei dettagli dell'elemento.
dimensions[]

string

Facoltativo. Dimensioni in base alle quali suddividere le metriche. È possibile specificare al massimo una dimensione.

Dimensioni supportate:

  • os: il sistema operativo dell'utente.
  • app-version: la versione dell'elemento.
  • country: il paese dell'utente.
  • install-source: l'origine dell'installazione.
  • install-type: il tipo di installazione (dal web store, in linea o altro).
  • language: la lingua dell'utente.
  • enabled: indica se l'elemento è attivato o disattivato.
  • utm-campaign: la campagna UTM dell'utente.
  • utm-content: i contenuti UTM dell'utente.
  • utm-medium: il mezzo UTM dell'utente.
  • utm-source: la sorgente UTM dell'utente.
  • utm-term: il termine UTM dell'utente.
pageSize

integer

Facoltativo. Il numero massimo di righe da restituire. Se non viene specificato, verranno restituite al massimo 100 righe. Il valore massimo è 1000. I valori superiori a 1000 verranno forzati a 1000.
pageToken

string

Facoltativo. Un token di pagina, ricevuto da una chiamata precedente. Fornisci questo valore per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti alla richiesta devono corrispondere alla chiamata che ha fornito il token di pagina.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per items.queryMetrics.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "metricRows": [
    {
      object (MetricRow)
    }
  ],
  "nextPageToken": string
}
Campi
metricRows[]

object (MetricRow)

Le righe delle metriche.
nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

TimeSpec

Un intervallo di date per l'esecuzione di query sulle metriche.

Rappresentazione JSON 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
Campi
firstDate

object (Date)

Facoltativo. La prima data (inclusa) della specifica temporale. Se non è impostata, non verrà applicato alcun limite inferiore.
lastDate

object (Date)

Facoltativo. L'ultima data (inclusa) della specifica temporale. Se non viene impostata, non verrà applicato alcun limite superiore.

Data

Rappresenta una data di calendario completa o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • Un mese e un giorno, con un anno zero (ad esempio, un anniversario).
  • Un anno da solo, con un mese pari a zero e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

MetricRow

Una singola riga di valori di metriche e dimensioni.

Rappresentazione JSON 
{
  "date": {
    object (Date)
  },
  "dimensionValues": [
    string
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Campi
date

object (Date)

La data del record.
dimensionValues[]

string

Colonne dei valori delle dimensioni per la riga.
metricValues[]

object (MetricValue)

Colonne delle metriche per la riga.

MetricValue

Rappresenta il valore di una singola metrica

Rappresentazione JSON 
{
  "metric": string,
  "value": string,
  "uniqueUserCount": string
}
Campi
metric

string

Il nome della metrica
value

string (int64 format)

Il valore della metrica.
uniqueUserCount

string (int64 format)

Il numero di utenti unici associato alla metrica (se applicabile).