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."],[],["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"]]