Affiche un rapport personnalisé de vos données d'événements Google Analytics. Les rapports contiennent des statistiques issues des données collectées par le code de suivi Google Analytics. Les données renvoyées par l'API se présentent sous forme de tableau avec des colonnes pour les dimensions et métriques demandées. Les métriques sont des mesures individuelles de l'activité des utilisateurs sur votre propriété (utilisateurs actifs ou nombre d'événements, par exemple). Les dimensions permettent de ventiler les métriques en fonction de critères courants, comme le pays ou le nom de l'événement.
Requête HTTP
POST https://analyticsdata.googleapis.com/v1alpha:runReport
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 ( |
Champs | |
---|---|
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[] |
Dimensions demandées et affichées. |
metrics[] |
Métriques demandées et affichées. |
dateRanges[] |
Plages de dates correspondant aux données à lire. Si plusieurs plages de dates sont demandées, chaque ligne de réponse contiendra un index de plage de dates basé sur zéro. Si deux plages de dates se chevauchent, les données d'événement des jours concernés sont incluses dans les lignes de réponse pour les deux plages de dates. Dans une demande de cohorte, cet élément |
offset |
Nombre de lignes de la première ligne. La première ligne correspond à la ligne 0. |
limit |
Nombre de lignes à afficher. Si le paramètre |
metricAggregations[] |
Agrégation de métriques. Les valeurs de métriques agrégées s'affichent dans les lignes où les valeurs de dimension sont définies sur "RESERVED_(MetricAggregation)". |
dimensionFilter |
Clause de filtre des dimensions. Vous devez demander des dimensions pour ce filtre. Impossible d'utiliser des métriques dans ce filtre. |
metricFilter |
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. |
orderBys[] |
Spécifie l'ordre des lignes dans la réponse. |
currencyCode |
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 |
Groupe de cohorte associé à cette demande. Si la requête 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, 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 |
Indique si l'état actuel du quota de cette propriété Analytics doit être affiché. Le quota est renvoyé dans PropertyQuota. |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de RunReportResponse
.
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