Pivot Tables

PivotTable

Una tabla dinámica

Representación JSON
{
  "rows": [
    {
      object (PivotGroup)
    }
  ],
  "columns": [
    {
      object (PivotGroup)
    }
  ],
  "criteria": {
    integer: {
      object (PivotFilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (PivotFilterSpec)
    }
  ],
  "values": [
    {
      object (PivotValue)
    }
  ],
  "valueLayout": enum (PivotValueLayout),
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  },

  // Union field source_data can be only one of the following:
  "source": {
    object (GridRange)
  },
  "dataSourceId": string
  // End of list of possible types for union field source_data.
}
Campos
rows[]

object (PivotGroup)

Cada agrupación de filas en la tabla dinámica.

columns[]

object (PivotGroup)

Cada agrupación de columnas en la tabla dinámica.

criteria
(deprecated)

map (key: integer, value: object ( PivotFilterCriteria))

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 C10:E15, una clave de 0 tendría el filtro para la columna C, mientras que la clave 1 es para la columna D.

Este campo dejó de estar disponible y se reemplazó por filterSpecs.

filterSpecs[]

object (PivotFilterSpec)

Los filtros que se aplican a las columnas de origen antes de agregar datos a la tabla dinámica.

Tanto criteria como filterSpecs se propagan en las respuestas. Si se especifican ambos campos en una solicitud de actualización, este campo tiene prioridad.

values[]

object (PivotValue)

Es una lista de valores que se incluirán en la tabla dinámica.

valueLayout

enum (PivotValueLayout)

Indica si los valores se deben enumerar horizontalmente (como columnas) o verticalmente (como filas).

dataExecutionStatus

object (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

object (GridRange)

Es el rango del que la tabla dinámica lee datos.

dataSourceId

string

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 (PivotGroupValueMetadata)
    }
  ],
  "sortOrder": enum (SortOrder),
  "valueBucket": {
    object (PivotGroupSortValueBucket)
  },
  "repeatHeadings": boolean,
  "label": string,
  "groupRule": {
    object (PivotGroupRule)
  },
  "groupLimit": {
    object (PivotGroupLimit)
  },

  // Union field source can be only one of the following:
  "sourceColumnOffset": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field source.
}
Campos
showTotals

boolean

Es verdadero si la tabla dinámica debe incluir los totales de esta agrupación.

valueMetadata[]

object (PivotGroupValueMetadata)

Metadatos sobre los valores del agrupamiento

sortOrder

enum (SortOrder)

Es el orden en el que se deben ordenar los valores de este grupo.

valueBucket

object (PivotGroupSortValueBucket)

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

boolean

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".

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+
label

string

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 Region (que se podría cambiar a State) y la etiqueta de columna es Product (que se podría cambiar a Item). Las tablas dinámicas creadas antes de diciembre de 2017 no tienen etiquetas de encabezado. Si deseas agregar etiquetas de encabezado a una tabla dinámica existente, borra la tabla dinámica existente y, luego, crea una nueva con los mismos parámetros.

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+
groupRule

object (PivotGroupRule)

Es la regla de grupo que se aplicará a este grupo de filas o columnas.

groupLimit

object (PivotGroupLimit)

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

integer

Es el desplazamiento de columna del rango de origen en el que se basa esta agrupación.

Por ejemplo, si la fuente fuera C10:E15, un sourceColumnOffset de 0 significa que este grupo hace referencia a la columna C, mientras que el desplazamiento 1 se referiría a la columna D.

dataSourceColumnReference

object (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 (ExtendedValue)
  },
  "collapsed": boolean
}
Campos
value

object (ExtendedValue)

Es el valor calculado al que corresponden los metadatos. (Ten en cuenta que formulaValue no es válido porque se calcularán los valores).

collapsed

boolean

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 (ExtendedValue)
    }
  ]
}
Campos
valuesIndex

integer

Es el desplazamiento en la lista PivotTable.values por el que se deben ordenar los valores de esta agrupación.

buckets[]

object (ExtendedValue)

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 rule can be only one of the following:
  "manualRule": {
    object (ManualRule)
  },
  "histogramRule": {
    object (HistogramRule)
  },
  "dateTimeRule": {
    object (DateTimeRule)
  }
  // End of list of possible types for union field rule.
}
Campos
Campo de unión rule. Es la regla que se aplicará a PivotGroup. rule solo puede ser uno de los siguientes:
manualRule

object (ManualRule)

Un ManualRule.

histogramRule

object (HistogramRule)

Un HistogramRule.

dateTimeRule

object (DateTimeRule)

Un DateTimeRule.

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 (ManualRuleGroup)
    }
  ]
}
Campos
groups[]

object (ManualRuleGroup)

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 (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}
Campos
groupName

object (ExtendedValue)

El nombre del grupo, que debe ser una cadena. Cada grupo en un ManualRule determinado debe tener un nombre de grupo único.

items[]

object (ExtendedValue)

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 ManualRule determinado. Los elementos que no aparezcan en ningún grupo aparecerán por sí solos.

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

number

Es el tamaño de los buckets que se crean. Debe ser positivo.

start

number

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

number

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 (DateTimeRuleType)
}
Campos
type

enum (DateTimeRuleType)

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

integer

El límite de recuento

applyOrder

integer

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 PivotTable.rows y, luego, en la lista PivotTable.columns.

PivotFilterCriteria

Son los criterios para mostrar o ocultar filas en una tabla dinámica.

Representación JSON
{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}
Campos
visibleValues[]

string

Valores que se deben incluir. Se excluyen los valores que no se indican aquí.

condition

object (BooleanCondition)

Es una condición que debe ser verdadera para que se muestren los valores. (visibleValues no anula esto; incluso si se incluye un valor allí, seguirá oculto si no cumple con la condición).

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 =A1 en “Tabla dinámica 1” se considera 'Pivot Table 1'!$A$1.

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 NUMBER_GREATER y el valor =Cost, solo se incluyen las columnas en las que "Ingresos" > "Costo".

visibleByDefault

boolean

Indica si los valores son visibles de forma predeterminada. Si es verdadero, se ignoran los visibleValues y se muestran todos los valores que cumplen con condition (si se especifica). Si es falso, se muestran los valores que están en visibleValues y cumplen con condition.

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 (PivotFilterCriteria)
  },

  // Union field source can be only one of the following:
  "columnOffsetIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field source.
}
Campos
filterCriteria

object (PivotFilterCriteria)

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

integer

Es el desplazamiento de columna basado en cero del rango de origen.

dataSourceColumnReference

object (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 (PivotValueSummarizeFunction),
  "name": string,
  "calculatedDisplayType": enum (PivotValueCalculatedDisplayType),

  // Union field value can be only one of the following:
  "sourceColumnOffset": integer,
  "formula": string,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field value.
}
Campos
summarizeFunction

enum (PivotValueSummarizeFunction)

Es una función para resumir el valor. Si se establece formula, los únicos valores admitidos son SUM y CUSTOM. Si se configura sourceColumnOffset, no se admite CUSTOM.

name

string

Es un nombre que se usará para el valor.

calculatedDisplayType

enum (PivotValueCalculatedDisplayType)

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

integer

Es el desplazamiento de columna del rango de origen del que lee este valor.

Por ejemplo, si la fuente fuera C10:E15, un sourceColumnOffset de 0 significa que este valor se refiere a la columna C, mientras que el desplazamiento 1 se referiría a la columna D.

formula

string

Una fórmula personalizada para calcular el valor. La fórmula debe comenzar con un carácter =.

dataSourceColumnReference

object (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).