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)

Regroupement de lignes du tableau croisé dynamique.

columns[]

object (PivotGroup)

Chaque groupe de colonnes du 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 d'agréger les données dans le tableau croisé dynamique. La clé de la carte correspond au décalage de colonne de la plage source que vous souhaitez filtrer, et la valeur représente les critères de cette colonne.

Par exemple, si la source était C10:E15, une clé de 0 le filtre de la colonne C, alors que la clé 1 correspond à la colonne D

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

filterSpecs[]

object (PivotFilterSpec)

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

Les deux criteria et filterSpecs sont insérées 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 de 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 que l'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)

Bucket du groupe de tableaux croisés dynamiques opposé à utiliser comme critère de tri. S'il n'est pas spécifié, le tri est alphabétique selon les valeurs de ce groupe.

repeatHeadings

boolean

"True" 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 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 en dessous correspond à "T1 Mar", "Q1" n'est pas affiché, car il fait double emploi avec les lignes précédentes. Si la valeur "repeatHeadings" est définie sur "true", "Q1" est déclenché. qui sera répété pour "février" et "Mars".

+--------------+
| 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)

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

Champ d'union source Source de données du groupe de tableaux croisés dynamiques. source ne peut être que l'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, alors 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 de tableaux croisés dynamiques à 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 avec un groupe de lignes et deux groupes de colonnes, le groupe de lignes peut contenir 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 indiquerait 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. Une seule PivotGroup avec une règle de groupe peut être ajouté pour chaque colonne des données sources, mais sur une colonne donnée, vous pouvez ajouter à la fois PivotGroup qui comporte une règle PivotGroup ce qui n'est pas le cas.

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 La règle à appliquer PivotGroup rule ne peut être que l'un des éléments suivants:
manualRule

object (ManualRule)

A ManualRule

histogramRule

object (HistogramRule)

A 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 agrège 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

Un nom de groupe et une liste d'éléments issus des données sources qui doivent être placés 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 peuvent apparaître dans au maximum un groupe au sein d'un même groupe. ManualRule Les éléments qui n'apparaissent dans 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és dans des groupes de taille HistogramRule.interval De plus, toutes les valeurs ci-dessous HistogramRule.start sont placées dans un groupe, et toutes les valeurs ci-dessus HistogramRule.end sont placés dans un autre. Uniquement HistogramRule.interval est obligatoire, mais si HistogramRule.start et HistogramRule.end sont 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 à 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 date/heure d'une colonne de données source dans des buckets 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 |
...
+----------+--------------+

Appliquer une règle de groupe de type date/heure avec une DateTimeRuleType de YEAR_MONTH résultats dans 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 disponibles de règles de regroupement par date/heure. Cette documentation suppose que les paramètres régionaux de la feuille de calcul sont "en-US", bien que le rendu réel des dates et heures utilise les paramètres régionaux 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 Regroupez 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 en utilisant un système sur 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 sont traduits en fonction des paramètres régionaux de la feuille de calcul.
DAY_OF_YEAR Regroupez 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 "novembre". Le mois est traduit selon les paramètres régionaux de la feuille de calcul.
QUARTER Regroupez les dates par trimestre, par exemple Q1 (qui représente janv.-mars).
YEAR Regroupez les dates par année, par exemple 2008.
YEAR_MONTH Regroupez les dates par année et par mois, par exemple 2008-Nov. 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 Regroupez les dates par année, mois et jour (par exemple, 2008-11-22).

PivotGroupLimit

Nombre maximal de lignes ou de colonnes dans le groupe de tableaux croisés dynamiques.

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 nombres entiers consécutifs à partir de 0.

Pour les requêtes 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 s'affichent. ( visibleValues ne remplace pas ce paramètre. Même si une valeur y figure, elle est toujours masquée si elle ne remplit pas la condition).

Les valeurs de condition qui font référence à des plages en 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 intitulées "Revenue" (Revenus), et "Coût" et une condition est appliquée à la colonne "Revenus" colonne avec type NUMBER_GREATER et la valeur =Cost, puis uniquement les colonnes où "Revenus" &gt; "Coût" sont incluses.

visibleByDefault

boolean

Indique si les valeurs sont visibles par défaut. Si la valeur est "true", le visibleValues sont ignorées, toutes les valeurs qui répondent condition (si spécifié) s'affichent. Si la valeur est "false", les valeurs situées à la fois dans visibleValues et rencontrer condition sont affichées.

PivotFilterSpec

Critères de filtre 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 que l'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 du mode de calcul d'une valeur d'un tableau croisé dynamique.

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 spécifié, indique que les valeurs de tableau croisé dynamique doivent être affichées comme le résultat d'un calcul avec une autre valeur de tableau croisé dynamique. Par exemple, si "computeDisplayType" est défini sur "PERCENT_OF_GRAND_TOTAL", toutes les valeurs du tableau croisé dynamique sont affichées sous forme de pourcentage du total général. Dans l'éditeur Sheets, cette fonction est appelée "Afficher en tant que". 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 que l'un des éléments suivants:
sourceColumnOffset

integer

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

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

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 au COUNT .
COUNTUNIQUE Correspond au COUNTUNIQUE .
AVERAGE Correspond au AVERAGE .
MAX Correspond au MAX .
MIN Correspond au MIN .
MEDIAN Correspond au MEDIAN .
PRODUCT Correspond au PRODUCT .
STDEV Correspond au STDEV .
STDEVP Correspond au STDEVP .
VAR Correspond au 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 sources de données Looker dont 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 de tableau croisé dynamique en tant que pourcentage des valeurs totales de la ligne.
PERCENT_OF_COLUMN_TOTAL Affiche les valeurs de tableau croisé dynamique en tant que pourcentage des valeurs totales 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 (sous forme de lignes).