Pivot Tables

object (PivotGroup)

Chaque regroupement de lignes dans le tableau croisé dynamique.

object (PivotGroup)

Chaque regroupement de colonnes dans le tableau croisé dynamique.

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 remplacé par 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.

object (PivotValue)

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

enum (PivotValueLayout)

Indique si les valeurs doivent être listées horizontalement (en colonnes) ou verticalement (en lignes).

object (DataExecutionStatus)

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

object (GridRange)

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

string

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

boolean

"True" si le tableau croisé dynamique doit inclure les totaux pour ce regroupement.

object (PivotGroupValueMetadata)

Métadonnées sur les valeurs du regroupement.

enum (SortOrder)

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

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.

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 ne les affichant pas au niveau supérieur s'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     |
+--------------+

string

Libellés à utiliser pour les groupes de lignes/colonnes, qui peuvent être personnalisés. Par exemple, dans le tableau croisé dynamique suivant, le libellé de ligne est Region (qui peut être renommé State) et le libellé de colonne est Product (qui peut être renommé Item). Les tableaux croisés dynamiques créés avant décembre 2017 ne comportent pas de libellés d'en-tête. Si vous souhaitez ajouter des libellés d'en-tête à un tableau croisé dynamique existant, veuillez supprimer ce tableau croisé dynamique, 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 |
+--------------+---------+-------+

object (PivotGroupRule)

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

object (PivotGroupLimit)

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

integer

Décalage de colonne de la plage source sur laquelle repose 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.

object (DataSourceColumnReference)

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

object (ExtendedValue)

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

boolean

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

integer

Décalage dans la liste PivotTable.values sur la base duquel les valeurs de ce regroupement doivent être triées.

object (ExtendedValue)

Détermine le bucket à partir duquel les valeurs sont choisies pour le tri.

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 seconde à 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 listée, cela correspond à l'utilisation du "Total" de ce bucket.

object (ManualRule)

Un ManualRule.

object (HistogramRule)

Un HistogramRule.

object (DateTimeRule)

Un DateTimeRule.

object (ManualRuleGroup)

Liste des noms de groupes et des éléments correspondants des données sources qui correspondent à chaque nom de groupe.

object (ExtendedValue)

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

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.

number

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

number

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

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 même bucket. Ce champ est facultatif.

enum (DateTimeRuleType)

Type de regroupement par date/heure à appliquer.

integer

Limite de décompte.

integer

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

Les limites des groupes pivots sont appliquées de l'ordre le plus bas au plus élevé. Les numéros de commande sont normalisés en entiers consécutifs à partir de 0.

Pour les requêtes d'écriture, afin de personnaliser entièrement les ordres d'application, ce champ doit être défini sur un nombre unique pour toutes les limites de groupe pivot. Sinon, l'ordre est déterminé par l'index dans la liste PivotTable.rows, puis dans la liste PivotTable.columns.

string

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

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 renseignées dans le tableau croisé dynamique. Par exemple, une valeur de condition de =A1 sur "Tableau croisé dynamique 1" est traitée 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 intitulé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 où "Revenus" > "Coût" sont incluses.

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 qui se trouvent à la fois dans visibleValues et qui répondent aux critères de condition sont affichées.

object (PivotFilterCriteria)

Critères de la colonne.

integer

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

object (DataSourceColumnReference)

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

enum (PivotValueSummarizeFunction)

Fonction permettant de 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 compatible.

string

Nom à utiliser pour la valeur.

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 s'appelle "Afficher sous forme de" dans la section des valeurs d'un tableau croisé dynamique.

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, tandis que le décalage 1 fait référence à la colonne D.

string

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

object (DataSourceColumnReference)

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