Method: publishers.items.queryMetrics

Interrogez les métriques d'un élément.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de l'élément pour lequel interroger les métriques. Format : publishers/{publisher}/items/{item}

Paramètres de requête

Paramètres
timeSpec

object (TimeSpec)

Obligatoire. Spécification de temps pour laquelle interroger l'ensemble de métriques.
metrics[]

string

Obligatoire. Métriques pour lesquelles interroger l'ensemble de métriques.

Métriques acceptées :

  • installs : nombre d'installations de l'élément.
  • installs-7d : nombre d'installations de l'élément au cours des sept derniers jours.
  • uninstalls : nombre de désinstallations de l'élément.
  • users : nombre d'utilisateurs actifs par jour de l'élément.
  • users-7d : nombre d'utilisateurs actifs de l'élément sur sept jours.
  • impressions : nombre d'impressions d'articles sur l'ensemble de la vitrine.
  • page-views : nombre de vues individuelles de la page d'informations de l'élément.
dimensions[]

string

Facultatif. Dimensions selon lesquelles segmenter les métriques. Vous ne pouvez spécifier qu'une seule dimension.

Dimensions acceptées :

  • os : système d'exploitation de l'utilisateur.
  • app-version : version de l'article.
  • country : pays de l'utilisateur.
  • install-source : source de l'installation.
  • install-type : type d'installation (depuis le Web Store, intégrée ou autre).
  • language : langue de l'utilisateur.
  • "enabled" : indique si l'élément est activé ou désactivé.
  • utm-campaign : campagne UTM de l'utilisateur.
  • utm-content : contenu UTM de l'utilisateur.
  • utm-medium : support UTM de l'utilisateur.
  • utm-source : source UTM de l'utilisateur.
  • utm-term : terme UTM de l'utilisateur.
pageSize

integer

Facultatif. Nombre maximal de lignes à renvoyer. Si aucune valeur n'est spécifiée, 100 lignes au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
pageToken

string

Facultatif. Jeton de page reçu d'un appel précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à la requête doivent correspondre à l'appel ayant fourni le jeton de page.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour items.queryMetrics.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "metricRows": [
    {
      object (MetricRow)
    }
  ],
  "nextPageToken": string
}
Champs
metricRows[]

object (MetricRow)

Lignes de métriques.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

TimeSpec

Plage de dates pour l'interrogation des métriques.

Représentation JSON 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
Champs
firstDate

object (Date)

Facultatif. Première date (incluse) de la spécification temporelle. Si elle n'est pas définie, aucune limite inférieure ne sera appliquée.
lastDate

object (Date)

Facultatif. Dernière date (incluse) de la spécification temporelle. Si elle n'est pas définie, aucune limite supérieure ne sera appliquée.

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date correspond au calendrier grégorien proleptique. Il peut s'agir de l'un des éléments suivants :

  • Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
  • Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
  • Une année seule, avec un mois et un jour nuls.
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés :

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Elle doit être comprise entre 1 et 9 999, ou égale à 0 si vous spécifiez une date sans année.
month

integer

Mois d'une année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une année sans mois ni jour.
day

integer

Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez une année seule, ou une année et un mois où le jour n'est pas significatif.

MetricRow

Une seule ligne de valeurs de métriques et de dimensions.

Représentation JSON 
{
  "date": {
    object (Date)
  },
  "dimensionValues": [
    string
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Champs
date

object (Date)

Date de l'enregistrement.
dimensionValues[]

string

Colonnes de valeurs de dimension pour la ligne.
metricValues[]

object (MetricValue)

Colonnes de métriques pour la ligne.

MetricValue

Représente la valeur d'une seule métrique.

Représentation JSON 
{
  "metric": string,
  "value": string,
  "uniqueUserCount": string
}
Champs
metric

string

Nom de la métrique
value

string (int64 format)

Valeur de la métrique.
uniqueUserCount

string (int64 format)

Nombre d'utilisateurs uniques associé à la métrique (le cas échéant).