Tabla dinámica
Una tabla dinámica.
Representación JSON |
---|
{ "rows": [ { object ( |
Campos | |
---|---|
rows[]
|
Cada fila se agrupa en la tabla dinámica. |
columns[]
|
Cada columna se agrupa 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 a 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 para esa columna.
Por ejemplo, si la fuente era
Este campo dejó de estar disponible y se reemplazó por |
filterSpecs[]
|
Los filtros aplicados a las columnas de origen antes de agregar datos a la tabla dinámica.
|
values[]
|
Una lista de valores para incluir en la tabla dinámica. |
valueLayout
|
Indica si los valores se deben mostrar de forma horizontal (como columnas) o vertical (como filas). |
dataExecutionStatus
|
Solo salida. El estado de ejecución de los 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 puede ser solo una de las siguientes opciones:
|
|
source
|
El rango desde el que se leen los datos en la tabla dinámica. |
dataSourceId
|
ID de la fuente de datos desde la que se leen los datos en la tabla dinámica. |
Grupo dinámico
Una sola agrupación (fila o columna) en una tabla dinámica.
Representación JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
Campos | |
---|---|
showTotals
|
Verdadero si la tabla dinámica debe incluir los totales para esta agrupación. |
valueMetadata[]
|
Metadatos sobre los valores de la agrupación. |
sortOrder
|
El orden de los valores de este grupo debe estar ordenado. |
valueBucket
|
El bucket del grupo de tabla dinámica opuesto. Si no se especifica, se ordenarán los valores alfabéticamente según este grupo. |
repeatHeadings
|
Verdadero si los encabezados de este grupo de tabla dinámica deben repetirse. Esto solo es válido para las agrupaciones de filas y las columnas lo ignoran. De forma predeterminada, minimizamos la repetición de encabezados, ya que no mostramos encabezados de nivel superior en el mismo lugar. Por ejemplo, aunque la tercera fila siguiente corresponde a "T1 de marzo", no se muestra "T1" porque es redundante con las filas anteriores. Si estableces la opción repitaHeaders como verdadera, se hará que "Q1" se repita en "Feb" y "Mar".
|
label
|
Las etiquetas que se usarán para los grupos de filas o columnas que se pueden personalizar. Por ejemplo, en la siguiente tabla dinámica, la etiqueta de fila es
|
groupRule
|
La regla de grupo que se aplicará a este grupo de filas/columnas. |
groupLimit
|
El límite de recuento 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 tabla dinámica.
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 la fuente era |
dataSourceColumnReference
|
La referencia a la columna de la fuente de datos en la que se basa esta agrupación. |
PivotGroupValueMetadata
Metadatos sobre un valor de 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
|
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 el ordenamiento.
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. 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 valor corresponde a un valor en el segundo grupo de columnas. Si no se muestra ningún valor, esto indicaría que la fila debe ordenarse según el "Total general" en los grupos de columnas. Si aparece un solo valor, esto correspondería a usar el “Total” de ese bucket. |
Regla de PivotGroup
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 en cada columna de los datos de origen. Sin embargo, en cualquier columna, puedes agregar un PivotGroup
que tenga una regla y un PivotGroup
que no lo haga.
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
|
Un objeto |
histogramRule
|
Un objeto |
dateTimeRule
|
Un objeto |
Regla manual
Te permite organizar de forma manual 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. Tenga en cuenta que puede lograr un efecto similar si agrega una columna de zona horaria a los datos de origen y 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[]
|
La lista de nombres de grupos y los elementos correspondientes de los datos de origen que se asignan a cada nombre de grupo |
Grupo de reglas manuales
Un nombre de grupo y una lista de elementos de los datos de origen que se deben colocar en el grupo con este nombre.
Representación JSON |
---|
{ "groupName": { object ( |
Campos | |
---|---|
groupName
|
El nombre del grupo, que debe ser una string Cada grupo de una |
items[]
|
Los elementos de los datos de origen que se deben colocar en este grupo. Cada elemento puede ser una string, un número o un valor booleano. Los elementos pueden aparecer como máximo en un grupo dentro de un |
Regla de histograma
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 por debajo de HistogramRule.start
se colocan en un grupo y todos los valores superiores a HistogramRule.end
se ubican en otro. Solo se requiere HistogramRule.interval
, aunque si se proporcionan HistogramRule.start
y HistogramRule.end
, HistogramRule.start
debe ser menor que HistogramRule.end
. Por ejemplo, una tabla dinámica que muestre un importe de compra promedio por edad que tenga 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 aplicando una regla de grupo de histogramas con una HistogramRule.start
de 25, una HistogramRule.interval
de 20 y una 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 inferiores al comienzo 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 ubicados en el extremo superior se agrupan en un solo bucket. Este campo es opcional. |
Regla de fecha y hora
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 muestre 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 de fecha y hora que se aplicará. |
Tipo de regla de fecha y hora
Los tipos disponibles de reglas de agrupación de fecha y hora. 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 algunos tipos de reglas.
Enumeradores | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
El tipo predeterminado, no usar. |
SECOND
|
Agrupa las fechas por segundo, del 0 al 59. |
MINUTE
|
Agrupa las fechas por minuto, del 0 al 59. |
HOUR
|
Agrupa fechas por hora con un sistema de 24 horas, de 0 a 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, a las 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 las fechas por día de la semana, por ejemplo, los domingos. 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, de 1 a 366. Tenga en cuenta que las fechas posteriores al 29 de febrero se encuentran en segmentos diferentes en años bisiestos y en años 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, del 22 de 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, noviembre. El mes se traduce según la configuración regional de la hoja de cálculo. |
QUARTER
|
Agrupa las fechas por trimestre, por ejemplo, el primer trimestre (que representa ene-mar). |
YEAR
|
Agrupa las fechas por año, por ejemplo, 2008. |
YEAR_MONTH
|
Agrupa las fechas por año y mes, por ejemplo, de 2008 a 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, T4 2008. |
YEAR_MONTH_DAY
|
Agrupa las fechas por año, mes y día, por ejemplo, 2011-2018. |
Límite de grupo dinámico
El límite de recuento de filas o columnas en el 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 grupo a la tabla dinámica. Los límites de los grupos dinámicos se aplican de menor a mayor. Los números de pedido se normalizan en números enteros consecutivos de 0.
En la solicitud de escritura, a fin de personalizar completamente los pedidos que se aplican, todos los límites del grupo de elementos dinámicos deben tener este campo establecido con un número único. De lo contrario, el orden se determina por el índice de la lista |
Criterios de PivotFilter
Criterios para ocultar o mostrar filas en una tabla dinámica.
Representación JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
Campos | |
---|---|
visibleValues[]
|
Valores que deben incluirse. Se excluyen los valores que no aparecen aquí. |
condition
|
Una condición que debe ser verdadera para que se muestren los valores. (
Los valores de condición 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
Se puede hacer referencia a los datos de origen de la tabla dinámica por el nombre del encabezado de columna. Por ejemplo, si los datos de origen tienen columnas llamadas "Ingresos" y "Costo", y una condición se aplica a la columna "Ingresos" con el tipo |
visibleByDefault
|
Indica si los valores son visibles de forma predeterminada. Si es verdadero, se ignoran los |
Especificación de PivotFilter
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
|
Los criterios para 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 columnas basado en cero del rango de origen. |
dataSourceColumnReference
|
La referencia a la columna de la fuente de datos. |
Valor de Pivot
La definición de cómo se debe calcular un valor en una tabla dinámica.
Representación JSON |
---|
{ "summarizeFunction": enum ( |
Campos | |
---|---|
summarizeFunction
|
Una función para resumir el valor. Si se configura
|
name
|
Un nombre para el valor. |
calculatedDisplayType
|
Si se especifica, indica que los valores de tabla dinámica deben mostrarse como resultado de un cálculo con otro valor de tabla dinámica. Por ejemplo, si el valor de computeDisplayType se especifica como PERCENT_OF_GRAND_TOTAL, todos los valores de tabla dinámica se muestran como el porcentaje del total general. En el editor de Hojas de cálculo, esto se conoce como "Mostrar como" en la sección de valor 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 la fuente fuera |
formula
|
Una fórmula personalizada para calcular el valor. La fórmula debe comenzar con un carácter
|
dataSourceColumnReference
|
Referencia a la columna de la fuente de datos en la que se lee este valor. |
Función de valor resumido de PivotValue
Es una función para resumir un valor de tabla dinámica.
Enumeradores | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
El valor predeterminado, 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 debe usarse tal como está. Solo es válida si se estableció PivotValue.formula .
|
Tipo de Gráfico calculado de PivotValue
Las formas posibles en que se pueden calcular los valores dinámicos para la visualización
Enumeradores | |
---|---|
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 de tabla dinámica como un porcentaje de los valores totales de la columna. |
PERCENT_OF_GRAND_TOTAL
|
Muestra los valores de tabla dinámica como un porcentaje de los valores totales totales. |
Diseño PivotValue
El diseño de los valores de tabla dinámica
Enumeradores | |
---|---|
HORIZONTAL
|
Los valores se disponen horizontalmente (como columnas). |
VERTICAL
|
Los valores se disponen verticalmente (como filas). |