- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- RunPivotReportRequest
- Essayer
Renvoie plusieurs rapports croisés dynamiques dans un lot. Tous les rapports doivent concerner la même propriété GA4.
Requête HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunPivotReports
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
property |
Identifiant de propriété Google Analytics GA4 dont les événements font l'objet d'un suivi. Les valeurs sont spécifiées dans le chemin de l'URL et non dans le corps. Pour en savoir plus, découvrez où trouver votre ID de propriété. Cette propriété doit être spécifiée pour le lot. La propriété dans RunPivotReportRequest peut être non spécifiée ou cohérente avec cette propriété. Exemple: propriétés/1234 |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{
"requests": [
{
object ( |
Champs | |
---|---|
requests[] |
Requêtes individuelles Chaque demande dispose d'une réponse distincte pour le rapport croisé dynamique. Chaque requête par lot est autorisée jusqu'à cinq requêtes. |
Corps de la réponse
Réponse par lot contenant plusieurs rapports croisés dynamiques.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"pivotReports": [
{
object ( |
Champs | |
---|---|
pivotReports[] |
Réponses individuelles. Chaque réponse est associée à une demande de rapport croisé dynamique. |
kind |
Identifie le type de ressource de ce message. L'élément |
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 |
---|
{ "property": string, "dimensions": [ { object ( |
Champs | |
---|---|
property |
Identifiant de propriété Google Analytics GA4 dont les événements font l'objet d'un suivi. Les valeurs sont spécifiées dans le chemin de l'URL et non dans le corps. Pour en savoir plus, découvrez où trouver votre ID de propriété. Dans une requête par lot, cette propriété ne doit pas être spécifiée ou doit correspondre à la propriété au niveau du lot. Exemple: propriétés/1234 |
dimensions[] |
Dimensions demandées. Toutes les dimensions définies doivent être utilisées par l'un des éléments suivants: dimensionExpression, dimensionFilter, pivots, orderBys. |
metrics[] |
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. |
dateRanges[] |
Période au cours de laquelle les données d'événements du rapport doivent être récupérées. Si plusieurs plages de dates sont spécifiées, les données d'événements 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 de champs d'un tableau croisé dynamique. Si vous l'incluez, le rapport effectue une comparaison entre les plages de dates. Dans une demande de cohorte, cet |
pivots[] |
Décrit le format visuel des dimensions du rapport sous forme de colonnes ou de lignes. L'union des noms de champ (fieldNames) (noms de dimensions) 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 partager une dimension. Une dimension n'est visible que si elle apparaît dans un tableau croisé dynamique. |
dimensionFilter |
Clause de filtrage des dimensions. Vous devez demander à utiliser des dimensions dans ce filtre. Impossible d'utiliser des métriques avec ce filtre. |
metricFilter |
Clause de filtre des métriques. Appliquée à la phase post-agrégation, semblable à 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. |
currencyCode |
Code de devise au format ISO4217, tel que "AED", "USD" ou "JPY". Si le champ est vide, le rapport utilise la devise par défaut de la propriété. |
cohortSpec |
Groupe de cohorte associé à cette demande. Si la demande comporte un groupe de cohorte, la dimension "cohorte" doit être présente. |
keepEmptyRows |
Si la valeur est "false" ou n'est pas spécifiée, chaque 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 elles ne sont pas supprimées séparément par un filtre. Quel que soit le paramètre Par exemple, si une propriété ne consigne jamais d'événement |
returnPropertyQuota |
Détermine si l'état actuel du quota de cette propriété Analytics doit être renvoyé. Le quota est renvoyé dans PropertyQuota. |