Method: vitals.crashrate.query
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Consulta as métricas no conjunto de métricas.
Solicitação HTTP
POST https://playdeveloperreporting.googleapis.com/v1alpha1/{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:
|
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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eThis endpoint allows you to query crash rate metrics for your app using the Play Developer Reporting API.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify the timeline, dimensions, metrics, and filters for your query in the request body.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes rows of data corresponding to your query and a token for pagination if necessary.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This outlines how to query metrics in a crash rate metric set via a POST request to a specific URL. The request body requires parameters like `timelineSpec` for aggregation periods, `dimensions` to segment metrics (e.g., `apiLevel`, `deviceModel`), and `metrics` to define data points (e.g., `crashRate`). Filters, `pageSize`, `pageToken`, and `userCohort` options are available. The response includes `rows` of metric data and `nextPageToken` for pagination, and it uses OAuth 2.0 authorization.\n"],null,[]]