Method: batchRunPivotReports

Renvoie plusieurs rapports croisés dynamiques à la fois. Tous les rapports doivent concerner la même entité.

Requête HTTP

POST https://analyticsdata.googleapis.com/v1alpha:batchRunPivotReports

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

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

Représentation JSON
{
  "entity": {
    object (Entity)
  },
  "requests": [
    {
      object (RunPivotReportRequest)
    }
  ]
}
Champs
entity

object (Entity)

Une propriété dont les événements font l'objet d'un suivi. Cette entité doit être spécifiée pour le lot. L'entité dans RunPivotReportRequest peut être non spécifiée ou cohérente avec cette entité.

requests[]

object (RunPivotReportRequest)

Requêtes individuelles Chaque demande est associée à une réponse de rapport croisé dynamique. Chaque requête par lot est autorisée jusqu'à cinq requêtes.

Corps de la réponse

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

Réponse par lot contenant plusieurs rapports de tableaux croisés dynamiques.

Représentation JSON
{
  "pivotReports": [
    {
      object (RunPivotReportResponse)
    }
  ]
}
Champs
pivotReports[]

object (RunPivotReportResponse)

Réponses individuelles. Chaque réponse est associée à une demande de rapport croisé dynamique.

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

RunPivotReportRequest

Demande de génération d'un rapport croisé dynamique.

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

object (Entity)

Une propriété dont les événements font l'objet d'un suivi. Dans une requête par lot, cette entité ne doit pas être spécifiée ou cohérente avec l'entité au niveau du lot.

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, orderBys.

metrics[]

object (Metric)

Métriques demandées. Vous devez en spécifier au moins une. Toutes les métriques définies doivent être utilisées par l'une des options suivantes: metric_expression, metricFilter ou orderBys.

dimensionFilter

object (FilterExpression)

Clause de filtre des dimensions. Vous devez demander des dimensions pour ce filtre. Impossible d'utiliser des métriques dans ce filtre.

metricFilter

object (FilterExpression)

Clause de filtre des métriques. Appliquée lors de la phase post-agrégation, de la même manière que la clause SQL existante. Des métriques doivent être demandées pour être utilisées dans ce filtre. Impossible d'utiliser des dimensions avec ce filtre.

pivots[]

object (Pivot)

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

dateRanges[]

object (DateRange)

Plage de dates pour laquelle récupérer les données d'événement pour le rapport. Si plusieurs plages de dates sont spécifiées, les données d'événement de chacune d'elles sont utilisées dans le rapport. Vous pouvez inclure une dimension spéciale portant le nom de champ "dateRange" dans les noms des champs d'un tableau croisé dynamique. Le cas échéant, le rapport compare les données entre les plages de dates. Dans une demande de cohorte, cet élément dateRanges ne doit pas être spécifié.

currencyCode

string

Code de devise au format ISO 4217, tel que "AED", "USD" ou "JPY". Si le champ est vide, le rapport utilise la devise par défaut de l'entité.

cohortSpec

object (CohortSpec)

Groupe de cohorte associé à cette demande. Si la requête comporte un groupe de cohorte, la dimension "cohorte" doit être présente.

keepEmptyRows

boolean

Si la valeur est "false" ou n'est pas spécifiée, aucune ligne dont toutes les métriques sont égales à 0 ne sera pas renvoyée. Si la valeur est "true", ces lignes sont renvoyées si un filtre ne les a pas supprimées séparément.

returnPropertyQuota

boolean

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