PivotTable
Una tabla dinámica
Representación JSON |
---|
{ "rows": [ { object ( |
Campos | |
---|---|
rows[]
|
Cada agrupación de filas en la tabla dinámica. |
columns[]
|
Cada columna agrupada en la tabla dinámica. |
criteria
|
Una asignación opcional de filtros por desplazamiento de columna de origen. Los filtros se aplican antes de agregar datos en la tabla dinámica. La clave del mapa es el desplazamiento de columna del rango de origen que deseas filtrar y el valor es los criterios para esa columna.
Por ejemplo, si la fuente era
Este campo dejó de estar disponible y se reemplazó por
|
filterSpecs[]
|
Los filtros que se aplican a las columnas de origen antes de agregar datos para la tabla dinámica.
|
values[]
|
Una lista de valores para incluir en la tabla dinámica. |
valueLayout
|
Si los valores se deben enumerar de forma horizontal (como columnas) o vertical (como filas). |
dataExecutionStatus
|
Solo salida. Estado de ejecución de los datos para las tablas dinámicas de fuentes de datos. |
Campo de unión source_data . Es la fuente de los datos de la tabla dinámica.
source_data
puede ser solo una de las siguientes opciones:
|
|
source
|
El rango del que la tabla dinámica lee los datos. |
dataSourceId
|
El ID de la fuente de datos de la que la tabla dinámica lee los datos. |
PivotGroup
Es una sola agrupación (ya sea de fila o columna) en una tabla dinámica.
Representación JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
Campos | |
---|---|
showTotals
|
Es verdadero si la tabla dinámica debe incluir los totales de esta agrupación. |
valueMetadata[]
|
Metadatos sobre los valores de la agrupación. |
sortOrder
|
El orden en el que se deben ordenar los valores de este grupo. |
valueBucket
|
La cubeta del grupo de tabla de tabla opuesto por el que se quiere ordenar. Si no se especifica, la ordenación es alfabética según los valores de este grupo. |
repeatHeadings
|
Es verdadero si se deben repetir los encabezados de este grupo de elementos de tabla dinámica. Esta opción solo es válida para los grupos de filas y las columnas la ignoran. De forma predeterminada, minimizamos la repetición de encabezados, ya que no mostramos los que tienen un nivel superior cuando son iguales. Por ejemplo, aunque la tercera fila a continuación corresponde a "T1 mar", "Q1" no se muestra porque es redundante con las filas anteriores. Si se establece el campo repeatheaders como verdadero, el "T1" se repetirá en "Feb" y "mar".
|
label
|
Las etiquetas que se pueden usar para los grupos de filas y columnas que se pueden personalizar. Por ejemplo, en la siguiente tabla dinámica, la etiqueta de fila es
|
groupRule
|
Es la regla de grupo que se aplica a este grupo de filas o columnas. |
groupLimit
|
El límite de filas o columnas que se aplicará a este grupo de elementos de tabla dinámica. |
Campo de unión source . La fuente de datos del grupo de elementos dinámicos.
source
puede ser solo una de las siguientes opciones:
|
|
sourceColumnOffset
|
El desplazamiento de columna del rango de origen en el que se basa esta agrupación.
Por ejemplo, si el origen era |
dataSourceColumnReference
|
Es la referencia a la columna de fuente de datos en la que se basa esta agrupación. |
PivotGroupValueMetadata
Metadatos sobre un valor en una agrupación dinámica.
Representación JSON |
---|
{
"value": {
object (
|
Campos | |
---|---|
value
|
El valor calculado al que corresponden los metadatos. (Ten en cuenta que |
collapsed
|
Es verdadero si se contraen los datos correspondientes al valor. |
PivotGroupSortValueBucket
Información sobre qué valores de un grupo de elementos dinámicos se deben usar para la ordenación.
Representación JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object (
|
Campos | |
---|---|
valuesIndex
|
El desplazamiento en la lista |
buckets[]
|
Determina el bucket desde el que se eligen los valores para ordenar. Por ejemplo, en una tabla dinámica con un grupo de filas y dos grupos de columnas, el grupo de filas puede enumerar hasta dos valores. El primer valor corresponde a un valor dentro del primer grupo de columnas y el segundo corresponde a un valor en el segundo grupo de columnas. Si no se enumeran valores, esto indica que la fila debe ordenarse de acuerdo con el "Total general" en los grupos de columnas. Si se muestra un solo valor, correspondería al uso del “Total” de ese bucket. |
PivotGroupRule
Es una configuración opcional en un PivotGroup
que define buckets para los valores de la columna de datos de origen, en lugar de desglosar cada valor individual. Solo se puede agregar un PivotGroup
con una regla de grupo para cada columna en los datos de origen, aunque, en cualquier columna determinada, puedes agregar un PivotGroup
que tenga una regla y un PivotGroup
que no la tenga.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión rule . Es la regla que se aplica a PivotGroup .
rule
puede ser solo una de las siguientes opciones:
|
|
manualRule
|
Es un |
histogramRule
|
Es un |
dateTimeRule
|
Es un |
ManualRule
Te permite organizar manualmente los valores de una columna de datos de origen en buckets con los nombres que elijas. Por ejemplo, una tabla dinámica que agrega la población por estado:
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
Podría convertirse en una tabla dinámica que agregue la población por zona horaria proporcionando una lista de grupos (por ejemplo, groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) a una regla de grupo manual. Ten en cuenta que se podría lograr un efecto similar agregando una columna de zona horaria a los datos de origen y ajustando la tabla dinámica.
+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central | 106.3 |
| Eastern | 151.9 |
| Mountain | 17.4 |
...
+-----------+-------------------+
Representación JSON |
---|
{
"groups": [
{
object (
|
Campos | |
---|---|
groups[]
|
La lista de nombres de grupos y los elementos correspondientes de los datos de origen que se asignan a cada nombre de grupo. |
ManualRuleGroup
Un nombre de grupo y una lista de elementos de los datos de origen que se deben colocar en el grupo con ese nombre.
Representación JSON |
---|
{ "groupName": { object ( |
Campos | |
---|---|
groupName
|
Nombre del grupo, que debe ser una cadena. Cada grupo en una |
items[]
|
Son los elementos de los datos de origen que se deben colocar en este grupo. Cada elemento puede ser una cadena, un número o un valor booleano. Los elementos pueden aparecer como máximo en un grupo de una |
HistogramRule
Te permite organizar los valores numéricos de una columna de datos de origen en buckets de un tamaño constante. Todos los valores desde HistogramRule.start
hasta HistogramRule.end
se colocan en grupos de tamaño HistogramRule.interval
. Además, todos los valores inferiores a HistogramRule.start
se colocan en un grupo y todos los valores superiores a HistogramRule.end
se colocan en otro. Solo se requiere HistogramRule.interval
. Sin embargo, si se proporcionan HistogramRule.start
y HistogramRule.end
, HistogramRule.start
debe ser menor que HistogramRule.end
. Por ejemplo, una tabla dinámica que muestra el importe de compra promedio por edad con más de 50 filas:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
se podría convertir en una tabla dinámica similar a la que se muestra a continuación si se aplica una regla de grupo de histogramas con un HistogramRule.start
de 25, un HistogramRule.interval
de 20 y un 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 |
+-------------+-------------------+
Representación JSON |
---|
{ "interval": number, "start": number, "end": number } |
Campos | |
---|---|
interval
|
El tamaño de los buckets que se crean. Debe ser positivo. |
start
|
El valor mínimo en el que se colocan los elementos en buckets de tamaño constante. Los valores debajo del inicio se agrupan en un solo bucket. Este campo es opcional. |
end
|
El valor máximo en el que se colocan los elementos en buckets de tamaño constante. Los valores que están por encima del final se agrupan en un solo bucket. Este campo es opcional. |
DateTimeRule
Te permite organizar los valores de fecha y hora de una columna de datos de origen en buckets según las partes seleccionadas de sus valores de fecha o de hora. Por ejemplo, considera una tabla dinámica que muestra las transacciones de ventas por fecha:
+----------+--------------+
| Date | SUM of Sales |
+----------+--------------+
| 1/1/2017 | $621.14 |
| 2/3/2017 | $708.84 |
| 5/8/2017 | $326.84 |
...
+----------+--------------+
Si aplicas una regla de grupo de fecha y hora con un DateTimeRuleType
de YEAR_MONTH, se generará la siguiente tabla dinámica.
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
Representación JSON |
---|
{
"type": enum (
|
Campos | |
---|---|
type
|
El tipo de agrupación por fecha y hora que se aplicará. |
DateTimeRuleType
Los tipos de reglas de agrupación de fecha y hora disponibles. En esta documentación, se supone que la configuración regional de la hoja de cálculo es "en-US", aunque la renderización real de las fechas y horas utiliza la configuración regional de la hoja de cálculo para algunos tipos de reglas.
Enumeradores | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Es el tipo predeterminado, no lo usar. |
SECOND
|
Agrupa fechas por segundo, del 0 al 59. |
MINUTE
|
Agrupa las fechas por minuto, del 0 al 59. |
HOUR
|
Agrupa las fechas por hora utilizando un sistema de 24 horas, de 0 a 23. |
HOUR_MINUTE
|
Agrupa fechas por hora y minuto con un sistema de 24 horas, por ejemplo, 19:45. |
HOUR_MINUTE_AMPM
|
Agrupa fechas por hora y minuto con un sistema de 12 horas, por ejemplo, 7:45 p.m. La designación de a.m./p.m. se traduce según la configuración regional de la hoja de cálculo. |
DAY_OF_WEEK
|
Agrupa fechas por día de la semana; por ejemplo, domingo. Los días de la semana se traducirán según la configuración regional de la hoja de cálculo. |
DAY_OF_YEAR
|
Agrupa fechas por día del año, del 1 al 366. Observa que las fechas posteriores al 29 de febrero son diferentes en los años bisiestos diferentes. |
DAY_OF_MONTH
|
Agrupa fechas por día del mes, del 1 al 31. |
DAY_MONTH
|
Agrupa las fechas por día y mes; por ejemplo, 22-nov. El mes se traduce según la configuración regional de la hoja de cálculo. |
MONTH
|
Agrupa las fechas por mes; por ejemplo, nov. El mes se traduce según la configuración regional de la hoja de cálculo. |
QUARTER
|
Agrupa las fechas por trimestre, por ejemplo, en el primer trimestre (que representa de enero a marzo). |
YEAR
|
Agrupa fechas por año; por ejemplo, 2008. |
YEAR_MONTH
|
Agrupa las fechas por año y mes; por ejemplo, entre 2008 y nov. El mes se traduce según la configuración regional de la hoja de cálculo. |
YEAR_QUARTER
|
Agrupe las fechas por año y trimestre; por ejemplo, 2008, 4o trim. |
YEAR_MONTH_DAY
|
Agrupa fechas por año, mes y día; por ejemplo, 22-11-2008. |
PivotGroupLimit
El límite de cantidad de filas o columnas en el grupo de tabla dinámica.
Representación JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
Campos | |
---|---|
countLimit
|
Es el límite de cantidad. |
applyOrder
|
Es el orden en el que se aplica el límite de grupos a la tabla dinámica. Los límites del grupo dinámico se aplican de menor a mayor número de pedido. Los números de pedido se normalizan a números enteros consecutivos desde 0.
En las solicitudes de escritura, para personalizar completamente los pedidos que se aplican, todos los límites del grupo de elementos dinámicos deben tener este campo configurado con un número único. De lo contrario, el orden lo determina el índice de la lista |
PivotFilterCriteria
Criterios para ocultar o mostrar filas en una tabla dinámica.
Representación JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
Campos | |
---|---|
visibleValues[]
|
Son los valores que se deben incluir. Se excluyen los valores que no se mencionan aquí. |
condition
|
Es una condición que debe ser verdadera para que se muestren los valores. (
Los valores de las condiciones que hacen referencia a los rangos en la notación A1 se evalúan en relación con la hoja de la tabla dinámica. Las referencias se tratan de forma absoluta, por lo que no se rellenan en la tabla dinámica. Por ejemplo, un valor de condición de
El encabezado de columna puede hacer referencia a los datos de origen de la tabla dinámica. Por ejemplo, si los datos de origen tienen columnas llamadas "Revenue" y "Cost" y se aplica una condición a la columna "Revenue" con el tipo
|
visibleByDefault
|
Si los valores son visibles de forma predeterminada. Si es verdadero, |
PivotFilterSpec
Los criterios de filtro de la tabla dinámica asociados con un desplazamiento específico de la columna de origen.
Representación JSON |
---|
{ "filterCriteria": { object ( |
Campos | |
---|---|
filterCriteria
|
Los criterios de la columna. |
Campo de unión source . La columna de origen a la que se aplica este filtro.
source
puede ser solo una de las siguientes opciones:
|
|
columnOffsetIndex
|
El desplazamiento de columna basado en cero del rango de origen. |
dataSourceColumnReference
|
Es la referencia a la columna de fuente de datos. |
PivotValue
Definición de cómo se debe calcular un valor en una tabla dinámica.
Representación JSON |
---|
{ "summarizeFunction": enum ( |
Campos | |
---|---|
summarizeFunction
|
Es una función para resumir el valor. Si se configura |
name
|
Es un nombre para usar para el valor. |
calculatedDisplayType
|
Si se especifica, indica que los valores dinámicos deben mostrarse como resultado de un cálculo con otro valor de tabla dinámica. Por ejemplo, si calculadoDisplayType se especifica como PERCENT_OF_GRAND_TOTAL, todos los valores dinámicos se muestran como un porcentaje del total general. En el editor de Hojas de cálculo, esto se denomina "Mostrar como" en la sección de valores de una tabla dinámica. |
Campo de unión value . Los datos que se usarán para los valores de la tabla dinámica. Se debe establecer exactamente un valor.
value
puede ser solo una de las siguientes opciones:
|
|
sourceColumnOffset
|
El desplazamiento de columna del rango de origen del que lee este valor.
Por ejemplo, si el origen fuera |
formula
|
Fórmula personalizada para calcular el valor. La fórmula debe comenzar con un carácter
|
dataSourceColumnReference
|
Es la referencia a la columna de la fuente de datos de la que lee este valor. |
PivotValueSummarizeFunction
Es una función para resumir un valor dinámico.
Enumeradores | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
Es la opción predeterminada, no usar. |
SUM
|
Corresponde a la función SUM .
|
COUNTA
|
Corresponde a la función COUNTA .
|
COUNT
|
Corresponde a la función COUNT .
|
COUNTUNIQUE
|
Corresponde a la función COUNTUNIQUE .
|
AVERAGE
|
Corresponde a la función AVERAGE .
|
MAX
|
Corresponde a la función MAX .
|
MIN
|
Corresponde a la función MIN .
|
MEDIAN
|
Corresponde a la función MEDIAN .
|
PRODUCT
|
Corresponde a la función PRODUCT .
|
STDEV
|
Corresponde a la función STDEV .
|
STDEVP
|
Corresponde a la función STDEVP .
|
VAR
|
Corresponde a la función VAR .
|
VARP
|
Corresponde a la función VARP .
|
CUSTOM
|
Indica que la fórmula se debe usar sin modificaciones. Solo es válida si se estableció PivotValue.formula .
|
NONE
|
Indica que el valor ya está resumido y que la función de resumen no se especificó de forma explícita. Se usa para las tablas dinámicas de la fuente de datos de Looker en las que el valor ya está resumido. |
PivotValueCalculatedDisplayType
Son las posibles formas en que se pueden calcular los valores dinámicos para que se muestren.
Enumeradores | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
Valor predeterminado, no usar. |
PERCENT_OF_ROW_TOTAL
|
Muestra los valores dinámicos como un porcentaje de los valores totales de la fila. |
PERCENT_OF_COLUMN_TOTAL
|
Muestra los valores dinámicos como un porcentaje de los valores totales de la columna. |
PERCENT_OF_GRAND_TOTAL
|
Muestra los valores dinámicos como un porcentaje de los valores totales generales. |
PivotValueLayout
El diseño de los valores dinámicos.
Enumeradores | |
---|---|
HORIZONTAL
|
Los valores están dispuestos horizontalmente (como columnas). |
VERTICAL
|
Los valores se presentan verticalmente (como filas). |