PivotTable
Un tableau croisé dynamique.
Représentation JSON |
---|
{ "rows": [ { object ( |
Champs | |
---|---|
rows[]
|
Regroupement de lignes du tableau croisé dynamique. |
columns[]
|
Chaque groupe de colonnes du tableau croisé dynamique. |
criteria
|
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
Ce champ est obsolète et a été remplacé par
|
filterSpecs[]
|
Filtres appliqués aux colonnes sources avant d'agréger les données du tableau croisé dynamique.
Les deux
|
values[]
|
Liste de valeurs à inclure dans le tableau croisé dynamique. |
valueLayout
|
Indique si les valeurs doivent être répertoriées horizontalement (en tant que colonnes) ou verticalement (en tant que lignes). |
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
|
Plage à partir de laquelle le tableau croisé dynamique lit les données. |
dataSourceId
|
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 ( |
Champs | |
---|---|
showTotals
|
Vrai si le tableau croisé dynamique doit inclure les totaux de ce regroupement. |
valueMetadata[]
|
Métadonnées sur les valeurs du regroupement. |
sortOrder
|
Ordre dans lequel les valeurs de ce groupe doivent être triées. |
valueBucket
|
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
|
"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".
|
label
|
Libellés à utiliser pour les groupes de lignes/colonnes personnalisables. Par exemple, dans le tableau croisé dynamique suivant, le libellé de ligne est
|
groupRule
|
Règle de groupe à appliquer à ce groupe de lignes/colonnes. |
groupLimit
|
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
|
Décalage de colonne de la plage source sur laquelle est basé ce regroupement.
Par exemple, si la source était
|
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 (
|
Champs | |
---|---|
value
|
Valeur calculée à laquelle correspondent les métadonnées. Notez que
|
collapsed
|
"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 (
|
Champs | |
---|---|
valuesIndex
|
Le décalage dans la partie
|
buckets[]
|
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 |
Champs | |
---|---|
Champ d'union
rule La règle à appliquer
PivotGroup
rule
ne peut être que l'un des éléments suivants:
|
|
manualRule
|
|
histogramRule
|
|
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 (
|
Champs | |
---|---|
groups[]
|
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 ( |
Champs | |
---|---|
groupName
|
Nom du groupe, qui doit être une chaîne. Chaque groupe d'un objet
|
items[]
|
É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.
|
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
|
Taille des buckets créés. Doit être positive. |
start
|
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
|
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 (
|
Champs | |
---|---|
type
|
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
|
Limite de nombre. |
applyOrder
|
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
|
PivotFilterCriteria
Critères d'affichage/de masquage des lignes dans un tableau croisé dynamique.
Représentation JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
Champs | |
---|---|
visibleValues[]
|
Valeurs à inclure. Les valeurs non listées ici sont exclues. |
condition
|
Condition qui doit être vraie pour que les valeurs s'affichent. (
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
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
|
visibleByDefault
|
Indique si les valeurs sont visibles par défaut. Si la valeur est "true", le
|
PivotFilterSpec
Critères de filtre du tableau croisé dynamique associés à un décalage de colonne source spécifique.
Représentation JSON |
---|
{ "filterCriteria": { object ( |
Champs | |
---|---|
filterCriteria
|
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
|
Décalage de colonne basé sur zéro de la plage source. |
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 ( |
Champs | |
---|---|
summarizeFunction
|
Fonction pour résumer la valeur. Si
|
name
|
Nom à utiliser pour la valeur. |
calculatedDisplayType
|
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
|
Décalage de colonne de la plage source à partir de laquelle cette valeur lit.
Par exemple, si la source était
|
formula
|
Formule personnalisée pour calculer la valeur. La formule doit commencer par
|
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). |