Method: vitals.errors.counts.query
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Esegue query sulle metriche nel set di metriche.
Richiesta HTTP
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/errorCountMetricSet}:query
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
name |
string
Obbligatorio. Nome della risorsa. Formato: apps/{app}/errorCountMetricSet
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
{
"timelineSpec": {
object (TimelineSpec )
},
"dimensions": [
string
],
"metrics": [
string
],
"pageSize": integer,
"pageToken": string,
"filter": string
} |
Campi |
timelineSpec |
object (TimelineSpec )
Specifica dei parametri di aggregazione della cronologia. Periodi di aggregazione supportati:
DAILY : le metriche vengono aggregate in intervalli di date del calendario. Il fuso orario predefinito e unico supportato è America/Los_Angeles .
|
dimensions[] |
string
Dimensioni in base alle quali segmentare i dati. Dimensioni supportate:
apiLevel (string ): il livello API di Android in esecuzione sul dispositivo dell'utente, ad esempio 26.
versionCode (int64 ): identificatore univoco del modello di dispositivo dell'utente. Il formato dell'identificatore è "deviceBrand/device", dove deviceBrand corrisponde a Build.BRAND e device corrisponde a Build.DEVICE, ad esempio google/coral.
deviceModel (string ): identificatore univoco del modello di dispositivo dell'utente.
deviceType (string ): identificatore del fattore di forma del dispositivo, ad es. PHONE.
reportType (string ): il tipo di errore. Il valore deve corrispondere a uno dei valori possibili in ErrorType .
issueId (string ): l'ID a cui è stato assegnato un errore. Il valore deve corrispondere al componente {issue} di issue name .
deviceRamBucket (int64 ): RAM del dispositivo, in MB, in bucket (3 GB, 4 GB e così via).
deviceSocMake (string ): marca del system-on-chip principale del dispositivo, ad es. Samsung. Riferimento
deviceSocModel (string ): modello del system-on-chip principale del dispositivo, ad esempio "Exynos 2100". Riferimento
deviceCpuMake (string ): produttore della CPU del dispositivo, ad es. Qualcomm.
deviceCpuModel (string ): modello della CPU del dispositivo, ad esempio "Kryo 240".
deviceGpuMake (string ): marca della GPU del dispositivo, ad esempio ARM.
deviceGpuModel (string ): modello della GPU del dispositivo, ad esempio Mali.
deviceGpuVersion (string ): versione della GPU del dispositivo, ad es. T750.
deviceVulkanVersion (string ): versione Vulkan del dispositivo, ad es. "4198400".
deviceGlEsVersion (string ): versione OpenGL ES del dispositivo, ad es. "196610".
deviceScreenSize (string ): dimensioni dello schermo del dispositivo, ad esempio NORMALE, GRANDE.
deviceScreenDpi (string ): densità dello schermo del dispositivo, ad esempio mdpi, hdpi.
|
metrics[] |
string
Metriche da aggregare. Metriche supportate:
errorReportCount (google.type.Decimal ): conteggio assoluto dei singoli report sugli errori ricevuti per un'app.
distinctUsers (google.type.Decimal ): conteggio degli utenti unici per i quali sono state ricevute segnalazioni. È necessario prestare attenzione a non aggregare ulteriormente questo conteggio, in quanto potrebbe comportare il conteggio degli utenti più volte. Questo valore non è arrotondato, ma potrebbe essere un'approssimazione.
|
pageSize |
integer
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
Un token di pagina, ricevuto da una chiamata precedente. Fornisci questo valore per recuperare la pagina successiva. Durante la paginazione, tutti gli altri parametri forniti alla richiesta devono corrispondere alla chiamata che ha fornito il token di pagina.
|
filter |
string
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 distribuzione e:
isUserPerceived (string ): indica se l'errore è percepito dall'utente o meno, USER_PERCEIVED o NOT_USER_PERCEIVED.
|
Corpo della risposta
Errore durante la risposta alla query dei conteggi degli errori.
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 )
Righe restituite.
|
nextPageToken |
string
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 ulteriori informazioni, 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 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 2025-07-26 UTC."],[[["\u003cp\u003eQueries error count metrics within a specified app and timeframe using flexible filtering and aggregation options.\u003c/p\u003e\n"],["\u003cp\u003eAllows specification of data slices via dimensions like API level, device model, error type, and more.\u003c/p\u003e\n"],["\u003cp\u003eSupports aggregation of key metrics including error report count and distinct users affected.\u003c/p\u003e\n"],["\u003cp\u003eReturns paginated results, enabling retrieval of large datasets, and provides a continuation token for subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details querying metrics in a metric set via a POST request to a specific URL. The request requires a `name` path parameter and accepts a JSON body with fields like `timelineSpec`, `dimensions`, `metrics`, `pageSize`, `pageToken`, and `filter`. The response body includes `rows` of data and a `nextPageToken` for pagination. Authorization requires the `https://www.googleapis.com/auth/playdeveloperreporting` OAuth scope. The request allows filtering and specifies supported dimensions and metrics.\n"],null,[]]