Method: publishers.items.queryMetrics

Sprawdź dane dotyczące produktu.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa elementu, którego dotyczy zapytanie o dane. Format: publishers/{publisher}/items/{item}

Parametry zapytania

Parametry
timeSpec

object (TimeSpec)

Wymagane. Specyfikacja czasu, dla którego ma zostać wysłane zapytanie o zestaw danych.
metrics[]

string

Wymagane. Wskaźniki, dla których ma zostać wysłane zapytanie do zbioru wskaźników.

Obsługiwane dane:

  • installs: liczba instalacji elementu.
  • installs-7d: liczba instalacji elementu w ciągu ostatnich 7 dni.
  • uninstalls: liczba odinstalowań elementu.
  • users: liczba aktywnych użytkowników dziennie, którzy korzystają z elementu.
  • users-7d: liczba użytkowników aktywnych w ciągu 7 dni.
  • wyświetlenia: liczba wyświetleń produktu w całej witrynie sklepu.
  • wyświetlenia strony: liczba wyświetleń strony z informacjami o produkcie;
dimensions[]

string

Opcjonalnie: Wymiary, według których mają być dzielone dane. Można określić maksymalnie 1 wymiar.

Obsługiwane wymiary:

  • os: system operacyjny użytkownika.
  • app-version: wersja produktu.
  • country: kraj użytkownika.
  • install-source: źródło instalacji.
  • install-type: typ instalacji (ze sklepu internetowego, wbudowana lub inna).
  • language: język użytkownika.
  • enabled: czy element jest włączony czy wyłączony.
  • utm-campaign: kampania UTM użytkownika.
  • utm-content: treść UTM użytkownika.
  • utm-medium: medium UTM użytkownika.
  • utm-source: źródło UTM użytkownika.
  • utm-term: hasło UTM użytkownika.
pageSize

integer

Opcjonalnie: Maksymalna liczba wierszy do zwrócenia. Jeśli nie zostanie określony, zwracanych będzie maksymalnie 100 wierszy. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania. Podaj tę wartość, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie pozostałe parametry podane w żądaniu muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat odpowiedzi dla items.queryMetrics.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "metricRows": [
    {
      object (MetricRow)
    }
  ],
  "nextPageToken": string
}
Pola
metricRows[]

object (MetricRow)

Wiersze danych.
nextPageToken

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

TimeSpec

Zakres dat dla danych zapytania.

Zapis JSON 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
Pola
firstDate

object (Date)

Opcjonalnie: Pierwsza data (włącznie) specyfikacji czasu. Jeśli nie jest ustawiona, nie zostanie zastosowana dolna granica.
lastDate

object (Date)

Opcjonalnie: Ostatnia data (włącznie) specyfikacji czasu. Jeśli nie jest ustawiona, nie zostanie zastosowana górna granica.

Data

Reprezentuje pełną lub częściową datę kalendarzową, np. datę urodzin. Pora dnia i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podana w kalendarzu gregoriańskim. Może to być jedna z tych wartości:

  • Pełna data z wartościami roku, miesiąca i dnia różnymi od zera.
  • Miesiąc i dzień z rokiem zerowym (np. rocznica).
  • Sam rok z miesiącem i dniem zerowym.
  • Rok i miesiąc z dniem zerowym (np. data ważności karty kredytowej).

Powiązane typy:

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, jeśli określasz datę bez roku.
month

integer

Miesiąc roku. Musi mieścić się w zakresie od 1 do 12 lub wynosić 0, jeśli określasz rok bez miesiąca i dnia.
day

integer

Dzień miesiąca. Wartość musi mieścić się w zakresie od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub wynosić 0, jeśli określasz sam rok lub rok i miesiąc, gdy dzień nie jest istotny.

MetricRow

Pojedynczy wiersz danych i wartości wymiarów.

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

object (Date)

Data rekordu.
dimensionValues[]

string

Kolumny wartości wymiaru dla wiersza.
metricValues[]

object (MetricValue)

Kolumny danych dla wiersza.

MetricValue

Reprezentuje wartość pojedynczego wskaźnika.

Zapis JSON 
{
  "metric": string,
  "value": string,
  "uniqueUserCount": string
}
Pola
metric

string

Nazwa danych
value

string (int64 format)

Wartość danych.
uniqueUserCount

string (int64 format)

Liczba unikalnych użytkowników powiązana z danymi (jeśli dotyczy).