PivotTable
Un tableau croisé dynamique.
Représentation JSON |
---|
{ "rows": [ { object ( |
Champs | |
---|---|
rows[]
|
Regroupement de lignes dans le tableau croisé dynamique. |
columns[]
|
Chaque regroupement de colonnes du tableau croisé dynamique. |
criteria
|
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
Ce champ a été abandonné et remplacé par |
filterSpecs[]
|
Les filtres appliqués aux colonnes sources avant d'agréger les données du tableau croisé dynamique
|
values[]
|
Liste des valeurs à inclure dans le tableau croisé dynamique. |
valueLayout
|
Indique si les valeurs doivent être répertoriées horizontalement (sous forme de colonnes) ou verticalement (sous forme de 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) dans 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
|
L'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. Si aucune valeur n'est spécifiée, le tri est effectué par ordre alphabétique en fonction des valeurs de ce groupe. |
repeatHeadings
|
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".
|
label
|
Libellés à utiliser pour les groupes de lignes/colonnes personnalisables. Par exemple, dans le tableau croisé dynamique suivant, le libellé de la 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 ce regroupement est basé.
Par exemple, si la source était |
dataSourceColumnReference
|
Référence à la colonne de la source de données sur laquelle se base ce regroupement. |
PivotGroupValueMetadata
Métadonnées sur une valeur dans un regroupement de tableaux croisés dynamiques.
Représentation JSON |
---|
{
"value": {
object (
|
Champs | |
---|---|
value
|
Valeur calculée à laquelle les métadonnées correspondent. (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
|
Décalage indiqué dans la liste |
buckets[]
|
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. |
PivotGroupRule
Paramètre facultatif sur une PivotGroup
qui définit des buckets pour les valeurs de la colonne de données source au lieu de répartir chaque valeur individuelle. Vous ne pouvez ajouter qu'un seul PivotGroup
avec une règle de groupe pour chaque colonne des données sources. Toutefois, sur une colonne donnée, vous pouvez ajouter à la fois un PivotGroup
comportant une règle et un PivotGroup
qui n'en a pas.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union rule . Règle à appliquer à PivotGroup .
rule ne peut être que l'un des éléments suivants:
|
|
manualRule
|
Un élément |
histogramRule
|
Un élément |
dateTimeRule
|
Un élément |
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 |
...
+-------+-------------------+
peut être transformé en tableau croisé dynamique qui agrège la population par fuseau horaire en fournissant une liste de groupes (par exemple, groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) à une règle de regroupement manuelle. Notez qu'un effet similaire pourrait ê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 groupe et des éléments correspondants 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 à placer dans le groupe avec ce nom.
Représentation JSON |
---|
{ "groupName": { object ( |
Champs | |
---|---|
groupName
|
Nom du groupe, qui doit être une chaîne. Chaque groupe d'une |
items[]
|
É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 |
HistogramRule
Vous 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
sont placées dans un autre. Seul HistogramRule.interval
est obligatoire. Toutefois, si HistogramRule.start
et HistogramRule.end
sont tous les deux fournis, HistogramRule.start
doit être inférieur à HistogramRule.end
. Par exemple, un tableau croisé dynamique montrant le montant moyen des achats par âge et qui contient plus de 50 lignes:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
peut être transformé en tableau croisé dynamique semblable à celui présenté ci-dessous en appliquant une règle de groupe d'histogrammes avec une HistogramRule.start
de 25, une HistogramRule.interval
de 20 et une HistogramRule.end
de 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
|
La 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 situées sous le 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 d'éléments sélectionnés 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 |
...
+----------+--------------+
Si vous appliquez une règle de groupe de dates et heures avec un DateTimeRuleType
de YEAR_MONTH, le tableau croisé dynamique suivant est généré.
+--------------+--------------+
| 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 de règles de regroupement par date/heure disponibles. 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
|
Regrouper les dates par seconde, de 0 à 59. |
MINUTE
|
Regrouper les dates par minute, de 0 à 59. |
HOUR
|
Regroupez les dates par heure à l'aide d'un système sur 24 heures, de 0 à 23. |
HOUR_MINUTE
|
Regroupez les dates par heure et par minute à l'aide d'un système en continu, par exemple 19:45. |
HOUR_MINUTE_AMPM
|
Regroupez les dates par heure et par minute à l'aide d'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 seront 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 postérieures au 29 février sont classées dans des catégories différentes selon les années bissextiles et non bissextiles. |
DAY_OF_MONTH
|
Regroupez les dates par jour du mois, de 1 à 31. |
DAY_MONTH
|
Permet de regrouper les dates par jour et par mois (par exemple, 22-novembre). Le mois est traduit en fonction des paramètres régionaux de la feuille de calcul. |
MONTH
|
Regroupez les dates par mois (novembre, par exemple). Le mois est traduit en fonction des paramètres régionaux de la feuille de calcul. |
QUARTER
|
Regroupez les dates par trimestre, par exemple T1 (qui représente de janvier à mars). |
YEAR
|
Regroupez les dates par année, par exemple 2008. |
YEAR_MONTH
|
Permet de regrouper les dates par année et par mois (par exemple, 2008-novembre). 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 T4 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
|
Nombre maximal. |
applyOrder
|
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 |
PivotFilterCriteria
Critères d'affichage ou 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 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
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 |
visibleByDefault
|
Indique si les valeurs sont visibles par défaut. Si la valeur est "true", les |
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 de la manière dont une valeur dans un tableau croisé dynamique doit être calculée.
Représentation JSON |
---|
{ "summarizeFunction": enum ( |
Champs | |
---|---|
summarizeFunction
|
Une fonction permettant de résumer la valeur. Si |
name
|
Nom à utiliser pour la valeur. |
calculatedDisplayType
|
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. |
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 permettant de calculer la valeur. La formule doit commencer par un caractère |
dataSourceColumnReference
|
Référence à la colonne de 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
|
Par défaut, ne pas utiliser. |
SUM
|
Correspond à la fonction SUM .
|
COUNTA
|
Correspond à la fonction COUNTA .
|
COUNT
|
Correspond à la fonction COUNT .
|
COUNTUNIQUE
|
Correspond à la fonction COUNTUNIQUE .
|
AVERAGE
|
Correspond à la fonction AVERAGE .
|
MAX
|
Correspond à la fonction MAX .
|
MIN
|
Correspond à la fonction 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 à la fonction VARP .
|
CUSTOM
|
Indique que la formule doit être utilisée telle quelle. N'est valide que si PivotValue.formula a été défini.
|
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 où la valeur est déjà résumée. |
PivotValueCalculatedDisplayType
Les différentes façons dont les valeurs de tableau croisé dynamique peuvent être calculées pour l'affichage.
Enums | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
Valeur par défaut, ne pas utiliser. |
PERCENT_OF_ROW_TOTAL
|
Affiche les valeurs croisées dynamiques sous forme de pourcentage des valeurs totales de la ligne. |
PERCENT_OF_COLUMN_TOTAL
|
Affiche les valeurs croisées dynamiques sous forme de pourcentage des valeurs totales de la colonne. |
PERCENT_OF_GRAND_TOTAL
|
Affiche les valeurs croisées dynamiques sous forme de pourcentage des valeurs du total général. |
PivotValueLayout
Mise en page des valeurs de tableau croisé dynamique.
Enums | |
---|---|
HORIZONTAL
|
Les valeurs sont disposées horizontalement (sous forme de colonnes). |
VERTICAL
|
Les valeurs sont disposées verticalement (sous forme de lignes). |