Method: vitals.crashrate.query
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wysyła zapytania o dane w zestawie danych.
Żądanie HTTP
POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/crashRateMetricSet}:query
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry |
name |
string
Wymagany. Nazwa zasobu. Format: apps/{app}/crashRateMetricSet
|
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 domyślną i jedyną obsługiwaną strefą czasową jest America/Los_Angeles .
HOURLY : dane są agregowane w przedziałach godzinowych. Domyślną i jedyną obsługiwaną strefą czasową jest UTC .
|
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:
crashRate (google.type.Decimal ): odsetek unikalnych użytkowników w okresie agregacji, u których wystąpiła co najmniej 1 awaria.
crashRate7dUserWeighted (google.type.Decimal ): średnia krocząca wartości crashRate z ostatnich 7 dni. Wartości dzienne są ważone przez liczbę unikalnych użytkowników w danym dniu.
crashRate28dUserWeighted (google.type.Decimal ): średnia krocząca wartości crashRate z ostatnich 28 dni. Wartości dzienne są ważone przez liczbę unikalnych użytkowników w danym dniu. Nieobsługiwane w przypadku szczegółowości GODZINOWEJ.
userPerceivedCrashRate (google.type.Decimal ): odsetek unikalnych użytkowników w okresie agregacji, u których wystąpiła co najmniej 1 awaria podczas aktywnego korzystania z aplikacji (awaria widoczna dla użytkownika). Aplikacja jest uznawana za aktywnie używaną, jeśli wyświetla jakąkolwiek aktywność lub wykonuje jakąkolwiek usługę na pierwszym planie.
userPerceivedCrashRate7dUserWeighted (google.type.Decimal ): średnia krocząca wartości userPerceivedCrashRate z ostatnich 7 dni. Wartości dzienne są ważone przez liczbę unikalnych użytkowników w danym dniu. Nieobsługiwane w przypadku szczegółowości GODZINOWEJ.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal ): średnia krocząca wartości userPerceivedCrashRate z ostatnich 28 dni. Wartości dzienne są ważone przez liczbę unikalnych użytkowników w danym dniu. Nieobsługiwane w przypadku szczegółowości GODZINOWEJ.
distinctUsers (google.type.Decimal ): liczba unikalnych użytkowników w okresie agregacji, którzy zostali użyci jako wartość normalizacyjna w przypadku danych crashRate i userPerceivedCrashRate . Użytkownik jest uwzględniany w tych danych, jeśli aktywnie korzystał z aplikacji w okresie agregacji. Aplikacja jest uznawana za aktywnie używaną, jeśli wyświetla jakąkolwiek aktywność lub wykonuje jakąkolwiek usługę na pierwszym planie. 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ą zmienione na 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. Obsługiwane wartości:
|
Treść odpowiedzi
Wiadomość z odpowiedzią dla crashrate.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.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eThis endpoint allows you to query crash rate metrics for your app using the Play Developer Reporting API.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify the timeline, dimensions, metrics, and filters for your query in the request body.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes rows of data corresponding to your query and a token for pagination if necessary.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This outlines how to query metrics in a crash rate metric set via a POST request to a specific URL. The request body requires parameters like `timelineSpec` for aggregation periods, `dimensions` to segment metrics (e.g., `apiLevel`, `deviceModel`), and `metrics` to define data points (e.g., `crashRate`). Filters, `pageSize`, `pageToken`, and `userCohort` options are available. The response includes `rows` of metric data and `nextPageToken` for pagination, and it uses OAuth 2.0 authorization.\n"],null,[]]