Method: vitals.slowrenderingrate.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/v1alpha1/{name=apps/*/slowRenderingRateMetricSet}:query
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
name |
string
Obbligatorio. Nome della risorsa. Formato: apps/{app}/slowRenderingRateMetricSet
|
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 )
Specifica dei parametri di aggregazione della cronologia. Periodi di aggregazione supportati:
DAILY : le metriche vengono aggregate in intervalli di date del calendario. A causa di vincoli storici, l'unico fuso orario 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 ): la versione dell'app in esecuzione sul dispositivo dell'utente.
deviceModel (string ): 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.
deviceBrand (string ): 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 esempio PHONE.
countryCode (string ): il paese o la regione del dispositivo dell'utente in base al suo indirizzo IP, rappresentato come codice ISO-3166 di due lettere (ad es. US per gli Stati Uniti).
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:
slowRenderingRate20Fps (google.type.Decimal ): percentuale di utenti unici nel periodo di aggregazione che hanno avuto un rendering lento.
slowRenderingRate20Fps7dUserWeighted (google.type.Decimal ): valore medio mobile di slowRenderingRate20Fps negli ultimi 7 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti unici per il giorno.
slowRenderingRate20Fps28dUserWeighted (google.type.Decimal ): valore medio mobile di slowRenderingRate20Fps negli ultimi 28 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti unici per il giorno.
slowRenderingRate30Fps (google.type.Decimal ): percentuale di utenti unici nel periodo di aggregazione che hanno avuto un rendering lento.
slowRenderingRate30Fps7dUserWeighted (google.type.Decimal ): valore medio mobile di slowRenderingRate30Fps negli ultimi 7 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti unici per il giorno.
slowRenderingRate30Fps28dUserWeighted (google.type.Decimal ): valore medio mobile di slowRenderingRate30Fps negli ultimi 28 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti unici per il giorno.
distinctUsers (google.type.Decimal ): conteggio degli utenti unici nel periodo di aggregazione che sono stati utilizzati come valore di normalizzazione per la metrica slowRenderingRate20Fps /slowRenderingRate30Fps . Un utente viene conteggiato in questa metrica se la sua app è stata avviata nel dispositivo. È 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 grandezza.
|
filter |
string
Filtri da applicare ai dati. L'espressione di filtro segue lo standard AIP-160 e supporta il filtro per uguaglianza di tutte le dimensioni di distribuzione.
|
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.
|
userCohort |
enum (UserCohort )
Visualizzazione utente da selezionare. I dati di output corrisponderanno alla visualizzazione selezionata. L'unico valore supportato è OS_PUBLIC .
|
Corpo della risposta
Messaggio di risposta per slowrenderingrate.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 )
Righe di dati 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 the slow rendering rate metric set for a specified app, allowing for data slicing by dimensions like API level, device model, and country.\u003c/p\u003e\n"],["\u003cp\u003eData aggregation is supported by daily, 7-day, and 28-day periods, with customizable filtering and pagination options.\u003c/p\u003e\n"],["\u003cp\u003eReturned metrics include slow rendering rates at 20 FPS and 30 FPS, along with distinct user counts.\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 API endpoint queries metrics related to slow rendering rates within a specified metric set. It uses a POST request to a defined URL with a required `name` path parameter indicating the resource. The request body includes parameters for `timelineSpec`, `dimensions`, `metrics`, `filter`, `pageSize`, `pageToken`, and `userCohort`. It returns rows of data and a `nextPageToken` for pagination. Supported metrics include slow rendering rates, distinct users, and several weighted averages of these metrics. The `userCohort` parameter only supports the `OS_PUBLIC` value. Authorization is required via the `playdeveloperreporting` scope.\n"],null,[]]