Method: vitals.crashrate.query

Consulta as métricas no conjunto de métricas.

Solicitação HTTP

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso.

Formato: apps/{app}/crashRateMetricSet

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Campos
timelineSpec

object (TimelineSpec)

Especificação dos parâmetros de agregação da linha do tempo.

Períodos de agregação aceitos:

  • DAILY: as métricas são agregadas em intervalos de datas do calendário. Devido a restrições históricas, o fuso horário padrão e único compatível é America/Los_Angeles.
  • HOURLY: as métricas são agregadas em intervalos de uma hora. O fuso horário padrão e único compatível é UTC.
dimensions[]

string

Dimensões para segmentar as métricas.

Dimensões aceitas:

  • apiLevel (string): o nível da API do Android que estava em execução no dispositivo do usuário, por exemplo, 26.
  • versionCode (int64): versão do app que estava sendo executada no dispositivo do usuário.
  • deviceModel (string): identificador exclusivo do modelo do dispositivo do usuário. O formato do identificador é "deviceBrand/device", em que deviceBrand corresponde a Build.BRAND e device corresponde a Build.DEVICE, por exemplo, google/coral.
  • deviceBrand (string): identificador exclusivo da marca do dispositivo do usuário, por exemplo, google.
  • deviceType (string): o tipo (também conhecido como formato) do dispositivo do usuário, por exemplo, PHONE.
  • countryCode (string): o país ou a região do dispositivo do usuário com base no endereço IP, representado como um código ISO-3166 de duas letras (por exemplo, US para os Estados Unidos).
  • deviceRamBucket (int64): RAM do dispositivo, em MB, em intervalos (3 GB, 4 GB etc.).
  • deviceSocMake (string): marca do principal sistema em um chip do dispositivo, por exemplo, Samsung. Referência
  • deviceSocModel (string): modelo do principal sistema em um chip do dispositivo, por exemplo, "Exynos 2100". Referência
  • deviceCpuMake (string): marca da CPU do dispositivo, por exemplo, Qualcomm.
  • deviceCpuModel (string): modelo da CPU do dispositivo, por exemplo, "Kryo 240".
  • deviceGpuMake (string): fabricante da GPU do dispositivo, por exemplo, ARM.
  • deviceGpuModel (string): modelo da GPU do dispositivo, por exemplo, Mali.
  • deviceGpuVersion (string): versão da GPU do dispositivo, por exemplo, T750.
  • deviceVulkanVersion (string): versão do Vulkan do dispositivo, por exemplo, "4198400".
  • deviceGlEsVersion (string): versão do OpenGL ES do dispositivo, por exemplo, "196610".
  • deviceScreenSize (string): tamanho da tela do dispositivo, por exemplo, NORMAL, LARGE.
  • deviceScreenDpi (string): densidade da tela do dispositivo, por exemplo, mdpi, hdpi.
metrics[]

string

Métricas a serem agregadas.

Métricas compatíveis:

  • crashRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação que tiveram pelo menos uma falha.
  • crashRate7dUserWeighted (google.type.Decimal): valor da média contínua de crashRate nos últimos sete dias. Os valores diários são ponderados pela contagem de usuários distintos do dia.
  • crashRate28dUserWeighted (google.type.Decimal): valor da média contínua de crashRate nos últimos 28 dias. Os valores diários são ponderados pela contagem de usuários distintos do dia. Não é compatível com a granularidade HORÁRIA.
  • userPerceivedCrashRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação que tiveram pelo menos uma falha enquanto usavam o app ativamente (uma falha percebida pelo usuário). Um app é considerado ativo quando está mostrando atividades ou executando qualquer serviço em primeiro plano.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): valor da média contínua de userPerceivedCrashRate nos últimos sete dias. Os valores diários são ponderados pela contagem de usuários distintos do dia. Não é compatível com a granularidade HORÁRIA.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): valor da média contínua de userPerceivedCrashRate nos últimos 28 dias. Os valores diários são ponderados pela contagem de usuários distintos do dia. Não é compatível com a granularidade HORÁRIA.
  • distinctUsers (google.type.Decimal): contagem de usuários distintos no período de agregação que foram usados como valor de normalização para as métricas crashRate e userPerceivedCrashRate. Um usuário é contabilizado nessa métrica se usou o app ativamente durante o período de agregação. Um app é considerado ativo quando está mostrando atividades ou executando qualquer serviço em primeiro plano. Não agregue mais essa contagem, porque isso pode fazer com que os usuários sejam contados várias vezes. O valor é arredondado para o múltiplo mais próximo de 10, 100, 1.000 ou 1.000.000, dependendo da magnitude do valor.
filter

string

Filtros a serem aplicados aos dados. A expressão de filtragem segue o padrão AIP-160 e permite filtrar por igualdade de todas as dimensões de detalhamento.

pageSize

integer

Tamanho máximo dos dados retornados.

Se não for especificado, no máximo 1.000 linhas serão retornadas. O valor máximo é 100.000. Valores maiores serão revertidos para 100.000.

pageToken

string

Um token de página recebido de uma chamada anterior. Forneça isso para recuperar a página subsequente.

Na paginação, todos os outros parâmetros enviados para a solicitação precisam corresponder à chamada que proporcionou o token da página.

userCohort

enum (UserCohort)

Visualização do usuário a ser selecionada. Os dados de saída vão corresponder à visualização selecionada.

Valores aceitos:

  • OS_PUBLIC Para selecionar dados de todas as versões do Android lançadas publicamente. Esse é o padrão. Aceita todas as dimensões acima.
  • APP_TESTERS Para selecionar dados de usuários que aceitaram participar dos testes. Aceita todas as dimensões acima.
  • OS_BETA Para selecionar dados apenas de versões Beta do Android, excluindo dados de versões lançadas do Android. Somente as seguintes dimensões são compatíveis:
  • versionCode (int64): versão do app que estava sendo executada no dispositivo do usuário.

  • osBuild (string): build do SO do dispositivo do usuário, por exemplo, "T1B2.220916.004".

Corpo da resposta

Mensagem de resposta para crashrate.query.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Campos
rows[]

object (MetricsRow)

Linhas de dados retornadas.

nextPageToken

string

Token de continuação para buscar a próxima página de dados.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/playdeveloperreporting

Para mais informações, consulte o OAuth 2.0 Overview.