Method: properties.runPivotReport

Renvoie un rapport croisé dynamique personnalisé de vos données d'événements Google Analytics. Les rapports croisés sont des formats plus avancés et plus expressifs que les rapports standards. Dans un rapport croisé dynamique, les dimensions ne sont visibles que si elles sont incluses dans un pivot. Vous pouvez spécifier plusieurs pivots pour analyser plus en détail vos données.

Requête HTTP

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
property

string

Identifiant d'une propriété Google Analytics dont les événements sont suivis. Spécifié dans le chemin d'URL et non dans le corps. Pour en savoir plus, consultez Où trouver votre ID de propriété. Dans une requête par lot, cette propriété doit être non spécifiée ou cohérente avec la propriété au niveau du lot.

Exemple: properties/1234

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
Champs
dimensions[]

object (Dimension)

Dimensions demandées. Toutes les dimensions définies doivent être utilisées par l'un des éléments suivants: dimensionExpression, dimensionFilter, pivots ou orderBys.
metrics[]

object (Metric)

Vous devez spécifier au moins une métrique parmi celles demandées. Toutes les métriques définies doivent être utilisées par l'un des éléments suivants: metric_expression, metricFilter ou orderBys.
dateRanges[]

object (DateRange)

Plage de dates pour récupérer les données d'événement pour le rapport. Si vous spécifiez plusieurs périodes, les données d'événement de chaque période sont utilisées dans le rapport. Une dimension spéciale avec le nom de champ "dateRange" peut être incluse dans les noms de champ d'un tableau croisé dynamique. Si elle est incluse, le rapport compare les périodes. Dans une requête de cohorte, ce dateRanges ne doit pas être spécifié.
pivots[]

object (Pivot)

Décrit le format visuel des dimensions du rapport en colonnes ou en lignes. L'union des fieldNames (noms de dimension) de tous les pivots doit être un sous-ensemble des noms de dimension définis dans "Dimensions". Deux tableaux croisés dynamiques ne peuvent pas partager une dimension. Une dimension n'est visible que si elle apparaît dans un tableau croisé dynamique.
dimensionFilter

object (FilterExpression)

Clause de filtre des dimensions. Vous devez demander à utiliser des dimensions dans ce filtre. Vous ne pouvez pas utiliser de métriques dans ce filtre.
metricFilter

object (FilterExpression)

Clause de filtre des métriques. Appliqué à la phase post-agrégation, semblable à la clause "having" en SQL. Les métriques doivent être demandées pour être utilisées dans ce filtre. Vous ne pouvez pas utiliser de dimensions dans ce filtre.
currencyCode

string

Code de devise au format ISO 4217, par exemple "AED", "USD" ou "JPY". Si le champ est vide, le rapport utilise la devise par défaut de la propriété.
cohortSpec

object (CohortSpec)

Groupe de cohorte associé à cette requête. Si un groupe de cohortes est présent dans la requête, la dimension "cohorte" doit être présente.
keepEmptyRows

boolean

Si la valeur est "false" ou non spécifiée, chaque ligne dont toutes les métriques sont égales à 0 ne sera pas renvoyée. Si cette valeur est définie sur "true", ces lignes sont renvoyées si elles ne sont pas supprimées séparément par un filtre.

Quel que soit ce paramètre keepEmptyRows, seules les données enregistrées par la propriété Google Analytics peuvent être affichées dans un rapport.

Par exemple, si une propriété ne consigne jamais d'événement purchase, une requête pour la dimension eventName et la métrique eventCount n'aura pas de ligne eventName: "purchase" et eventCount: 0.
returnPropertyQuota

boolean

Indique si l'état actuel du quota de cette propriété Google Analytics doit être renvoyé. Le quota est renvoyé dans PropertyQuota.
comparisons[]

object (Comparison)

Facultatif. Configuration des comparaisons demandées et affichées. La requête nécessite à la fois un champ de comparaison et une dimension de comparaison pour recevoir une colonne de comparaison dans la réponse.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de RunPivotReportResponse.

Champs d'application des autorisations

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

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