Method: publishers.items.queryMetrics

Fragen Sie die Messwerte für einen Artikel ab.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Name des Elements, für das die Messwerte abgefragt werden sollen. Format: publishers/{publisher}/items/{item}

Suchparameter

Parameter
timeSpec

object (TimeSpec)

Erforderlich. Die Zeitspezifikation, für die der Messwertsatz abgefragt werden soll.
metrics[]

string

Erforderlich. Die Messwerte, für die der Messwertsatz abgefragt werden soll.

Unterstützte Messwerte:

  • „installs“: Anzahl der Installationen des Artikels.
  • installs-7d: Anzahl der Artikelinstallationen in den letzten 7 Tagen.
  • uninstalls: Anzahl der Deinstallationen des Artikels.
  • users: Anzahl der aktiven Nutzer pro Tag des Artikels.
  • users-7d: Anzahl der Nutzer, die in den letzten 7 Tagen aktiv waren.
  • Impressionen: Anzahl der Artikelimpressionen im gesamten Storefront.
  • page-views: Anzahl der einzelnen Aufrufe der Detailseite des Artikels.
dimensions[]

string

Optional. Dimensionen, nach denen die Messwerte aufgeteilt werden sollen. Es kann maximal eine Dimension angegeben werden.

Unterstützte Dimensionen:

  • os: Das Betriebssystem des Nutzers.
  • app-version: Die Version des Artikels.
  • country: Das Land des Nutzers.
  • install-source: Die Quelle der Installation.
  • install-type: Der Installationstyp (aus dem Web Store, Inline oder andere).
  • language: Die Sprache des Nutzers.
  • „enabled“: Gibt an, ob das Element aktiviert oder deaktiviert ist.
  • utm-campaign: Die UTM-Kampagne des Nutzers.
  • utm-content: Der UTM-Inhalt des Nutzers.
  • utm-medium: Das UTM-Medium des Nutzers.
  • utm-source: Die UTM-Quelle des Nutzers.
  • utm-term: Der UTM-Begriff des Nutzers.
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Zeilen. Wenn nicht angegeben, werden maximal 100 Zeilen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für die Anfrage bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für items.queryMetrics.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

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

object (MetricRow)

Die Messwertzeilen.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

TimeSpec

Ein Zeitraum für die Abfrage von Messwerten.

JSON-Darstellung 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
Felder
firstDate

object (Date)

Optional. Das erste Datum (einschließlich) der Zeitangabe. Wenn nicht festgelegt, wird keine Untergrenze angewendet.
lastDate

object (Date)

Optional. Das letzte Datum (einschließlich) der Zeitspezifikation. Wenn nicht festgelegt, wird keine Obergrenze angewendet.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:

  • Ein ganzes Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind
  • Einen Monat und einen Tag mit einem Jahr von 0 (z. B. einen Jahrestag)
  • Ein Jahr für sich allein, also mit einem Monat und einem Tag von 0
  • Ein Jahr und einen Monat mit einem Tag von 0 (z. B. ein Ablaufdatum der Kreditkarte)

Ähnliche Typen:

JSON-Darstellung 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahreszahl angegeben wird.
month

integer

Monat eines Jahres. Der Wert muss zwischen 1 und 12 liegen. Er kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.
day

integer

Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Er kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht relevant ist.

MetricRow

Eine einzelne Zeile mit Messwerten und Dimensionswerten.

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

object (Date)

Das Datum des Eintrags.
dimensionValues[]

string

Dimensionswertspalten für die Zeile.
metricValues[]

object (MetricValue)

Messwertspalten für die Zeile.

MetricValue

Stellt den Wert eines einzelnen Messwerts dar

JSON-Darstellung 
{
  "metric": string,
  "value": string,
  "uniqueUserCount": string
}
Felder
metric

string

Der Name des Messwerts
value

string (int64 format)

Der Wert des Messwerts.
uniqueUserCount

string (int64 format)

Die Anzahl der einzelnen Nutzer, die dem Messwert zugeordnet sind (falls zutreffend).