Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.
Method: vitals.crashrate.query
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wysyła zapytania o wskaźniki w zbiorze wskaźników.
Żą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
Wymagane. 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)
Opcjonalnie: Specyfikacja 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 odstępach godzinowych. Domyślna i jedyna obsługiwana strefa czasowa to UTC.
|
dimensions[] |
string
Opcjonalnie: Wymiary, według których mają być dzielone dane. Obsługiwane wymiary:
apiLevel (string): poziom interfejsu API Androida, który był uruchomiony 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 format „markaUrządzenia/urządzenie”, gdzie markaUrządzenia odpowiada Build.BRAND, a urządzenie odpowiada Build.DEVICE, np. google/coral.
deviceBrand (string): unikalny identyfikator marki urządzenia użytkownika, np. google.
deviceType (string): typ (nazywany też formatem) urządzenia użytkownika, np. PHONE (telefon).
countryCode (string): kraj lub region urządzenia użytkownika na podstawie jego adresu IP, reprezentowany przez 2-literowy kod ISO-3166 (np. US dla Stanów Zjednoczonych).
deviceRamBucket (int64): pamięć RAM urządzenia w MB, w grupach (np. 1024 dla 1–1,5 GB, 4096 dla 4–6 GB).
deviceSocMake (string): marka głównego układu SoC urządzenia, np. Samsung. Reference
deviceSocModel (string): model głównego układu SoC urządzenia, np. „Exynos 2100”. Reference
deviceCpuMake (string): producent procesora urządzenia, np. Qualcomm.
deviceCpuModel (string): model procesora urządzenia, np. „Kryo 240”.
deviceGpuMake (string): marka GPU urządzenia, np. ARM.
deviceGpuModel (string): model GPU urządzenia, np. Mali.
deviceGpuVersion (string): wersja GPU urządzenia, np. T750.
deviceVulkanVersion (string): wersja interfejsu Vulkan na urządzeniu, np. „4198400”.
deviceGlEsVersion (string): wersja OpenGL ES urządzenia, np. „196610”.
deviceScreenSize (string): rozmiar ekranu urządzenia, np. NORMAL (normalny), LARGE (duży).
deviceScreenDpi (string): gęstość ekranu urządzenia, np. mdpi, hdpi.
|
metrics[] |
string
Opcjonalnie: 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 w ciągu ostatnich 7 dni. Wartości dzienne są ważone według liczby unikalnych użytkowników w danym dniu.
crashRate28dUserWeighted (google.type.Decimal): średnia krocząca wartości crashRate w ciągu ostatnich 28 dni. Wartości dzienne są ważone według liczby 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żytkowników). 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 w ciągu ostatnich 7 dni. Wartości dzienne są ważone według liczby 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 w ciągu ostatnich 28 dni. Wartości dzienne są ważone według liczby 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óra została użyta jako wartość normalizacji dla 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 agregować tej liczby dalej, ponieważ może to spowodować wielokrotne zliczanie 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
Opcjonalnie: Filtry, które mają zostać zastosowane do danych. Wyrażenie filtrujące jest zgodne ze standardem AIP-160 i obsługuje filtrowanie według równości wszystkich wymiarów podziału.
|
pageSize |
integer
Opcjonalnie: Maksymalny rozmiar zwracanych danych. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 1000 wierszy. Maksymalna wartość to 10 000. Wartości powyżej 10 000 zostaną wymuszone na 10 000.
|
pageToken |
string
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania. Podaj go, 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.
|
userCohort |
enum (UserCohort)
Opcjonalnie: Widok użytkownika do wybrania. 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 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: 2026-10-26 UTC.
[null,null,["Ostatnia aktualizacja: 2026-10-26 UTC."],[],["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"]]