Pivot Tables

PivotTable

Un tableau croisé dynamique.

Représentation JSON
{
  "rows": [
    {
      object (PivotGroup)
    }
  ],
  "columns": [
    {
      object (PivotGroup)
    }
  ],
  "criteria": {
    integer: {
      object (PivotFilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (PivotFilterSpec)
    }
  ],
  "values": [
    {
      object (PivotValue)
    }
  ],
  "valueLayout": enum (PivotValueLayout),
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  },

  // Union field source_data can be only one of the following:
  "source": {
    object (GridRange)
  },
  "dataSourceId": string
  // End of list of possible types for union field source_data.
}
Champs
rows[]

object (PivotGroup)

Chaque regroupement de lignes dans le tableau croisé dynamique.

columns[]

object (PivotGroup)

Chaque regroupement de colonnes dans le tableau croisé dynamique.

criteria
(deprecated)

map (key: integer, value: object ( PivotFilterCriteria))

Mappage facultatif des filtres par décalage de colonne source.

Les filtres sont appliqués avant l'agrégation des données dans le tableau croisé dynamique. La clé du mappage correspond au décalage de colonne de la plage source que vous souhaitez filtrer, et la valeur correspond aux critères de cette colonne.

Par exemple, si la source était C10:E15, une clé 0 aura le filtre pour la colonne C, tandis que la clé 1 est pour la colonne D.

Ce champ est obsolète et a été remplacé par filterSpecs

filterSpecs[]

object (PivotFilterSpec)

Filtres appliqués aux colonnes sources avant l'agrégation des données pour le tableau croisé dynamique.

criteria et filterSpecs sont tous deux renseignés dans les réponses. Si les deux champs sont spécifiés dans une requête de mise à jour, ce champ est prioritaire.

values[]

object (PivotValue)

Liste des valeurs à inclure dans le tableau croisé dynamique.

valueLayout

enum (PivotValueLayout)

Indique si les valeurs doivent être répertoriées horizontalement (en tant que colonnes) ou verticalement (en tant que lignes).

dataExecutionStatus

object (DataExecutionStatus)

Uniquement en sortie. État d'exécution des données pour les tableaux croisés dynamiques de sources de données.

Champ d'union source_data. Source des données du tableau croisé dynamique. source_data ne peut être qu'un des éléments suivants :
source

object (GridRange)

Plage à partir de laquelle le tableau croisé dynamique lit les données.

dataSourceId

string

ID de la source de données à partir de laquelle le tableau croisé dynamique lit les données.

PivotGroup

Regroupement unique (ligne ou colonne) d'un tableau croisé dynamique.

Représentation JSON
{
  "showTotals": boolean,
  "valueMetadata": [
    {
      object (PivotGroupValueMetadata)
    }
  ],
  "sortOrder": enum (SortOrder),
  "valueBucket": {
    object (PivotGroupSortValueBucket)
  },
  "repeatHeadings": boolean,
  "label": string,
  "groupRule": {
    object (PivotGroupRule)
  },
  "groupLimit": {
    object (PivotGroupLimit)
  },

  // Union field source can be only one of the following:
  "sourceColumnOffset": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field source.
}
Champs
showTotals

boolean

Vrai si le tableau croisé dynamique doit inclure les totaux de ce regroupement.

valueMetadata[]

object (PivotGroupValueMetadata)

Métadonnées sur les valeurs du regroupement.

sortOrder

enum (SortOrder)

Ordre dans lequel les valeurs de ce groupe doivent être triées.

valueBucket

object (PivotGroupSortValueBucket)

Ensemble du groupe croisé dynamique opposé à trier. Si aucune valeur n'est spécifiée, le tri est alphabétique par valeur de ce groupe.

repeatHeadings

boolean

"True" si les titres de ce groupe de tableaux croisés dynamiques doivent être répétés. Cette option n'est valide que pour les regroupements de lignes et est ignorée par les colonnes.

Par défaut, nous limitons la répétition des titres en n'affichant pas les titres de niveau supérieur lorsqu'ils sont identiques. Par exemple, même si la troisième ligne ci-dessous correspond à "T1 mars", "T1" n'est pas affiché, car il est redondant avec les lignes précédentes. Si vous définissez repeatHeadings sur "true", "Q1" sera répété pour "Feb" et "Mar".

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+
label

string

Libellés à utiliser pour les groupes de lignes/colonnes personnalisables. Par exemple, dans le tableau croisé dynamique suivant, le libellé de ligne est Region (qui pourrait être renommé en State) et l'étiquette de colonne est Product (qui pourrait être renommée Item). Les tableaux croisés dynamiques créés avant décembre 2017 n'ont pas de libellé d'en-tête. Si vous souhaitez ajouter des libellés d'en-tête à un tableau croisé dynamique existant, veuillez le supprimer, puis en créer un autre avec les mêmes paramètres.

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+
groupRule

object (PivotGroupRule)

Règle de groupe à appliquer à ce groupe de lignes/colonnes.

groupLimit

object (PivotGroupLimit)

Limite de nombre de lignes ou de colonnes à appliquer à ce groupe dynamique.

Champ d'union source. Source de données du groupe croisé dynamique. source ne peut être qu'un des éléments suivants :
sourceColumnOffset

integer

Décalage de colonne de la plage source sur laquelle est basé ce regroupement.

Par exemple, si la source était C10:E15, un sourceColumnOffset de 0 signifie que ce groupe fait référence à la colonne C, tandis que le décalage 1 fait référence à la colonne D.

dataSourceColumnReference

object (DataSourceColumnReference)

Référence à la colonne de source de données sur laquelle est basé ce regroupement.

PivotGroupValueMetadata

Métadonnées sur une valeur d'un groupe de tableaux croisés dynamiques.

Représentation JSON
{
  "value": {
    object (ExtendedValue)
  },
  "collapsed": boolean
}
Champs
value

object (ExtendedValue)

Valeur calculée à laquelle correspondent les métadonnées. Notez que formulaValue n'est pas valide, car les valeurs seront calculées.)

collapsed

boolean

"True" si les données correspondant à la valeur sont réduites.

PivotGroupSortValueBucket

Informations sur les valeurs d'un groupe croisé dynamique à utiliser pour le tri.

Représentation JSON
{
  "valuesIndex": integer,
  "buckets": [
    {
      object (ExtendedValue)
    }
  ]
}
Champs
valuesIndex

integer

Le décalage dans la partie PivotTable.values liste par laquelle les valeurs de ce regroupement doivent être triées.

buckets[]

object (ExtendedValue)

Détermine le bucket à partir duquel les valeurs doivent être triées.

Par exemple, dans un tableau croisé dynamique comportant un groupe de lignes et deux groupes de colonnes, le groupe de lignes peut lister jusqu'à deux valeurs. La première valeur correspond à une valeur du premier groupe de colonnes et la deuxième valeur correspond à une valeur du deuxième groupe de colonnes. Si aucune valeur n'est listée, cela signifie que la ligne doit être triée en fonction du "Total général" sur les groupes de colonnes. Si une seule valeur est indiquée, cela correspond à l'utilisation de la colonne "Total". de ce bucket.

PivotGroupRule

Un paramètre facultatif sur une PivotGroup qui définit des buckets pour les valeurs de la colonne de données source, au lieu de séparer chaque valeur individuellement. Vous ne pouvez ajouter qu'un seul PivotGroup avec une règle de groupe pour chaque colonne des données sources. Toutefois, pour une colonne donnée, vous pouvez ajouter à la fois un PivotGroup avec une règle et un PivotGroup sans règle.

Représentation JSON
{

  // Union field rule can be only one of the following:
  "manualRule": {
    object (ManualRule)
  },
  "histogramRule": {
    object (HistogramRule)
  },
  "dateTimeRule": {
    object (DateTimeRule)
  }
  // End of list of possible types for union field rule.
}
Champs
Champ d'union rule. Règle à appliquer à l'PivotGroup. rule ne peut être qu'un des éléments suivants :
manualRule

object (ManualRule)

Un ManualRule.

histogramRule

object (HistogramRule)

Un HistogramRule.

dateTimeRule

object (DateTimeRule)

A DateTimeRule

ManualRule

Vous permet d'organiser manuellement les valeurs d'une colonne de données source dans des buckets portant les noms de votre choix. Par exemple, un tableau croisé dynamique qui regroupe la population par État :

+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK    |               0.7 |
| AL    |               4.8 |
| AR    |               2.9 |
...
+-------+-------------------+

pourrait être transformé en tableau croisé dynamique qui agrège la population par fuseau horaire en fournissant une liste de groupes (par exemple, groupName = 'Central', éléments = ['AL', 'AR', 'IA', ...]) à une règle de regroupement manuelle. Notez qu'un effet similaire peut être obtenu en ajoutant une colonne de fuseau horaire aux données sources et en ajustant le tableau croisé dynamique.

+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central   |             106.3 |
| Eastern   |             151.9 |
| Mountain  |              17.4 |
...
+-----------+-------------------+
Représentation JSON
{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}
Champs
groups[]

object (ManualRuleGroup)

Liste des noms de groupes et des éléments correspondants issus des données sources mappés à chaque nom de groupe.

ManualRuleGroup

Nom d'un groupe et liste des éléments des données sources à placer dans le groupe portant ce nom.

Représentation JSON
{
  "groupName": {
    object (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}
Champs
groupName

object (ExtendedValue)

Nom du groupe, qui doit être une chaîne. Chaque groupe d'un objet ManualRule doit avoir un nom de groupe unique.

items[]

object (ExtendedValue)

Éléments des données sources à placer dans ce groupe. Chaque élément peut être une chaîne, un nombre ou une valeur booléenne. Les éléments ne peuvent apparaître que dans un seul groupe au sein d'un ManualRule donné. Les éléments qui n'appartiennent à aucun groupe s'affichent seuls.

HistogramRule

Permet d'organiser les valeurs numériques d'une colonne de données source en buckets de taille constante. Toutes les valeurs de HistogramRule.start à HistogramRule.end sont placées dans des groupes de taille HistogramRule.interval. De plus, toutes les valeurs inférieures à HistogramRule.start sont placées dans un groupe et toutes les valeurs supérieures à HistogramRule.end dans un autre. Seul HistogramRule.interval est obligatoire, mais si HistogramRule.start et HistogramRule.end sont tous deux fournis, HistogramRule.start doit être inférieur à HistogramRule.end. Par exemple, un tableau croisé dynamique affichant le montant moyen des achats par âge et comportant plus de 50 lignes :

+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16  |            $27.13 |
| 17  |             $5.24 |
| 18  |            $20.15 |
...
+-----+-------------------+

pourrait être transformé en un tableau croisé dynamique semblable à celui ci-dessous en appliquant une règle de groupe d'histogrammes avec une HistogramRule.start 25, un HistogramRule.interval de 20, et un HistogramRule.end 65.

+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25        |            $19.34 |
| 25-45       |            $31.43 |
| 45-65       |            $35.87 |
| > 65        |            $27.55 |
+-------------+-------------------+
| Grand Total |            $29.12 |
+-------------+-------------------+
Représentation JSON
{
  "interval": number,
  "start": number,
  "end": number
}
Champs
interval

number

Taille des buckets créés. Doit être positive.

start

number

Valeur minimale à partir de laquelle les éléments sont placés dans des buckets de taille constante. Les valeurs inférieures à la valeur de début sont regroupées dans un seul bucket. Ce champ est facultatif.

end

number

Valeur maximale à laquelle les éléments sont placés dans des buckets de taille constante. Les valeurs supérieures à la fin sont regroupées dans un seul bucket. Ce champ est facultatif.

DateTimeRule

Vous permet d'organiser les valeurs de date/heure d'une colonne de données source en groupes en fonction de parties sélectionnées de leurs valeurs de date ou d'heure. Prenons l'exemple d'un tableau croisé dynamique affichant les transactions de vente par date:

+----------+--------------+
| Date     | SUM of Sales |
+----------+--------------+
| 1/1/2017 |      $621.14 |
| 2/3/2017 |      $708.84 |
| 5/8/2017 |      $326.84 |
...
+----------+--------------+

L'application d'une règle de regroupement par date et heure avec un DateTimeRuleType de YEAR_MONTH génère le tableau croisé dynamique suivant.

+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan     |   $53,731.78 |
| 2017-Feb     |   $83,475.32 |
| 2017-Mar     |   $94,385.05 |
...
+--------------+--------------+
Représentation JSON
{
  "type": enum (DateTimeRuleType)
}
Champs
type

enum (DateTimeRuleType)

Type de regroupement date/heure à appliquer.

DateTimeRuleType

Types de règles de regroupement par date et heure disponibles. Cette documentation part du principe que la langue de la feuille de calcul est l'anglais (États-Unis), bien que l'affichage réel des dates et des heures utilise la langue de la feuille de calcul pour certains types de règles.

Enums
DATE_TIME_RULE_TYPE_UNSPECIFIED Type par défaut, ne pas utiliser.
SECOND Regroupe les dates par seconde, de 0 à 59.
MINUTE Regroupez les dates par minute, de 0 à 59.
HOUR Regroupez les dates par heure en utilisant un système de 24 heures, de 0 à 23.
HOUR_MINUTE Regroupez les dates par heure et minute en utilisant un système de 24 heures, par exemple 19:45.
HOUR_MINUTE_AMPM Regroupez les dates par heure et minute à l'aide d'un système 12 heures, par exemple 19h45. La désignation AM/PM est traduite en fonction des paramètres régionaux de la feuille de calcul.
DAY_OF_WEEK Regroupez les dates par jour de la semaine, par exemple dimanche. Les jours de la semaine seront traduits en fonction des paramètres régionaux de la feuille de calcul.
DAY_OF_YEAR Regroupe les dates par jour de l'année, de 1 à 366. Notez que les dates après le 29 février ne sont pas les mêmes dans les années bissextiles et les années non bissextiles.
DAY_OF_MONTH Regroupez les dates par jour du mois, de 1 à 31.
DAY_MONTH Regroupez les dates par jour et par mois, par exemple 22-Nov. Le mois est traduit en fonction des paramètres régionaux de la feuille de calcul.
MONTH Regroupez les dates par mois, par exemple "Nov". Le mois est traduit en fonction des paramètres régionaux de la feuille de calcul.
QUARTER Regroupez les dates par trimestre, par exemple Q1 (qui représente janvier-mars).
YEAR Regroupez les dates par année, par exemple 2008.
YEAR_MONTH Regroupez les dates par année et par mois (par exemple, "Nov. 2008"). Le mois est traduit en fonction des paramètres régionaux de la feuille de calcul.
YEAR_QUARTER Regroupez les dates par année et par trimestre, par exemple au quatrième trimestre 2008.
YEAR_MONTH_DAY Groupez les dates par année, mois et jour (par exemple, 2008-11-22).

PivotGroupLimit

Limite de nombre de lignes ou de colonnes dans le groupe croisé dynamique.

Représentation JSON
{
  "countLimit": integer,
  "applyOrder": integer
}
Champs
countLimit

integer

Limite de nombre.

applyOrder

integer

Ordre dans lequel la limite de groupes est appliquée au tableau croisé dynamique.

Les limites des groupes croisés dynamiques sont appliquées du numéro d'ordre inférieur au numéro supérieur. Les numéros de commande sont normalisés en entiers consécutifs à partir de 0.

Pour une requête d'écriture, afin de personnaliser entièrement les commandes appliquées, ce champ doit être défini avec un numéro unique dans toutes les limites de regroupement d'éléments de tableaux croisés dynamiques. Sinon, l'ordre est déterminé par l'index du PivotTable.rows à la liste, puis à PivotTable.columns liste.

PivotFilterCriteria

Critères d'affichage/de masquage des lignes dans un tableau croisé dynamique.

Représentation JSON
{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}
Champs
visibleValues[]

string

Valeurs à inclure. Les valeurs non listées ici sont exclues.

condition

object (BooleanCondition)

Condition qui doit être vraie pour que les valeurs soient affichées. (visibleValues ne remplace pas cela. Même si une valeur y est listée, elle reste masquée si elle ne remplit pas la condition.)

Les valeurs de condition qui font référence à des plages dans la notation A1 sont évaluées par rapport à la feuille du tableau croisé dynamique. Les références sont traitées de manière absolue, et ne sont donc pas remplies dans le tableau croisé dynamique. Par exemple, une valeur de condition de =A1 sur "Tableau croisé dynamique 1" est traité comme 'Pivot Table 1'!$A$1

Les données sources du tableau croisé dynamique peuvent être référencées par le nom de l'en-tête de colonne. Par exemple, si les données sources comportent des colonnes nommées "Revenus" et "Coût", et qu'une condition est appliquée à la colonne "Revenus" avec le type NUMBER_GREATER et la valeur =Cost, seules les colonnes pour lesquelles "Revenus" > "Coût" sont incluses.

visibleByDefault

boolean

Indique si les valeurs sont visibles par défaut. Si la valeur est "true", les visibleValues sont ignorées et toutes les valeurs qui répondent aux critères condition (le cas échéant) sont affichées. Si la valeur est "false", les valeurs situées à la fois dans visibleValues et rencontrer condition sont affichées.

PivotFilterSpec

Critères de filtrage du tableau croisé dynamique associés à un décalage de colonne source spécifique.

Représentation JSON
{
  "filterCriteria": {
    object (PivotFilterCriteria)
  },

  // Union field source can be only one of the following:
  "columnOffsetIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field source.
}
Champs
filterCriteria

object (PivotFilterCriteria)

Critères de la colonne.

Champ d'union source Colonne source à laquelle ce filtre s'applique. source ne peut être qu'un des éléments suivants :
columnOffsetIndex

integer

Décalage de colonne basé sur zéro de la plage source.

dataSourceColumnReference

object (DataSourceColumnReference)

Référence à la colonne de la source de données.

PivotValue

Définition de la manière dont une valeur d'un tableau croisé dynamique doit être calculée.

Représentation JSON
{
  "summarizeFunction": enum (PivotValueSummarizeFunction),
  "name": string,
  "calculatedDisplayType": enum (PivotValueCalculatedDisplayType),

  // Union field value can be only one of the following:
  "sourceColumnOffset": integer,
  "formula": string,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field value.
}
Champs
summarizeFunction

enum (PivotValueSummarizeFunction)

Fonction pour résumer la valeur. Si formula est défini, les seules valeurs acceptées sont SUM et CUSTOM. Si sourceColumnOffset est défini, CUSTOM n'est pas pris en charge.

name

string

Nom à utiliser pour la valeur.

calculatedDisplayType

enum (PivotValueCalculatedDisplayType)

Si elle est spécifiée, indique que les valeurs pivot doivent être affichées en tant que résultat d'un calcul avec une autre valeur pivot. Par exemple, si calculatedDisplayType est défini sur PERCENT_OF_GRAND_TOTAL, toutes les valeurs du pivot sont affichées sous forme de pourcentage du total général. Dans l'éditeur Sheets, cette option est appelée "Afficher sous forme de" dans la section des valeurs d'un tableau croisé dynamique.

Champ d'union value. Données à utiliser pour les valeurs du tableau croisé dynamique. Vous ne devez définir qu'une seule valeur. value ne peut être qu'un des éléments suivants :
sourceColumnOffset

integer

Décalage de colonne de la plage source à partir de laquelle cette valeur est lue.

Par exemple, si la source était C10:E15, un sourceColumnOffset de 0 signifie que cette valeur fait référence à la colonne C, alors que le décalage 1 fait référence à la colonne D

formula

string

Formule personnalisée pour calculer la valeur. La formule doit commencer par un caractère =.

dataSourceColumnReference

object (DataSourceColumnReference)

Référence à la colonne de la source de données à partir de laquelle cette valeur lit.

PivotValueSummarizeFunction

Fonction permettant de résumer une valeur de tableau croisé dynamique.

Enums
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED Valeur par défaut, ne pas utiliser.
SUM Correspond au SUM .
COUNTA Correspond au COUNTA .
COUNT Correspond à la fonction COUNT.
COUNTUNIQUE Correspond au COUNTUNIQUE .
AVERAGE Correspond au AVERAGE .
MAX Correspond au MAX .
MIN Correspond au MIN .
MEDIAN Correspond à la fonction MEDIAN.
PRODUCT Correspond à la fonction PRODUCT.
STDEV Correspond à la fonction STDEV.
STDEVP Correspond à la fonction STDEVP.
VAR Correspond à la fonction VAR.
VARP Correspond au VARP .
CUSTOM Indique que la formule doit être utilisée telle quelle. Valide uniquement si PivotValue.formula a été définie.
NONE Indique que la valeur est déjà résumée et que la fonction de synthèse n'est pas spécifiée explicitement. Utilisé pour les tableaux croisés dynamiques de la source de données Looker où la valeur est déjà résumée.

PivotValueCalculatedDisplayType

Manières possibles de calculer les valeurs de tableau croisé dynamique à des fins d'affichage.

Enums
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED Valeur par défaut, ne pas utiliser.
PERCENT_OF_ROW_TOTAL Affiche les valeurs du pivot sous forme de pourcentage du total des lignes.
PERCENT_OF_COLUMN_TOTAL Affiche les valeurs du tableau croisé dynamique sous forme de pourcentage du total des valeurs de la colonne.
PERCENT_OF_GRAND_TOTAL Affiche les valeurs de tableau croisé dynamique sous forme de pourcentage des valeurs du total général.

PivotValueLayout

Mise en page des valeurs des tableaux croisés dynamiques.

Enums
HORIZONTAL Les valeurs sont disposées horizontalement (sous forme de colonnes).
VERTICAL Les valeurs sont disposées verticalement (en lignes).