Method: publishers.items.queryMetrics

De statistieken voor een item opvragen.

HTTP-verzoek

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

De URL gebruikt de syntaxis van gRPC-transcodering.

Padparameters

Parameters
name

string

Vereist. De naam van het item waarvoor u de statistieken wilt opvragen. Indeling: publishers/{publisher}/items/{item}

Queryparameters

Parameters
timeSpec

object (TimeSpec)

Vereist. De tijdspecificatie waarvoor de statistiekenset moet worden opgevraagd.
metrics[]

string

Vereist. De statistieken waarvoor de statistiekenset moet worden opgevraagd.

Ondersteunde statistieken:

  • installs: Het aantal installaties van het item.
  • installs-7d: Het aantal installaties van het item in de afgelopen 7 dagen.
  • uninstalls: Het aantal verwijderingen van het item.
  • users: Het aantal dagelijks actieve gebruikers van het item.
  • users-7d: Het aantal gebruikers dat het item in de afgelopen 7 dagen heeft gebruikt.
  • vertoningen: Het aantal artikelvertoningen in de hele etalage.
  • page-views: Het aantal afzonderlijke weergaven van de detailpagina van het item.
dimensions[]

string

Optioneel. Dimensies om de statistieken op te splitsen. Er kan maximaal één dimensie worden ingevoerd.

Ondersteunde dimensies:

  • os: Het besturingssysteem van de gebruiker.
  • app-version: De versie van het item.
  • country: Het land van de gebruiker.
  • install-source: De bron van de installatie.
  • install-type: Het type installatie (via de webstore, inline of anders).
  • language: De taal van de gebruiker.
  • enabled: Of het item aan- of uitstaat.
  • utm-campaign: De UTM-campagne van de gebruiker.
  • utm-content: De UTM-content van de gebruiker.
  • utm-medium: Het UTM-medium van de gebruiker.
  • utm-source: De UTM-bron van de gebruiker.
  • utm-term: De UTM-term van de gebruiker.
pageSize

integer

Optioneel. Het maximumaantal rijen dat moet worden geretourneerd. Als je hier niets opgeeft, worden er maximaal 100 rijen geretourneerd. De maximumwaarde is 1000. Waarden boven 1000 worden gedwongen tot 1000.
pageToken

string

Optioneel. Een paginatoken, ontvangen van een eerdere aanroep. Voer dit in om de volgende pagina op te halen.

Bij paginering moeten alle andere parameters die aan het verzoek worden doorgegeven, overeenkomen met de aanroep die het paginatoken heeft geleverd.

Hoofdtekst van verzoek

Het tekstgedeelte van het verzoek moet leeg zijn.

Tekstgedeelte van reactie

Reactiebericht voor items.queryMetrics.

Als dit lukt, bevat het tekstgedeelte van de reactie gegevens met de volgende structuur:

JSON-weergave 
{
  "metricRows": [
    {
      object (MetricRow)
    }
  ],
  "nextPageToken": string
}
Velden
metricRows[]

object (MetricRow)

De statistiekrijen.
nextPageToken

string

Een token dat kan worden gestuurd als pageToken om de volgende pagina op te halen. Als dit veld wordt weggelaten, zijn er geen volgende pagina's.

Autorisatiebereiken

Vereist een van de volgende OAuth-bereiken:

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

TimeSpec

Een periode voor het opvragen van statistieken.

JSON-weergave 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
Velden
firstDate

object (Date)

Optioneel. De eerste datum (inclusief) van de tijdspecificatie. Als je dit niet instelt, wordt er geen ondergrens toegepast.
lastDate

object (Date)

Optioneel. De laatste datum (inclusief) van de tijdspecificatie. Als je dit niet instelt, wordt er geen bovengrens toegepast.

Datum

Staat voor een hele of gedeeltelijke kalenderdatum, zoals een verjaardag. De tijd en tijdzone worden ergens anders vermeld of zijn niet van belang. De datum is relatief ten opzichte van de Gregoriaanse kalender. Dit kan een van de volgende zijn:

  • Een volledige datum, met waarden voor jaar, maand en dag die niet nul zijn.
  • Een maand en dag, met een nuljaar (bijvoorbeeld een jubileum).
  • Alleen een jaar, met een nulmaand en een nuldag.
  • Een jaar en maand, met een dag nul (bijvoorbeeld de vervaldatum van een creditcard).

Gerelateerde typen:

JSON-weergave 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Velden
year

integer

Het jaar van de datum. Moet tussen 1 en 9999 liggen, of 0 om een datum zonder jaar op te geven.
month

integer

Maand van een jaar. Moet tussen 1 en 12 liggen, of 0 om een jaar zonder maand en dag aan te geven.
day

integer

Dag van een maand. Moet tussen 1 en 31 liggen en geldig zijn voor het jaar en de maand, of 0 om een jaar op zichzelf of een jaar en maand aan te geven waarbij de dag niet van belang is.

MetricRow

Eén rij met statistieken en dimensiewaarden.

JSON-weergave 
{
  "date": {
    object (Date)
  },
  "dimensionValues": [
    string
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Velden
date

object (Date)

De datum van de record.
dimensionValues[]

string

Kolommen met dimensiewaarden voor de rij.
metricValues[]

object (MetricValue)

Statistiekkolommen voor de rij.

MetricValue

Vertegenwoordigt de waarde van één statistiek

JSON-weergave 
{
  "metric": string,
  "value": string,
  "uniqueUserCount": string
}
Velden
metric

string

De naam van de statistiek
value

string (int64 format)

De waarde van de statistiek.
uniqueUserCount

string (int64 format)

Het aantal unieke gebruikers dat aan de statistiek is gekoppeld (indien van toepassing).