PivotTable
Una tabla dinámica
Representación JSON |
---|
{ "rows": [ { object ( |
Campos | |
---|---|
rows[]
|
Cada agrupación de filas en la tabla dinámica. |
columns[]
|
Cada agrupación de columnas 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 el criterio de 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 a la tabla dinámica.
Ambas opciones
|
values[]
|
Es una lista de valores que se incluirán en la tabla dinámica. |
valueLayout
|
Si los valores se deben enumerar de forma horizontal (como columnas) o verticalmente (como filas). |
dataExecutionStatus
|
Solo salida. Es el estado de ejecución de datos de las tablas dinámicas de la fuente de datos. |
Campo de unión source_data . La fuente de los datos de la tabla dinámica.
source_data solo puede ser una de las siguientes opciones:
|
|
source
|
Es el rango del que la tabla dinámica lee datos. |
dataSourceId
|
El ID de la fuente de datos de la que la tabla dinámica está leyendo los datos. |
PivotGroup
Es una sola agrupación (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 del agrupamiento. |
sortOrder
|
Es el orden en el que se deben ordenar los valores de este grupo. |
valueBucket
|
La cubeta del grupo de tabla dinámica opuesto para 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 tabla dinámica. Esto solo es válido para los grupos de filas y se ignora en las columnas. De forma predeterminada, minimizamos la repetición de encabezados al no mostrar encabezados de nivel superior donde sean 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 estableces repeatHeadings en verdadero, se repetirá "Q1" para "Feb" y "Mar".
|
label
|
Las etiquetas que se usarán para los grupos de filas y columnas que pueden personalizarse. Por ejemplo, en la siguiente tabla dinámica, la etiqueta de fila está
|
groupRule
|
La regla del grupo que se aplicará a este grupo de filas o columnas. |
groupLimit
|
El límite de filas o columnas para aplicar a este grupo de elementos de tabla dinámica. |
Campo de unión source . La fuente de datos del grupo de elementos de tabla dinámica.
source
solo puede ser una de las siguientes opciones:
|
|
sourceColumnOffset
|
Es el desplazamiento de columna del rango de origen en el que se basa esta agrupación.
Por ejemplo, si la fuente era
|
dataSourceColumnReference
|
Es la referencia a la columna de la fuente de datos en la que se basa esta agrupación. |
PivotGroupValueMetadata
Metadatos sobre un valor en un grupo de ejes.
Representación JSON |
---|
{
"value": {
object ( |
Campos | |
---|---|
value
|
Es 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 tabla dinámica se deben usar para la ordenación.
Representación JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object ( |
Campos | |
---|---|
valuesIndex
|
Es 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 mostrar hasta dos valores. El primer valor corresponde a un valor dentro del primer grupo de columnas, y el segundo valor corresponde a un valor en el segundo grupo de columnas. Si no se muestran valores, esto indicaría que la fila debe ordenarse según el “Total general” de los grupos de columnas. Si en la lista hay un solo valor, esto correspondería a usar la columna "Total" de ese bucket. |
PivotGroupRule
Un parámetro de configuración opcional en un
PivotGroup
que define buckets para los valores en la columna de datos de origen, en lugar de desglosar cada valor individual. Solo uno
PivotGroup
con una regla de grupo para cada columna de los datos fuente, aunque en cualquier columna dada se puede agregar
PivotGroup
que tiene una regla y un
PivotGroup
que no lo hace.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión rule . La regla que se aplica al
PivotGroup
rule
solo puede ser una de las siguientes opciones:
|
|
manualRule
|
Un |
histogramRule
|
Un |
dateTimeRule
|
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 agrega la población por zona horaria proporcionando una lista de grupos (por ejemplo, groupName = 'Central', elementos = ['AL', 'AR', 'IA', ...]) a una regla de grupo manual. Ten en cuenta que se puede lograr un efecto similar si se agrega una columna de zona horaria a los datos de origen y se ajusta 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[]
|
Es 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 deben colocarse en el grupo con este nombre.
Representación JSON |
---|
{ "groupName": { object ( |
Campos | |
---|---|
groupName
|
El nombre del grupo, que debe ser una cadena. Cada grupo en un |
items[]
|
Los elementos de los datos de origen que deben colocarse 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 dentro de un determinado
|
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 de HistogramRule.start
a HistogramRule.end
se colocan en grupos de tamaño HistogramRule.interval
. Además, todos los valores a continuación
HistogramRule.start
se colocan en un grupo, y todos los valores anteriores
HistogramRule.end
se colocan en otro. Solo
HistogramRule.interval
pero si es necesario
HistogramRule.start
y
HistogramRule.end
de Google Cloud,
HistogramRule.start
debe ser menor que
HistogramRule.end
Por ejemplo, una tabla dinámica que muestra el importe promedio de compra por edad y tiene más de 50 filas:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
podría convertirse en una tabla dinámica como la que se muestra a continuación aplicando una regla de grupo de histogramas con una
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
|
Es el tamaño de los buckets que se crean. Debe ser positivo. |
start
|
Es el valor mínimo en el que los elementos se colocan en buckets de tamaño constante. Los valores por debajo del inicio se agrupan en un solo bucket. Este campo es opcional. |
end
|
El valor máximo con el que se colocan los artículos en buckets de tamaño constante. Los valores superiores al extremo se agrupan en un solo grupo. Este campo es opcional. |
DateTimeRule
Te permite organizar los valores de fecha y hora en una columna de datos de origen en buckets según las partes seleccionadas de sus valores de fecha o hora. Por ejemplo, considera una tabla dinámica que muestra 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 genera 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 usa la configuración regional de la hoja de cálculo para algunos tipos de reglas.
Enumeraciones | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Es el tipo predeterminado. No se debe usar. |
SECOND
|
Agrupa las fechas por segundo, de 0 a 59. |
MINUTE
|
Agrupar fechas por minuto, de 0 a 59 |
HOUR
|
Agrupa fechas por hora con un sistema de 24 horas, del 0 al 23. |
HOUR_MINUTE
|
Agrupa las fechas por hora y minuto con un sistema de 24 horas, por ejemplo, 19:45. |
HOUR_MINUTE_AMPM
|
Agrupa las fechas por hora y minuto con un sistema de 12 horas, por ejemplo, 7:45 p.m. La designación a.m./p.m. se traduce según la configuración regional de la hoja de cálculo. |
DAY_OF_WEEK
|
Agrupa las 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 las fechas por día del año, del 1 al 366. Ten en cuenta que las fechas posteriores al 29 de febrero caen en segmentos diferentes en años bisiestos que en los no bisiestos. |
DAY_OF_MONTH
|
Agrupa las 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 en función de la configuración regional de la hoja de cálculo. |
QUARTER
|
Agrupa las fechas por trimestre, por ejemplo, 1ᵉʳ trim. (que representa de ene a mar). |
YEAR
|
Agrupa las fechas por año, como 2008. |
YEAR_MONTH
|
Agrupa las fechas por año y mes, por ejemplo, desde 2008 hasta noviembre. El mes se traduce en función de la configuración regional de la hoja de cálculo. |
YEAR_QUARTER
|
Agrupa las fechas por año y trimestre, por ejemplo, 4° trimestre de 2008. |
YEAR_MONTH_DAY
|
Agrupa las fechas por año, mes y día, por ejemplo, 22/11/2008. |
PivotGroupLimit
El límite de la cantidad de filas o columnas del grupo de elementos de tabla dinámica.
Representación JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
Campos | |
---|---|
countLimit
|
El límite de recuento |
applyOrder
|
El orden en el que se aplica el límite de grupos a la tabla dinámica. Los límites del grupo de elementos dinámicos se aplican de menor a mayor número de pedido. Los números de pedido se normalizan a números enteros consecutivos a partir de 0.
En el caso de las solicitudes de escritura, para personalizar por completo los pedidos que se aplican, todos los límites de los grupos de elementos de tabla dinámica deben tener este campo configurado con un número único. De lo contrario, el orden lo determina el índice en la
|
PivotFilterCriteria
Criterios para mostrar/ocultar filas en una tabla dinámica.
Representación JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object ( |
Campos | |
---|---|
visibleValues[]
|
Valores que se deben incluir. Se excluyen los valores que no se indican aquí. |
condition
|
Una condición que debe ser verdadera para que se muestren los valores. (
Los valores de condiciones que hacen referencia a rangos en 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 completan en la tabla dinámica. Por ejemplo, un valor de condición de
Se puede hacer referencia a los datos de origen de la tabla dinámica por el nombre del encabezado de la columna. Por ejemplo, si los datos de origen tienen columnas denominadas "Ingresos" y "Costo" y se aplica una condición a la columna "Ingresos" columna con tipo
|
visibleByDefault
|
Indica si los valores son visibles de forma predeterminada. Si es verdadero, el
|
PivotFilterSpec
Los criterios de filtro de la tabla dinámica asociados con un desplazamiento de columna de origen específico
Representación JSON |
---|
{ "filterCriteria": { object ( |
Campos | |
---|---|
filterCriteria
|
Son los criterios de la columna. |
Campo de unión source . La columna de origen a la que se aplica este filtro.
source solo puede ser una de las siguientes opciones:
|
|
columnOffsetIndex
|
Es el desplazamiento de columna basado en cero del rango de origen. |
dataSourceColumnReference
|
La referencia a la columna de fuente de datos. |
PivotValue
Es la 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 establece |
name
|
Es un nombre para el valor. |
calculatedDisplayType
|
Si se especifica, indica que los valores de pivot deben mostrarse como resultado de un cálculo con otro valor pivot. Por ejemplo, si calculadoDisplayType se especifica como PERCENT_OF_GRAND_TOTAL, todos los valores dinámicos se muestran como el porcentaje del total general. En el editor de Hojas de cálculo, esta opción se denomina “Mostrar como” en la sección de valores de una tabla dinámica. |
Campo de unión
value Son los datos que se usarán para los valores de la tabla dinámica. Se debe establecer exactamente un valor.
value
solo puede ser una de las siguientes opciones:
|
|
sourceColumnOffset
|
El desplazamiento de columna del rango de origen desde el que se lee este valor.
Por ejemplo, si la fuente era
|
formula
|
Una fórmula personalizada para calcular el valor. La fórmula debe comenzar con una
|
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 de eje.
Enumeraciones | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
Es el valor predeterminado. No se debe 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
AVERAGE
.
|
MAX
|
Corresponde a la función MAX .
|
MIN
|
Corresponde a la función MIN .
|
MEDIAN
|
Corresponde a la
MEDIAN
.
|
PRODUCT
|
Corresponde a la
PRODUCT
.
|
STDEV
|
Corresponde a la
STDEV
.
|
STDEVP
|
Corresponde a la función STDEVP .
|
VAR
|
Corresponde a la función VAR .
|
VARP
|
Corresponde a la
VARP
.
|
CUSTOM
|
Indica que la fórmula debe usarse tal como está. Solo es válida si
PivotValue.formula
se estableció.
|
NONE
|
Indica que el valor ya está resumido y que la función de resumen no se especifica de forma explícita. Se usa para las tablas dinámicas de fuentes de datos de Looker en las que ya se resume el valor. |
PivotValueCalculatedDisplayType
Las posibles formas en que se pueden calcular los valores dinámicos para la publicidad gráfica.
Enumeraciones | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
Valor predeterminado, no usar. |
PERCENT_OF_ROW_TOTAL
|
Muestra los valores de tabla dinámica como un porcentaje de los valores totales de la fila. |
PERCENT_OF_COLUMN_TOTAL
|
Muestra los valores del eje de pivote como porcentaje de los valores totales de la columna. |
PERCENT_OF_GRAND_TOTAL
|
Muestra los valores del eje de pivote como porcentaje de los valores del total general. |
PivotValueLayout
El diseño de los valores de tabla dinámica.
Enumeraciones | |
---|---|
HORIZONTAL
|
Los valores se presentan de manera horizontal (como columnas). |
VERTICAL
|
Los valores se organizan verticalmente (como filas). |