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 los 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 de esa columna.
Por ejemplo, si la fuente fuera
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.
Tanto |
values[]
|
Es una lista de valores que se incluirán en la tabla dinámica. |
valueLayout
|
Indica si los valores se deben enumerar horizontalmente (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 . Es la fuente de los datos de la tabla dinámica.
source_data solo puede ser uno de los siguientes:
|
|
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 lee 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
|
Es el bucket del grupo de elementos de tabla dinámica opuesto por el que se 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 ejes. Esto solo es válido para los grupos de filas y se ignora en las columnas. De forma predeterminada, minimizamos la repetición de los encabezados, ya que no mostramos los encabezados de nivel superior cuando son iguales. Por ejemplo, aunque la tercera fila que aparece a continuación corresponde a "Q1 Mar", no se muestra "Q1" porque es redundante con las filas anteriores. Si estableces repeatHeadings en verdadero, se repetirá "Q1" para "Feb" y "Mar".
|
label
|
Son 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
|
Es la regla de grupo que se aplicará a este grupo de filas o columnas. |
groupLimit
|
Es el límite de recuento de filas o columnas que se aplicará a este grupo de ejes. |
Campo de unión source . Es la fuente de datos del grupo de filtros.
source solo puede ser uno de los siguientes:
|
|
sourceColumnOffset
|
Es el desplazamiento de columna del rango de origen en el que se basa esta agrupación.
Por ejemplo, si la fuente fuera |
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 los datos correspondientes al valor están contraídos. |
PivotGroupSortValueBucket
Es la información sobre qué valores de un grupo de ejes deben usarse para ordenar.
Representación JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object ( |
Campos | |
---|---|
valuesIndex
|
Es el desplazamiento en la lista |
buckets[]
|
Determina el bucket a partir del cual se eligen los valores para ordenarlos. 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 se muestra un solo valor, correspondería a usar el "Total" de ese bucket. |
PivotGroupRule
Es 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 se puede agregar un PivotGroup
con una regla de grupo para cada columna de los datos de origen, aunque en una 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 aplicará a PivotGroup .
rule solo puede ser uno de los siguientes:
|
|
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 |
...
+-------+-------------------+
se puede convertir en una tabla dinámica que agrupe 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 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 se deben colocar 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 se deben colocar en este grupo. Cada elemento puede ser una cadena, un número o un valor booleano. Los elementos pueden aparecer en un máximo de un grupo dentro de un |
HistogramRule
Te permite organizar los valores numéricos de una columna de datos de origen en intervalos de 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 por encima de HistogramRule.end
se colocan 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 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 |
...
+-----+-------------------+
se puede convertir en una tabla dinámica que se vea como la siguiente si se aplica una regla de grupo de histograma 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
|
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
|
Es el valor máximo en el que los elementos se colocan en buckets de tamaño constante. Los valores superiores al final se agrupan en un solo bucket. 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 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 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
|
Es el tipo de agrupación de fecha y hora que se aplicará. |
DateTimeRuleType
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 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
|
Agrupa las fechas por minuto, de 0 a 59. |
HOUR
|
Agrupa las 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 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, 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 se incluyen en diferentes segmentos en los años bisiestos y en los que no lo son. |
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, 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, 1ᵉʳ trim. (que representa de ene a mar). |
YEAR
|
Agrupa las fechas por año, por ejemplo, 2008. |
YEAR_MONTH
|
Agrupa las fechas por año y mes, por ejemplo, 2008-Nov. El mes se traduce según 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
Es el límite de recuento de filas o columnas en el grupo de datos.
Representación JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
Campos | |
---|---|
countLimit
|
El límite de recuento |
applyOrder
|
Es el orden en el que se aplica el límite de grupo a la tabla dinámica. Los límites de los grupos de ejes se aplican del número de orden más bajo al más alto. Los números de pedido se normalizan a números enteros consecutivos a partir de 0.
En el caso de la solicitud de escritura, para personalizar por completo los pedidos de aplicación, todos los límites de grupos de ejes deben tener este campo establecido con un número único. De lo contrario, el orden se determina según el índice en la lista |
PivotFilterCriteria
Son los criterios para mostrar o 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
|
Es una condición que debe ser verdadera para que se muestren los valores. (
Los valores de condición 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 llamadas "Ingresos" y "Costo", y se aplica una condición a la columna "Ingresos" con el tipo |
visibleByDefault
|
Indica si los valores son visibles de forma predeterminada. Si es verdadero, se ignoran los |
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 . Es la columna de origen a la que se aplica este filtro.
source solo puede ser uno de los siguientes:
|
|
columnOffsetIndex
|
Es el desplazamiento de columna basado en cero del rango de origen. |
dataSourceColumnReference
|
Es la referencia a la columna de la 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 que se usará para el valor. |
calculatedDisplayType
|
Si se especifica, indica que los valores de eje deben mostrarse como resultado de un cálculo con otro valor de eje. Por ejemplo, si calculatedDisplayType se especifica como PERCENT_OF_GRAND_TOTAL, todos los valores del gráfico dinámico 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 uno de los siguientes:
|
|
sourceColumnOffset
|
Es 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
|
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 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 tal como está. Solo es válido si se configuró PivotValue.formula .
|
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 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 de la tabla dinámica para su visualización.
Enumeraciones | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
Es un valor predeterminado que no se debe usar. |
PERCENT_OF_ROW_TOTAL
|
Muestra los valores del eje de giro como 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 pivote.
Enumeraciones | |
---|---|
HORIZONTAL
|
Los valores se organizan horizontalmente (como columnas). |
VERTICAL
|
Los valores se organizan verticalmente (como filas). |