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 compatíveis:

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

string

Dimensões pelas quais as métricas serão divididas.

Dimensões compatíveis:

  • apiLevel (string): o nível da API do Android que estava sendo executado no dispositivo do usuário, por exemplo, 26.
  • versionCode (int64): versão do app que estava em execução 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, TELEFONE.
  • 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 buckets (3 GB, 4 GB etc.).
  • deviceSocMake (string): marca do system on chip principal do dispositivo, por exemplo, Samsung. Referência
  • deviceSocModel (string): modelo do system on chip principal 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): marca 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, como Conexão T750
  • deviceVulkanVersion (string): versão Vulkan do dispositivo, como "4198400".
  • deviceGlEsVersion (string): versão do OpenGL ES do dispositivo, como e "196610".
  • deviceScreenSize (string): tamanho da tela do dispositivo. Por exemplo, NORMAL, GRANDE.
  • 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 médio contínuo de crashRate nos últimos 7 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia.
  • crashRate28dUserWeighted (google.type.Decimal): valor médio contínuo de crashRate nos últimos 28 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Sem suporte na granularidade de HOURLY.
  • userPerceivedCrashRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação que tiveram pelo menos uma falha enquanto estavam usando o app ativamente (uma falha percebida pelo usuário). Um app é considerado ativo quando está exibindo atividades ou executando serviços em primeiro plano.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): valor médio contínuo de userPerceivedCrashRate nos últimos 7 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Sem suporte na granularidade de HOURLY.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): valor médio contínuo de userPerceivedCrashRate nos últimos 28 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Sem suporte na granularidade de HOURLY.
  • 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 tiver usado o app ativamente durante o período de agregação. Um app é considerado ativo quando está exibindo atividades ou executando serviços em primeiro plano. Tome cuidado para não agregar mais essa contagem, já que 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 é compatível com a filtragem 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 acima desse valor serão convertidos para 100.000.

pageToken

string

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

Ao paginar, todos os outros parâmetros fornecidos à solicitação precisam corresponder à chamada que forneceu o token da página.

userCohort

enum (UserCohort)

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

Valores aceitos:

  • OS_PUBLIC Para selecionar dados de todas as versões do Android lançadas publicamente. Esse é o padrão. Oferece suporte a todas as dimensões acima.
  • APP_TESTERS Para selecionar dados de usuários que aceitaram participar do teste. Oferece suporte a todas as dimensões acima.
  • OS_BETA Para selecionar dados somente de versões Beta do Android, excluindo os dados das versões lançadas. Somente as seguintes dimensões são suportadas:
  • versionCode (int64): versão do app que estava em execução 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 a Visão geral do OAuth 2.0.