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 datos en la tabla dinámica. La clave del mapa es el desplazamiento de la columna del rango de origen que deseas filtrar, y el valor son los criterios para esa columna.

Por ejemplo, si la fuente era C10:E15, una clave de 0 tendrá el filtro por columna C, mientras que la clave 1 es para columnas 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 para la tabla dinámica.

Ambas opciones criteria y filterSpecs se propagan en las respuestas. Si se especifican ambos campos en una solicitud de actualización, este campo tendrá prioridad.

values[]

object (PivotValue)

Una lista de valores para incluir en la tabla dinámica.

valueLayout

enum (PivotValueLayout)

Si los valores se deben enumerar de forma horizontal (como columnas) o verticalmente (como filas).

dataExecutionStatus

object (DataExecutionStatus)

Solo salida. Estado de ejecución de los datos de las tablas dinámicas de fuentes 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

object (GridRange)

Rango del que está leyendo los datos de la tabla dinámica.

dataSourceId

string

El ID de la fuente de datos de la que la tabla dinámica está leyendo los datos.

PivotGroup

Es una sola agrupación (ya sea 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 de la agrupación.

sortOrder

enum (SortOrder)

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

valueBucket

object (PivotGroupSortValueBucket)

La cubeta del grupo de tabla dinámica opuesto para ordenar. Si no se especifica, el ordenamiento se realiza alfabéticamente según los valores de este grupo.

repeatHeadings

boolean

Es verdadero si se deben repetir los encabezados de este grupo de tabla dinámica. Esto solo es válido para las agrupaciones 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 se establece repeatHeadings como verdadero, el error "Q1" se repite para "febrero" y “mar”.

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

string

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á Region (a la que se le podría cambiar el nombre State) y la etiqueta de la columna es Product (a la que se le podría cambiar el nombre 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)

La regla del grupo que se aplicará a este grupo de filas o columnas.

groupLimit

object (PivotGroupLimit)

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

integer

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

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

dataSourceColumnReference

object (DataSourceColumnReference)

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

object (ExtendedValue)

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

collapsed

boolean

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

integer

El desplazamiento en la PivotTable.values lista por la que deben ordenarse los valores de esta agrupación.

buckets[]

object (ExtendedValue)

Determina el bucket desde el que se eligen los valores para ordenar.

Por ejemplo, en una tabla dinámica con un grupo de filas & 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 enumera ningún valor, esto indicaría que la fila debe ordenarse de acuerdo con el "Total general". sobre 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 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 La regla que se aplica al PivotGroup rule solo puede ser una de las siguientes opciones:
manualRule

object (ManualRule)

R ManualRule

histogramRule

object (HistogramRule)

R HistogramRule

dateTimeRule

object (DateTimeRule)

R 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 |
...
+-------+-------------------+

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

object (ManualRuleGroup)

Es la lista de nombres de grupos y los elementos correspondientes de los datos de origen que se asignan al nombre de cada 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 (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}
Campos
groupName

object (ExtendedValue)

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

items[]

object (ExtendedValue)

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

HistogramRule

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 de compra promedio por edad que 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

number

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

start

number

Valor mínimo en el que se colocan los elementos en buckets de tamaño constante. Los valores inferiores al inicio se agrupan en un solo bucket. Este campo es opcional.

end

number

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 basados en las partes seleccionadas de sus valores de fecha o de 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 |
...
+----------+--------------+

Aplicar una regla de grupo de fecha y hora con una DateTimeRuleType de YEAR_MONTH resultados en 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)

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. Esta documentación 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.

Enumeraciones
DATE_TIME_RULE_TYPE_UNSPECIFIED El tipo predeterminado, no 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 en función de la configuración regional de la hoja de cálculo.
DAY_OF_YEAR Agrupar fechas por día del año, de 1 a 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 Agrupar 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 en función de 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, el 1er trim. (que representa de enero a marzo).
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, 2008 T4.
YEAR_MONTH_DAY Agrupar fechas por año, mes y día, por ejemplo, 2008-11-22

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

integer

El límite de cantidad.

applyOrder

integer

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

PivotFilterCriteria

Criterios para mostrar/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 mencionan aquí.

condition

object (BooleanCondition)

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

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 manera absoluta, por lo que no se rellenan en la tabla dinámica. Por ejemplo, un valor de condición de =A1 en "Tabla dinámica 1" se trata como 'Pivot Table 1'!$A$1

El nombre del 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 denominadas "Ingresos" y "Costo" y se aplica una condición a la columna "Ingresos" columna con tipo NUMBER_GREATER y el valor, =Cost; luego, solo las columnas donde "Ingresos" &gt; "Costo" están incluidas.

visibleByDefault

boolean

Indica si los valores son visibles de forma predeterminada. Si es verdadero, el visibleValues se ignoran, todos los valores que cumplen condition (si se especifica). Si es falso, los valores que están en visibleValues y conocer 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)

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

integer

Desplazamiento de la columna basada en cero del rango de origen.

dataSourceColumnReference

object (DataSourceColumnReference)

La referencia a la columna de fuente de datos.

PivotValue

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)

Una función para resumir el valor. Si formula está establecido, los únicos valores admitidos son SUM y CUSTOM Si sourceColumnOffset y, luego, CUSTOM no es compatible.

name

string

Es un nombre para el valor.

calculatedDisplayType

enum (PivotValueCalculatedDisplayType)

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, 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 van a utilizar para los valores de la tabla dinámica. Se debe establecer exactamente un valor. value solo puede ser una de las siguientes opciones:
sourceColumnOffset

integer

El desplazamiento de columna del rango de origen desde el que se lee este valor.

Por ejemplo, si la fuente era 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 una = carácter.

dataSourceColumnReference

object (DataSourceColumnReference)

Es la referencia a la columna de la fuente de datos de la que lee este valor.

PivotValueSummarizeFunction

Función para resumir un valor de tabla dinámica.

Enumeraciones
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED El valor predeterminado, no usar.
SUM Corresponde a la SUM .
COUNTA Corresponde a la COUNTA .
COUNT Corresponde a la COUNT .
COUNTUNIQUE Corresponde a la COUNTUNIQUE .
AVERAGE Corresponde a la AVERAGE .
MAX Corresponde a la MAX .
MIN Corresponde a la MIN .
MEDIAN Corresponde a la MEDIAN .
PRODUCT Corresponde a la PRODUCT .
STDEV Corresponde a la STDEV .
STDEVP Corresponde a la STDEVP .
VAR Corresponde a la 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 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 generales.

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 presentan verticalmente (como filas).