Method: vitals.stuckbackgroundwakelockrate.query

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

Solicitação HTTP

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/stuckBackgroundWakelockRateMetricSet}: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}/stuckBackgroundWakelockRateMetricSet

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 aceito é America/Los_Angeles.
dimensions[]

string

Dimensões pelas quais os dados serão divididos.

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:

  • stuckBgWakelockRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação que tiveram um wake lock em segundo plano por mais de uma hora.
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal): valor médio contínuo de stuckBgWakelockRate nos últimos 7 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia.
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal): valor médio contínuo de stuckBgWakelockRate nos últimos 28 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia.
  • distinctUsers (google.type.Decimal): contagem de usuários distintos no período de agregação que foram usados como valor de normalização para a métrica stuckBgWakelockRate. Um usuário é contabilizado nessa métrica se o app estiver realizando algum trabalho no dispositivo, ou seja, não apenas no uso ativo em primeiro plano, mas também trabalho em segundo 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 stuckbackgroundwakelockrate.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.