Method: vitals.stuckbackgroundwakelockrate.query

Wysyła zapytania o dane w zestawie danych.

Żądanie HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/stuckBackgroundWakelockRateMetricSet}:query

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagany. Nazwa zasobu.

Format: apps/{app}/stuckBackgroundWakelockRateMetricSet

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Pola
timelineSpec

object (TimelineSpec)

Określenie parametrów agregacji osi czasu.

Obsługiwane okresy agregacji:

  • DAILY: dane są agregowane w interwałach dat kalendarzowych. Ze względu na ograniczenia historyczne jedyną obsługiwaną strefą czasową jest America/Los_Angeles.
dimensions[]

string

Wymiary, według których chcesz podzielić dane.

Obsługiwane wymiary:

  • apiLevel (string): poziom interfejsu API Androida, który był używany na urządzeniu użytkownika, np. 26.
  • versionCode (int64): wersja aplikacji, która była uruchomiona na urządzeniu użytkownika.
  • deviceModel (string): unikalny identyfikator modelu urządzenia użytkownika. Identyfikator ma postać „deviceBrand/device”, gdzie deviceBrand odpowiada Build.BRAND, a device odpowiada Build.DEVICE, np. google/coral.
  • deviceBrand (string): unikalny identyfikator marki urządzenia użytkownika, np. google.
  • deviceType (string): typ (zwany też formatem) urządzenia użytkownika, np. TELEFON.
  • countryCode (string): kraj lub region urządzenia użytkownika na podstawie adresu IP, przedstawiony jako 2-literowy kod ISO 3166 (np. US w przypadku Stanów Zjednoczonych).
  • deviceRamBucket (int64): pamięć RAM urządzenia w MB, w przedziałach (3 GB, 4 GB itp.).
  • deviceSocMake (string): marka głównego układu SoC urządzenia, np. Samsung. Produkty
  • deviceSocModel (string): model głównego układu SoC urządzenia, np. „Exynos 2100”. Produkty
  • deviceCpuMake (string): marka procesora urządzenia, np. Qualcomm.
  • deviceCpuModel (string): model procesora urządzenia, np. „Kryo 240”.
  • deviceGpuMake (string): marka procesora graficznego urządzenia, np. ARM.
  • deviceGpuModel (string): model procesora graficznego urządzenia, np. Mali.
  • deviceGpuVersion (string): wersja procesora graficznego urządzenia, np. T750.
  • deviceVulkanVersion (string): wersja interfejsu Vulkan na urządzeniu, np. „4198400”.
  • deviceGlEsVersion (string): wersja OpenGL ES na urządzeniu, np. „196610”.
  • deviceScreenSize (string): rozmiar ekranu urządzenia, np. NORMALNY, DUŻY.
  • deviceScreenDpi (string): gęstość ekranu urządzenia, np. mdpi, hdpi.
metrics[]

string

Dane do agregacji.

Obsługiwane dane:

  • stuckBgWakelockRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, którzy mieli blokadę uśpienia utrzymywaną w tle przez ponad godzinę.
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal): średnia krocząca wartości stuckBgWakelockRate z ostatnich 7 dni. Wartości dzienne są ważone przez liczbę unikalnych użytkowników w danym dniu.
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal): średnia krocząca wartości stuckBgWakelockRate z ostatnich 28 dni. Wartości dzienne są ważone przez liczbę unikalnych użytkowników w danym dniu.
  • distinctUsers (google.type.Decimal): liczba unikalnych użytkowników w okresie agregacji, którzy zostali użyci jako wartość normalizacyjna w przypadku danych stuckBgWakelockRate. Użytkownik jest uwzględniany w tych danych, jeśli aplikacja wykonywała jakiekolwiek działania na urządzeniu, czyli nie tylko aktywnie korzystał z niej na pierwszym planie, ale też wykonywała ona działania w tle. Należy uważać, aby nie sumować tej liczby, ponieważ może to spowodować kilkukrotne zliczenie użytkowników. Wartość jest zaokrąglana do najbliższej wielokrotności 10, 100, 1000 lub 1 000 000 w zależności od jej wielkości.
filter

string

Filtry do zastosowania w przypadku danych. Wyrażenie filtrujące jest zgodne ze standardem AIP-160 i umożliwia filtrowanie według równości wszystkich wymiarów podziału.
pageSize

integer

Maksymalny rozmiar zwracanych danych.

Jeśli nie określono inaczej, zwracanych będzie maksymalnie 1000 wierszy. Maksymalna wartość to 100 000. Wartości powyżej 100 000 zostaną ograniczone do 100 000.
pageToken

string

Token strony otrzymany z poprzedniego wywołania. Podaj ten token, aby pobrać kolejną stronę.

Podczas stronicowania wszystkie inne parametry podane w żądaniu muszą być zgodne z wywołaniem, które dostarczyło token strony.
userCohort

enum (UserCohort)

Widok użytkownika do wyboru. Dane wyjściowe będą odpowiadać wybranemu widokowi. Jedyną obsługiwaną wartością jest OS_PUBLIC.

Treść odpowiedzi

Wiadomość z odpowiedzią dla stuckbackgroundwakelockrate.query.

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

Zapis JSON 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Pola
rows[]

object (MetricsRow)

Zwrócone wiersze danych.
nextPageToken

string

Token kontynuacji do pobrania następnej strony danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/playdeveloperreporting

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.