Method: vitals.crashrate.query
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Esegue una query sulle metriche nel set di metriche.
Richiesta HTTP
POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/crashRateMetricSet}:query
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
name |
string
Obbligatorio. Nome della risorsa. Formato: apps/{app}/crashRateMetricSet
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"timelineSpec": {
object (TimelineSpec)
},
"dimensions": [
string
],
"metrics": [
string
],
"filter": string,
"pageSize": integer,
"pageToken": string,
"userCohort": enum (UserCohort)
} |
| Campi |
timelineSpec |
object (TimelineSpec)
Facoltativo. Specifica dei parametri di aggregazione della sequenza temporale. Periodi di aggregazione supportati:
DAILY: le metriche vengono aggregate in intervalli di date di calendario. A causa di vincoli storici, il fuso orario predefinito e l'unico supportato è America/Los_Angeles.HOURLY: le metriche vengono aggregate in intervalli orari. Il fuso orario predefinito e l'unico supportato è UTC.
|
dimensions[] |
string
Facoltativo. Dimensioni in base alle quali suddividere le metriche. Dimensioni supportate:
apiLevel (string): il livello API di Android in esecuzione sul dispositivo dell'utente, ad es. 26.versionCode (int64): la versione dell'app in esecuzione sul dispositivo dell'utente.deviceModel (string): l'identificatore univoco del modello del dispositivo dell'utente. Il formato dell'identificatore è "deviceBrand/device", dove deviceBrand corrisponde a Build.BRAND e device corrisponde a Build.DEVICE, ad es. google/coral.deviceBrand (string): l'identificatore univoco del brand del dispositivo dell'utente, ad es. google.deviceType (string): il tipo (noto anche come fattore di forma) del dispositivo dell'utente, ad es. PHONE.countryCode (string): il paese o la regione del dispositivo dell'utente in base al suo indirizzo IP, rappresentato come un codice ISO 3166 a 2 lettere (ad es. US per gli Stati Uniti).deviceRamBucket (int64): la RAM del dispositivo, in MB, in bucket (3 GB, 4 GB e così via).deviceSocMake (string): la marca del system-on-chip principale del dispositivo, ad es. Samsung. RiferimentideviceSocModel (string): il modello del system-on-chip principale del dispositivo, ad es. "Exynos 2100". RiferimentideviceCpuMake (string): la marca della CPU del dispositivo, ad es. Qualcomm.deviceCpuModel (string): il modello della CPU del dispositivo, ad es. "Kryo 240".deviceGpuMake (string): la marca della GPU del dispositivo, ad es. ARM.deviceGpuModel (string): il modello della GPU del dispositivo, ad es. Mali.deviceGpuVersion (string): la versione della GPU del dispositivo, ad es. T750.deviceVulkanVersion (string): la versione Vulkan del dispositivo, ad es. "4198400".deviceGlEsVersion (string): la versione OpenGL ES del dispositivo, ad es. "196610".deviceScreenSize (string): le dimensioni dello schermo del dispositivo, ad es. NORMAL, LARGE.deviceScreenDpi (string): la densità dello schermo del dispositivo, ad es. mdpi, hdpi.
|
metrics[] |
string
Facoltativo. Metriche da aggregare. Metriche supportate:
crashRate (google.type.Decimal): la percentuale di utenti distinti nel periodo di aggregazione che hanno riscontrato almeno un arresto anomalo.crashRate7dUserWeighted (google.type.Decimal): il valore medio mobile di crashRate negli ultimi 7 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti distinti per il giorno.crashRate28dUserWeighted (google.type.Decimal): il valore medio mobile di crashRate negli ultimi 28 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti distinti per il giorno. Non è supportato nella granularità HOURLY.userPerceivedCrashRate (google.type.Decimal): la percentuale di utenti distinti nel periodo di aggregazione che hanno riscontrato almeno un arresto anomalo mentre utilizzavano attivamente la tua app (un arresto anomalo percepito dall'utente). Un'app è considerata in uso attivo se mostra un'attività o esegue un servizio in primo piano.userPerceivedCrashRate7dUserWeighted (google.type.Decimal): il valore medio mobile di userPerceivedCrashRate negli ultimi 7 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti distinti per il giorno. Non è supportato nella granularità HOURLY.userPerceivedCrashRate28dUserWeighted (google.type.Decimal): il valore medio mobile di userPerceivedCrashRate negli ultimi 28 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti distinti per il giorno. Non è supportato nella granularità HOURLY.distinctUsers (google.type.Decimal): il conteggio degli utenti distinti nel periodo di aggregazione che sono stati utilizzati come valore di normalizzazione per le metriche crashRate e userPerceivedCrashRate. Un utente viene conteggiato in questa metrica se ha utilizzato l'app attivamente durante il periodo di aggregazione. Un'app è considerata in uso attivo se mostra un'attività o esegue un servizio in primo piano. È necessario prestare attenzione a non aggregare ulteriormente questo conteggio, in quanto potrebbe comportare il conteggio degli utenti più volte. Il valore viene arrotondato al multiplo più vicino di 10, 100, 1000 o 1.000.000, a seconda della sua entità.
|
filter |
string
Facoltativo. Filtri da applicare ai dati. L'espressione di filtro segue lo standard AIP-160 e supporta il filtraggio per uguaglianza di tutte le dimensioni di suddivisione.
|
pageSize |
integer
Facoltativo. La dimensione massima dei dati restituiti. Se non specificato, verranno restituite al massimo 1000 righe. Il valore massimo è 100.000; i valori superiori a 100.000 verranno forzati a 100.000.
|
pageToken |
string
Facoltativo. Un token di pagina, ricevuto da una chiamata precedente. Forniscilo per recuperare la pagina successiva. Quando esegui la paginazione, tutti gli altri parametri forniti alla richiesta devono corrispondere alla chiamata che ha fornito il token di pagina.
|
userCohort |
enum (UserCohort)
Facoltativo. Visualizzazione utente da selezionare. I dati di output corrisponderanno alla visualizzazione selezionata. Valori supportati:
|
Corpo della risposta
Il messaggio di risposta per crashrate.query.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"rows": [
{
object (MetricsRow)
}
],
"nextPageToken": string
} |
| Campi |
rows[] |
object (MetricsRow)
Le righe di dati restituite.
|
nextPageToken |
string
Il token di continuazione per recuperare la pagina di dati successiva.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/playdeveloperreporting
Per saperne di più, consulta la OAuth 2.0 Overview.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2026-04-22 UTC.
[null,null,["Ultimo aggiornamento 2026-04-22 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"]]