Method: vitals.bitmapmemoryusage.query

Esegue query sulle metriche nel set di metriche.

Richiesta HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/bitmapMemoryUsageMetricSet}:query

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
name

string

Obbligatorio. Nome della risorsa.

Format: apps/{app}/bitmapMemoryUsageMetricSet

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 cronologia.

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.
dimensions[]

string

Facoltativo. Dimensioni in base alle quali suddividere 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. La forma 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 esempio 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 esempio Samsung.
  • deviceSocModel (string): modello del system-on-chip principale del dispositivo, ad esempio "Exynos 2100".
  • deviceCpuMake (string): marca della CPU del dispositivo, ad esempio 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 esempio T750.
  • deviceVulkanVersion (string): versione Vulkan del dispositivo, ad esempio "4198400".
  • deviceGlEsVersion (string): versione OpenGL ES del dispositivo, ad esempio "196610".
  • deviceScreenSize (string): dimensioni dello schermo del dispositivo, ad esempio NORMAL, LARGE.
  • deviceScreenDpi (string): densità dello schermo del dispositivo, ad esempio mdpi, hdpi.
  • processName (string): il nome del processo in esecuzione, ad esempio com.example.app.
  • appState (string): lo stato dell'app quando è stata raccolta la memoria, ad esempio FOREGROUND.
metrics[]

string

Facoltativo. Metriche da aggregare.

Metriche supportate:

  • bitmapMemoryUsageP50 (google.type.Decimal): 50° percentile della memoria bitmap utilizzata.
  • bitmapMemoryUsageP75 (google.type.Decimal): 75° percentile della memoria utilizzata dalle bitmap.
  • bitmapMemoryUsageP90 (google.type.Decimal): 90° percentile della memoria bitmap utilizzata.
  • bitmapMemoryUsageP95 (google.type.Decimal): 95° percentile della memoria utilizzata dalla bitmap.
  • bitmapMemoryUsageP99 (google.type.Decimal): 99° percentile della memoria utilizzata dalla bitmap.
  • distinctUsers (google.type.Decimal): il numero di utenti distinti per i quali sono state registrate metriche di memoria durante il periodo di aggregazione. Occorre prestare attenzione a non aggregare ulteriormente questo conteggio, in quanto gli utenti potrebbero essere conteggiati più volte. Il valore viene arrotondato al multiplo più vicino di 10, 100, 1000 o 1.000.000, a seconda della grandezza del valore.
filter

string

Facoltativo. Filtri da applicare ai dati. L'espressione di filtro segue lo standard AIP-160 e supporta l'applicazione di filtri in base all'uguaglianza di tutte le dimensioni di distribuzione.

pageSize

integer

Facoltativo. Dimensione massima dei dati restituiti.

Se non specificato, verranno restituite al massimo 1000 righe. Il valore massimo è 10.000; i valori superiori a 10.000 verranno forzati a 10.000.

pageToken

string

Facoltativo. Un token di pagina, ricevuto da una chiamata precedente. Fornisci questo valore per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti alla richiesta devono corrispondere alla chiamata che ha fornito il token di pagina.

userCohort

enum (UserCohort)

Facoltativo. Vista utente da selezionare. I dati di output corrisponderanno alla vista selezionata. L'unico valore supportato è OS_PUBLIC.

Corpo della risposta

Messaggio di risposta per bitmapmemoryusage.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 saperne di più, consulta la OAuth 2.0 Overview.