REST Resource: properties.reportTasks

Ressource: ReportTask

Une configuration de tâche de rapport spécifique.

Représentation JSON 
{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}
Champs
name

string

Uniquement en sortie. Identifiant. Nom de la ressource de tâche de rapport attribué lors de la création. Format: "properties/{property}/reportTasks/{reportTask}"
reportDefinition

object (ReportDefinition)

Facultatif. Définition de rapport permettant d'extraire les données d'un rapport, qui décrit la structure d'un rapport. Il inclut généralement les champs qui seront inclus dans le rapport et les critères qui seront utilisés pour filtrer les données.
reportMetadata

object (ReportMetadata)

Uniquement en sortie. Métadonnées d'un rapport pour une tâche spécifique, qui fournissent des informations sur un rapport. Il comprend généralement les informations suivantes: le nom de la ressource du rapport, l'état du rapport, la date et l'heure de création du rapport, etc.

ReportDefinition

Définition du mode d'exécution d'un rapport.

Représentation JSON 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean
}
Champs
dimensions[]

object (Dimension)

Facultatif. Dimensions demandées et affichées.
metrics[]

object (Metric)

Facultatif. Métriques demandées et affichées.
dateRanges[]

object (DateRange)

Facultatif. 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 dateRanges ne doit pas être spécifié.
dimensionFilter

object (FilterExpression)

Facultatif. Les filtres de dimensions vous permettent de ne demander que des valeurs de dimensions spécifiques dans le rapport. Pour en savoir plus et obtenir des exemples, consultez l'article Principes de base des filtres de dimensions. Impossible d'utiliser des métriques dans ce filtre.
metricFilter

object (FilterExpression)

Facultatif. Clause de filtre des métriques. Appliqué après l'agrégation des lignes du rapport, semblable à la clause SQL existante. Impossible d'utiliser des dimensions avec ce filtre.
offset

string (int64 format)

Facultatif. Nombre de lignes de la première ligne provenant de l'espace de stockage Google Analytics. La première ligne correspond à la ligne 0.

Lorsque vous créez une tâche de rapport, les paramètres offset et limit définissent le sous-ensemble de lignes de données de l'espace de stockage Google Analytics à inclure dans le rapport généré. Par exemple, si l'espace de stockage Google Analytics totalise 300 000 lignes, la tâche de rapport initiale peut inclure les 10 000 premières lignes, avec une limite de 10 000 et un décalage de 0. Par la suite, une autre tâche de rapport peut couvrir les 10 000 lignes suivantes avec une limite de 10 000 et un décalage de 10 000.
limit

string (int64 format)

Facultatif. Nombre de lignes à afficher dans le rapport. Si aucune valeur n'est spécifiée, 10 000 lignes sont renvoyées. L'API renvoie un maximum de 250 000 lignes par requête, quel que soit le nombre demandé. limit doit être positif.

L'API peut également renvoyer moins de lignes que le limit demandé, s'il n'y a pas autant de valeurs de dimension que le limit. Par exemple, il existe moins de 300 valeurs possibles pour la dimension "country". Par conséquent, lorsque vous créez un rapport ne portant que sur "country", vous ne pouvez pas obtenir plus de 300 lignes, même si vous avez défini une valeur supérieure pour "limit".
metricAggregations[]

enum (MetricAggregation)

Facultatif. 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)".
orderBys[]

object (OrderBy)

Facultatif. Spécifie l'ordre des lignes dans la réponse.
currencyCode

string

Facultatif. 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 la propriété.
cohortSpec

object (CohortSpec)

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

boolean

Facultatif. 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.

Quel que soit le paramètre keepEmptyRows, seules les données enregistrées par la propriété Google Analytics (GA4) 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 contenant eventName: "purchase" et eventCount: 0.

Dimension

Les dimensions correspondent aux attributs de vos données. Par exemple, la dimension "ville" indique la ville d'origine d'un événement. Dans les réponses aux rapports, les valeurs des dimensions sont des chaînes. Par exemple, la ville peut être "Paris" ou "New York".

Représentation JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Champs
name

string

Nom de la dimension. Consultez les dimensions de l'API pour obtenir la liste des noms de dimensions acceptés par les principales méthodes de création de rapports, telles que runReport et batchRunReports. Consultez Dimensions en temps réel pour obtenir la liste des noms de dimensions compatibles avec la méthode runRealtimeReport. Consultez Dimensions de l'entonnoir pour obtenir la liste des noms de dimensions compatibles avec la méthode runFunnelReport.

Si dimensionExpression est spécifié, name peut être n'importe quelle chaîne de votre choix, comprise dans le jeu de caractères autorisé. Par exemple, si une dimension dimensionExpression concatène country et city, vous pouvez appeler cette dimension countryAndCity. Les noms de dimension que vous choisissez doivent correspondre à l'expression régulière ^[a-zA-Z0-9_]$.

Les dimensions sont référencées par name dans dimensionFilter, orderBys, dimensionExpression et pivots.
dimensionExpression

object (DimensionExpression)

Une dimension peut être le résultat de l'expression de plusieurs dimensions. Par exemple, dimension "pays, ville": concatenate(country, ", ", city).

DimensionExpression

Permet d'exprimer une dimension résultant d'une formule de plusieurs dimensions. Exemples d'utilisation: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).

Représentation JSON 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Champs
Champ d'union one_expression. Spécifiez un type d'expression de dimension pour DimensionExpression. La one_expression ne peut être qu'un des éléments suivants :
lowerCase

object (CaseExpression)

Permet de convertir une valeur de dimension en minuscules.
upperCase

object (CaseExpression)

Permet de convertir une valeur de dimension en majuscules.
concatenate

object (ConcatenateExpression)

Permet de combiner des valeurs de dimension en une seule. Par exemple, dimension "pays, ville": concatenate(country, ", ", city).

CaseExpression

Permet de convertir une valeur de dimension en une casse.

Représentation JSON 
{
  "dimensionName": string
}
Champs
dimensionName

string

Nom d'une dimension. Le nom doit faire référence à un nom indiqué dans le champ de dimensions de la requête.

ConcatenateExpression

Permet de combiner des valeurs de dimension en une seule.

Représentation JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Champs
dimensionNames[]

string

Noms des dimensions. Les noms doivent faire référence aux noms indiqués dans le champ de dimensions de la requête.
delimiter

string

Délimiteur placé entre les noms de dimension.

Les délimiteurs sont souvent des caractères uniques tels que "|" ou ", mais peuvent être des chaînes plus longues. Si une valeur de dimension contient le délimiteur, les deux seront présentes dans la réponse sans distinction. Par exemple, si la valeur de la dimension 1 = "US,FR", la dimension 2 = "JP" et le séparateur = ", la réponse contiendra "US,FR,JP".

Métrique

Mesures quantitatives d'un rapport. Par exemple, la métrique eventCount correspond au nombre total d'événements. Les requêtes peuvent contenir jusqu'à 10 métriques.

Représentation JSON 
{
  "name": string,
  "expression": string,
  "invisible": boolean
}
Champs
name

string

Nom de la métrique. Consultez la page Métriques de l'API pour obtenir la liste des noms de métriques acceptés par les principales méthodes de création de rapports, telles que runReport et batchRunReports. Consultez Métriques en temps réel pour obtenir la liste des noms de métriques compatibles avec la méthode runRealtimeReport. Consultez Métriques de l'entonnoir pour obtenir la liste des noms de métriques acceptés par la méthode runFunnelReport.

Si expression est spécifié, name peut être n'importe quelle chaîne de votre choix, comprise dans le jeu de caractères autorisé. Par exemple, si expression correspond à screenPageViews/sessions, vous pouvez nommer cette métrique comme viewsPerSession. Les noms de métriques que vous choisissez doivent correspondre à l'expression régulière ^[a-zA-Z0-9_]$.

Les métriques sont référencées par name dans metricFilter, orderBys et la métrique expression.
expression

string

Expression mathématique pour les métriques dérivées. Par exemple, la métrique "Nombre d'événements par utilisateur" est de eventCount/totalUsers.
invisible

boolean

Indique si une métrique est invisible dans la réponse du rapport. Si une métrique n'est pas visible, elle ne génère pas de colonne dans la réponse, mais peut être utilisée dans metricFilter, orderBys ou une métrique expression.

DateRange

Un ensemble de jours contigu: startDate, startDate + 1, ..., endDate. Jusqu'à quatre plages de dates sont autorisées pour les demandes.

Représentation JSON 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Champs
startDate

string

Date de début (incluse) de la requête au format YYYY-MM-DD. Ne peut pas être postérieure au endDate. Le format NdaysAgo, yesterday ou today est également accepté. Dans ce cas, la date est déduite du fuseau horaire de la propriété pour les rapports.
endDate

string

Date de fin inclusive de la requête au format YYYY-MM-DD. Ne peut pas être antérieur au startDate. Le format NdaysAgo, yesterday ou today est également accepté. Dans ce cas, la date est déduite du fuseau horaire de la propriété pour les rapports.
name

string

Attribue un nom à cette plage de dates. La dimension dateRange est associée à ce nom dans une réponse de rapport. Si cette règle est définie, elle ne peut pas commencer par date_range_ ni RESERVED_. Si ce champ n'est pas spécifié, les plages de dates sont nommées par leur index basé sur zéro dans la requête: date_range_0, date_range_1, etc.

FilterExpression

Pour exprimer des filtres de dimensions ou de métriques. Les champs d'une même FilterExpression doivent être tous des dimensions ou toutes des métriques.

Représentation JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
Champs
Champ d'union expr. Spécifiez un type d'expression de filtre pour FilterExpression. La expr ne peut être qu'un des éléments suivants :
andGroup

object (FilterExpressionList)

Les objets FilterExpressions dans andGroup ont une relation AND.
orGroup

object (FilterExpressionList)

Les FilterExpressions dans orGroup ont une relation OR.
notExpression

object (FilterExpression)

FilterExpression n'est PAS notExpression.
filter

object (Filter)

Un filtre primitif. Dans la même "FilterExpression", tous les noms de champs du filtre doivent correspondre à toutes les dimensions ou à toutes les métriques.

FilterExpressionList

Liste d'expressions de filtre.

Représentation JSON 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Champs
expressions[]

object (FilterExpression)

Liste d'expressions de filtre.

Filtre

Expression permettant de filtrer les valeurs des dimensions ou des métriques.

Représentation JSON 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Champs
fieldName

string

Nom de la dimension ou de la métrique. Vous devez définir un nom dans les dimensions ou les métriques.
Champ d'union one_filter. Spécifiez un type de filtre pour Filter. La one_filter ne peut être qu'un des éléments suivants :
stringFilter

object (StringFilter)

Filtre lié aux chaînes.
inListFilter

object (InListFilter)

Filtre pour les valeurs dans la liste.
numericFilter

object (NumericFilter)

Filtre pour les valeurs numériques ou les dates.
betweenFilter

object (BetweenFilter)

Filtre entre deux valeurs.

StringFilter

Filtre de chaîne

Représentation JSON 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Champs
matchType

enum (MatchType)

Type de correspondance de ce filtre.
value

string

Valeur de chaîne utilisée pour la mise en correspondance.
caseSensitive

boolean

Si la valeur est "true", la valeur de la chaîne est sensible à la casse.

MatchType

Type de correspondance d'un filtre de chaîne

Enums
MATCH_TYPE_UNSPECIFIED Non spécifié
EXACT Correspondance exacte de la valeur de la chaîne.
BEGINS_WITH Commence par la valeur de la chaîne.
ENDS_WITH Se termine par la valeur de la chaîne.
CONTAINS Contient la valeur de la chaîne.
FULL_REGEXP Correspondance complète pour l'expression régulière avec la valeur de la chaîne.
PARTIAL_REGEXP Correspondance partielle pour l'expression régulière avec la valeur de la chaîne.

InListFilter

Le résultat doit se trouver dans une liste de valeurs de chaîne.

Représentation JSON 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Champs
values[]

string

Liste des valeurs de chaîne. Ce champ ne doit pas être vide.
caseSensitive

boolean

Si la valeur est "true", la valeur de la chaîne est sensible à la casse.

NumericFilter

Filtres pour les valeurs numériques ou les dates

Représentation JSON 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Champs
operation

enum (Operation)

Type d'opération pour ce filtre.
value

object (NumericValue)

Valeur numérique ou date.

Opération

Opération appliquée à un filtre numérique

Enums
OPERATION_UNSPECIFIED URL indéterminée.
EQUAL Égal à
LESS_THAN Moins de
LESS_THAN_OR_EQUAL Inférieur(e) ou égal(e) à
GREATER_THAN Supérieur(e) à
GREATER_THAN_OR_EQUAL Supérieur(e) ou égal(e) à

NumericValue

Représenter un nombre.

Représentation JSON 
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
Champs
Champ d'union one_value. L'une des valeurs numériques one_value ne peut être qu'une seule des valeurs suivantes:
int64Value

string (int64 format)

Valeur entière
doubleValue

number

Valeur double

BetweenFilter

Pour exprimer que le résultat doit être compris entre deux nombres (inclus)

Représentation JSON 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Champs
fromValue

object (NumericValue)

Commence par ce nombre.
toValue

object (NumericValue)

Se termine par ce numéro.

MetricAggregation

Représente l'agrégation de métriques.

Enums
METRIC_AGGREGATION_UNSPECIFIED Opérateur non spécifié.
TOTAL SOMME.
MINIMUM Opérateur minimum.
MAXIMUM Opérateur maximum.
COUNT Opérateur "count".

OrderBy

La fonction "Order by" définit la manière dont les lignes seront triées dans la réponse. Par exemple, le tri des lignes par nombre d'événements décroissant est un ordre de tri, tandis que celui par chaîne de nom d'événement est différent.

Représentation JSON 
{
  "desc": boolean,

  // Union field one_order_by can be only one of the following:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of list of possible types for union field one_order_by.
}
Champs
desc

boolean

Si la valeur est "true", les résultats sont triés par ordre décroissant.
Champ d'union one_order_by. Spécifiez un type de tri pour OrderBy. La one_order_by ne peut être qu'un des éléments suivants :
metric

object (MetricOrderBy)

Trie les résultats en fonction des valeurs d'une métrique.
dimension

object (DimensionOrderBy)

Trie les résultats en fonction des valeurs d'une dimension.

MetricOrderBy

Trie par valeurs de métriques.

Représentation JSON 
{
  "metricName": string
}
Champs
metricName

string

Nom de métrique dans la requête de tri.

DimensionOrderBy

Trie par valeurs de dimension.

Représentation JSON 
{
  "dimensionName": string,
  "orderType": enum (OrderType)
}
Champs
dimensionName

string

Nom de dimension dans la demande de tri.
orderType

enum (OrderType)

Contrôle la règle d'ordre des valeurs de dimension.

OrderType

Règle selon laquelle classer les valeurs de dimension de chaîne.

Enums
ORDER_TYPE_UNSPECIFIED URL indéterminée.
ALPHANUMERIC Tri alphanumérique par point de code Unicode. Par exemple, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC Tri par point de code Unicode en minuscules/majuscules non sensibles à la casse Par exemple, "2" < "A" < "b" < "X" < "z".
NUMERIC Les valeurs des dimensions sont converties en nombres avant le tri. Par exemple, dans le tri NUMERIC, "25" < "100", et dans le tri ALPHANUMERIC, "100 < 25". Les valeurs de dimension non numériques ont toutes une valeur de tri égale sous toutes les valeurs numériques.

CohortSpec

Spécification des cohortes pour un rapport sur les cohortes.

Les rapports sur les cohortes créent une série temporelle de fidélisation des utilisateurs pour la cohorte. Par exemple, vous pouvez sélectionner la cohorte d'utilisateurs acquis au cours de la première semaine de septembre et la suivre pendant les six semaines suivantes. La sélection des utilisateurs acquis au cours de la première semaine de la cohorte de septembre est spécifiée dans l'objet cohort. Ensuite, la cohorte pour les six prochaines semaines est spécifiée dans l'objet cohortsRange.

Vous trouverez des exemples dans l'article Exemples de rapports sur les cohortes.

La réponse du rapport peut afficher une série temporelle hebdomadaire dans laquelle votre application a conservé 60% de cette cohorte après trois semaines et 25% de cette cohorte après six semaines. Ces deux pourcentages peuvent être calculés par la métrique cohortActiveUsers/cohortTotalUsers et figureront sur des lignes distinctes dans le rapport.

Représentation JSON 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Champs
cohorts[]

object (Cohort)

Définit les critères de sélection pour regrouper les utilisateurs dans des cohortes.

La plupart des rapports sur les cohortes ne définissent qu'une seule cohorte. Si vous spécifiez plusieurs cohortes, vous pourrez les reconnaître dans le rapport grâce à leur nom.
cohortsRange

object (CohortsRange)

Les rapports sur les cohortes suivent les cohortes sur une période étendue. Cette plage spécifie une durée de décalage à suivre pour suivre les cohortes.
cohortReportSettings

object (CohortReportSettings)

Paramètres facultatifs pour un rapport sur les cohortes.

Cohort

Définit les critères de sélection des cohortes. Une cohorte est un groupe d'utilisateurs qui partagent une caractéristique commune. Par exemple, les utilisateurs ayant le même firstSessionDate appartiennent à la même cohorte.

Représentation JSON 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Champs
name

string

Attribue un nom à cette cohorte. La dimension cohort est associée à ce nom dans une réponse de rapport. Si cette règle est définie, elle ne peut pas commencer par cohort_ ni RESERVED_. Si ce champ n'est pas défini, les cohortes sont nommées en fonction de leur indice base zéro cohort_0, cohort_1, etc.
dimension

string

Dimension utilisée par la cohorte. Obligatoire et compatible uniquement avec firstSessionDate.
dateRange

object (DateRange)

La cohorte sélectionne les utilisateurs dont la date de premier contact est comprise entre les dates de début et de fin définies dans l'dateRange. Ce champ dateRange ne spécifie pas la plage de dates complète des données d'événement présentes dans un rapport sur les cohortes. Dans un rapport sur les cohortes, ce dateRange est étendu par la précision et le décalage présents dans le cohortsRange. Les données d'événement pour la période étendue du rapport sont présentes dans un rapport sur les cohortes.

Dans une demande de cohorte, ce dateRange est obligatoire, et le dateRanges de RunReportRequest ou de RunPivotReportRequest ne doit pas être spécifié.

Cet élément dateRange doit généralement être aligné sur la précision de la cohorte. Si CohortsRange utilise une précision quotidienne, dateRange peut correspondre à un seul jour. Si CohortsRange utilise une précision hebdomadaire, cet élément dateRange peut être aligné sur une limite de semaine, du dimanche au samedi. Si CohortsRange utilise une précision mensuelle, cette dateRange peut être alignée sur un mois, du premier au dernier jour du mois.

CohortsRange

Permet de configurer la plage de dates étendue pour un rapport sur les cohortes. Spécifie la durée de décalage à suivre pour suivre les cohortes.

Représentation JSON 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Champs
granularity

enum (Granularity)

Obligatoire. Précision utilisée pour interpréter les valeurs startOffset et endOffset pour la période étendue d'un rapport sur les cohortes.
startOffset

integer

startOffset indique la date de début de la période étendue d'un rapport sur les cohortes. startOffset est généralement défini sur 0 afin que les rapports contiennent les données collectées à partir de l'acquisition de la cohorte.

Si granularity est défini sur DAILY, la valeur startDate de la période de référence étendue correspond à startDate de la cohorte plus startOffset jours.

Si granularity est défini sur WEEKLY, la valeur startDate de la période de référence étendue correspond à startDate de la cohorte plus startOffset * 7 jours.

Si granularity est défini sur MONTHLY, la valeur startDate de la période de référence étendue correspond à startDate de la cohorte plus startOffset * 30 jours.
endOffset

integer

Obligatoire. endOffset indique la date de fin de la période de référence étendue d'un rapport sur les cohortes. endOffset peut être n'importe quel entier positif, mais il est généralement défini sur une valeur comprise entre 5 et 10, afin que les rapports contiennent des données sur la cohorte pour les périodes de précision suivantes.

Si granularity est défini sur DAILY, la valeur endDate de la période de référence étendue correspond à endDate de la cohorte plus endOffset jours.

Si granularity est défini sur WEEKLY, la valeur endDate de la période de référence étendue correspond à endDate de la cohorte plus endOffset * 7 jours.

Si granularity est défini sur MONTHLY, la valeur endDate de la période de référence étendue correspond à endDate de la cohorte plus endOffset * 30 jours.

Précision

Précision utilisée pour interpréter les valeurs startOffset et endOffset pour la période étendue d'un rapport sur les cohortes.

Enums
GRANULARITY_UNSPECIFIED Ne doit jamais être spécifié.
DAILY Précision quotidienne Généralement utilisé si l'dateRange de la cohorte correspond à une seule journée et que la requête contient cohortNthDay.
WEEKLY Précision hebdomadaire Généralement utilisé si l'dateRange de la cohorte est d'une semaine (du dimanche au samedi) et que la requête contient cohortNthWeek.
MONTHLY Précision mensuelle Généralement utilisé si l'dateRange de la cohorte dure un mois et que la requête contient cohortNthMonth.

CohortReportSettings

Paramètres facultatifs d'un rapport sur les cohortes.

Représentation JSON 
{
  "accumulate": boolean
}
Champs
accumulate

boolean

Si la valeur est "true", le résultat s'accumule du premier jour de contact jusqu'au jour de fin. Non disponible dans RunReportRequest.

ReportMetadata

Métadonnées du rapport pour une tâche de rapport spécifique.

Représentation JSON 
{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}
Champs
creationQuotaTokensCharged

integer

Uniquement en sortie. Le quota total de jetons facturés lors de la création du rapport. Étant donné que le nombre de jetons est basé sur l'activité à l'état CREATING, ces frais de jetons seront corrigés lorsqu'une tâche de rapport passera à l'état ACTIVE ou FAILED.
state

enum (State)

Uniquement en sortie. État actuel de cette tâche de création de rapports.
beginCreatingTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle reportTasks.create a été appelé et que l'état CREATING a commencé pour le rapport.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
taskRowCount

integer

Uniquement en sortie. Nombre total de lignes dans le résultat du rapport. Ce champ sera renseigné lorsque l'État sera actif. Vous pouvez utiliser taskRowCount pour la pagination dans les limites de leur rapport existant.
errorMessage

string

Uniquement en sortie. Un message d'erreur s'affiche si une tâche de rapport échoue lors de la création.
totalRowCount

integer

Uniquement en sortie. Nombre total de lignes dans l'espace de stockage Google Analytics. Si vous souhaitez interroger d'autres lignes de données que celles du rapport actuel, l'utilisateur peut lancer une nouvelle tâche de rapport en fonction du totalRowCount.

La valeur taskRowCount représente le nombre de lignes spécifiques au rapport actuel, tandis que la valeur totalRowCount englobe le nombre total de lignes pour l'ensemble des données extraites de l'espace de stockage Google Analytics.

Par exemple, supposons que la valeur taskRowCount du rapport actuel soit de 20, et qu'elle affiche les données des 20 premières lignes. Simultanément, la valeur de totalRowCount est de 30, ce qui indique la présence de données pour les 30 lignes. taskRowCount peut être utilisé pour paginer les 20 premières lignes. Pour développer le rapport et inclure les données des 30 lignes, une tâche de rapport peut être créée à l'aide de totalRowCount afin d'accéder à l'ensemble des données complet, qui s'élève à 30 lignes.

État

État du traitement.

Enums
STATE_UNSPECIFIED L'état non spécifié ne sera jamais utilisé.
CREATING Le rapport est en cours de création et sera disponible prochainement. La création est effectuée immédiatement après l'appel CreateReport.
ACTIVE Le rapport est entièrement créé et prêt à être interrogé.
FAILED Échec de la création du rapport.

Méthodes

create

 Lance la création d'une tâche de rapport.

get

 Récupère les métadonnées du rapport sur une tâche de rapport spécifique.

list

 Répertorie toutes les tâches de création de rapports pour une propriété.

query

 Récupère le contenu d'une tâche de rapport.