Pivot Tables

{
  "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.
}

object (PivotGroup)

Regroupement de lignes dans le tableau croisé dynamique.

object (PivotGroup)

Chaque regroupement de colonnes du tableau croisé dynamique.

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

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

Les filtres sont appliqués avant de regrouper les données dans le tableau croisé dynamique. La clé de la map est le décalage de colonne de la plage source que vous souhaitez filtrer, et la valeur est le critère de cette colonne.

Par exemple, si la source était C10:E15, une clé 0 se verra attribuer le filtre de la colonne C, tandis que la clé 1 correspondra à la colonne D.

Ce champ a été abandonné et remplacé par filterSpecs.

object (PivotFilterSpec)

Les filtres appliqués aux colonnes sources avant d'agréger les données du tableau croisé dynamique

criteria et filterSpecs sont 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 répertoriées horizontalement (sous forme de colonnes) ou verticalement (sous forme de lignes).

object (DataExecutionStatus)

Uniquement en sortie. État d'exécution des données pour les tableaux croisés dynamiques de sources 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.

{
  "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.
}

boolean

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

object (PivotGroupValueMetadata)

Métadonnées sur les valeurs du regroupement.

enum (SortOrder)

L'ordre dans lequel les valeurs de ce groupe doivent être triées.

object (PivotGroupSortValueBucket)

Bucket du groupe de tableaux croisés dynamiques opposé à utiliser comme critère de tri. Si aucune valeur n'est spécifiée, le tri est effectué par ordre alphabétique en fonction des valeurs de ce groupe.

boolean

Vrai si les en-têtes de ce groupe de tableaux croisés dynamiques doivent être répétés. Ce champ n'est valide que pour les regroupements de lignes et est ignoré par les colonnes.

Par défaut, nous minimisons les répétitions 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", "Q1" n'est pas affiché, car elle fait double emploi avec les lignes précédentes. Si vous définissez "repeatHeadings" sur "true", "Q1" sera répété pour "février" et "mars".

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

string

Libellés à utiliser pour les groupes de lignes/colonnes personnalisables. Par exemple, dans le tableau croisé dynamique suivant, le libellé de la ligne est Region (qui pourrait être renommé State) et le libellé de la colonne est Product (qui pourrait être renommé Item). Les tableaux croisés dynamiques créés avant décembre 2017 ne comportent 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 |
+--------------+---------+-------+

object (PivotGroupRule)

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

object (PivotGroupLimit)

Nombre maximal de lignes ou de colonnes à appliquer à ce groupe de tableaux croisés dynamiques.

integer

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

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

object (DataSourceColumnReference)

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

{
  "value": {
    object (ExtendedValue)
  },
  "collapsed": boolean
}

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.

{
  "valuesIndex": integer,
  "buckets": [
    {
      object (ExtendedValue)
    }
  ]
}

integer

Décalage indiqué dans la liste PivotTable.values selon lequel 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 avec 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 répertoriée, cela signifie que la ligne doit être triée en fonction du « Total général » dans les groupes de colonnes. Si une seule valeur est répertoriée, cela correspond à l'utilisation du "Total" de ce segment.

{

  // 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.
}

object (ManualRule)

Un élément ManualRule.

object (HistogramRule)

Un élément HistogramRule.

object (DateTimeRule)

Un élément DateTimeRule.

{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}

object (ManualRuleGroup)

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

{
  "groupName": {
    object (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}

object (ExtendedValue)

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

object (ExtendedValue)

Éléments des données source à placer dans ce groupe. Chaque élément peut être une chaîne, un nombre ou une valeur booléenne. Les éléments peuvent apparaître dans un groupe au maximum dans un ManualRule donné. Les éléments qui n'apparaissent dans aucun groupe apparaissent seuls.

{
  "interval": number,
  "start": number,
  "end": number
}

number

La taille des buckets créés. Doit être positive.

number

Valeur minimale à laquelle les éléments sont placés dans des buckets de taille constante. Les valeurs situées sous le début sont regroupées dans un seul 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 seul bucket. Ce champ est facultatif.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

Type de regroupement date-heure à appliquer.

{
  "countLimit": integer,
  "applyOrder": integer
}

integer

Nombre maximal.

integer

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

Les limites des groupes de tableaux croisés dynamiques s'appliquent du numéro de commande inférieur au numéro le plus élevé. Les numéros de commande sont normalisés en nombres entiers consécutifs à partir de 0.

Dans le cas d'une requête d'écriture, pour personnaliser complètement les ordres qui s'appliquent, ce champ doit être défini sur un numéro unique pour toutes les limites des groupes de tableaux croisés dynamiques. Sinon, l'ordre est déterminé par l'index de la liste PivotTable.rows, puis par la liste PivotTable.columns.

{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}

string

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

object (BooleanCondition)

Condition qui doit être vraie pour que les valeurs s'affichent. (visibleValues ne remplace pas cette valeur. Même si une valeur y est répertorié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, donc ne sont pas remplies dans le tableau croisé dynamique. Par exemple, une valeur de condition de =A1 dans un "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 nom d'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" de type NUMBER_GREATER et de la valeur =Cost, seules les colonnes contenant "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, toutes les valeurs qui répondent à condition (si spécifiée) sont affichées. Si la valeur est "false", les valeurs qui se trouvent à la fois dans visibleValues et qui correspondent à condition sont affichées.

{
  "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.
}

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.

{
  "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.
}

enum (PivotValueSummarizeFunction)

Une 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 accepté.

string

Nom à utiliser pour la valeur.

enum (PivotValueCalculatedDisplayType)

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

integer

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

Par exemple, si la source était C10:E15, une valeur 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 permettant de calculer la valeur. La formule doit commencer par un caractère =.

object (DataSourceColumnReference)

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