Method: publishers.items.queryMetrics

Consulta las métricas de un elemento.

Solicitud HTTP

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:queryMetrics

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. Es el nombre del elemento para el que se consultarán las métricas. Formato: publishers/{publisher}/items/{item}

Parámetros de consulta

Parámetros
timeSpec

object (TimeSpec)

Obligatorio. Es la especificación de tiempo para la que se consulta el conjunto de métricas.
metrics[]

string

Obligatorio. Son las métricas para las que se consultará el conjunto de métricas.

Métricas compatibles:

  • installs: Es el recuento de instalaciones de elementos.
  • installs-7d: Es el recuento de instalaciones del elemento en los últimos 7 días.
  • uninstalls: Es el recuento de desinstalaciones del elemento.
  • users: Es el recuento de usuarios activos por día del elemento.
  • users-7d: Es el recuento de usuarios activos del elemento durante 7 días.
  • impressions: Es el recuento de impresiones de artículos en toda la tienda.
  • page-views: Es el recuento de vistas individuales de la página de detalles del elemento.
dimensions[]

string

Opcional. Son las dimensiones por las que se desglosan las métricas. Se puede especificar una dimensión como máximo.

Dimensiones compatibles:

  • os: Es el sistema operativo del usuario.
  • app-version: Es la versión del elemento.
  • country: Es el país del usuario.
  • install-source: Es la fuente de la instalación.
  • install-type: Es el tipo de instalación (desde Chrome Web Store, intercalada o de otro tipo).
  • language: Es el idioma del usuario.
  • enabled: Indica si el elemento está habilitado o inhabilitado.
  • utm-campaign: Es la campaña de UTM del usuario.
  • utm-content: Es el contenido de UTM del usuario.
  • utm-medium: Es el medio de UTM del usuario.
  • utm-source: Es la fuente de UTM del usuario.
  • utm-term: Es el término de UTM del usuario.
pageSize

integer

Opcional. Es la cantidad máxima de filas que se mostrarán. Si no se especifica, se devolverán, como máximo, 100 filas. El valor máximo permitido es 1,000; cualquier cifra mayor a ese valor se limitará automáticamente a 1,000.
pageToken

string

Opcional. Es un token de página, recibido desde una llamada anterior. Proporciona esto para recuperar la página siguiente.

Cuando se realiza la paginación, todos los demás parámetros proporcionados a la solicitud deben coincidir con los de la llamada que proporcionó el token de la página.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para items.queryMetrics.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "metricRows": [
    {
      object (MetricRow)
    }
  ],
  "nextPageToken": string
}
Campos
metricRows[]

object (MetricRow)

Son las filas de métricas.
nextPageToken

string

Es un token que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

TimeSpec

Es un período para consultar métricas.

Representación JSON 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
Campos
firstDate

object (Date)

Opcional. Es la primera fecha (inclusive) de la especificación de tiempo. Si no se establece, no se aplicará ningún límite inferior.
lastDate

object (Date)

Opcional. La última fecha (inclusive) de la especificación de tiempo. Si no se establece, no se aplicará ningún límite superior.

Fecha

Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:

  • Una fecha completa con valores para el año, mes y día que no sean cero.
  • Un mes y un día, con cero año (por ejemplo, un aniversario).
  • Un año por sí solo, con un mes cero y un día cero.
  • Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).

Tipos relacionados:

Representación JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año.
month

integer

Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día.
day

integer

Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo.

MetricRow

Una sola fila de métricas y valores de dimensiones.

Representación JSON 
{
  "date": {
    object (Date)
  },
  "dimensionValues": [
    string
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Campos
date

object (Date)

Es la fecha del registro.
dimensionValues[]

string

Son las columnas de valores de dimensión de la fila.
metricValues[]

object (MetricValue)

Son las columnas de métricas de la fila.

MetricValue

Representa el valor de una sola métrica

Representación JSON 
{
  "metric": string,
  "value": string,
  "uniqueUserCount": string
}
Campos
metric

string

Es el nombre de la métrica.
value

string (int64 format)

Es el valor de la métrica.
uniqueUserCount

string (int64 format)

Es el recuento de usuarios únicos asociado con la métrica (si corresponde).