Pivot Tables

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

object (PivotGroup)

Cada fila se agrupa en la tabla dinámica.

object (PivotGroup)

Cada columna se agrupa en la tabla dinámica.

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 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 C10:E15, una clave de 0 tendrá 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.

object (PivotFilterSpec)

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

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

object (PivotValue)

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

enum (PivotValueLayout)

Indica si los valores se deben mostrar de forma horizontal (como columnas) o vertical (como filas).

object (DataExecutionStatus)

Solo salida. El estado de ejecución de los datos de las tablas dinámicas de la fuente de datos.

object (GridRange)

El rango desde el que se leen los datos en la tabla dinámica.

string

ID de la fuente de datos desde la que se leen los datos en la tabla dinámica.

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

boolean

Verdadero si la tabla dinámica debe incluir los totales para esta agrupación.

object (PivotGroupValueMetadata)

Metadatos sobre los valores de la agrupación.

enum (SortOrder)

El orden de los valores de este grupo debe estar ordenado.

object (PivotGroupSortValueBucket)

El bucket del grupo de tabla dinámica opuesto. Si no se especifica, se ordenarán los valores alfabéticamente según este grupo.

boolean

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

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

string

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 renombrar Item). Las tablas dinámicas creadas antes de diciembre de 2017 no tienen etiquetas de encabezado. Si quieres agregar etiquetas de encabezado a una tabla dinámica existente, bórrala 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 |
+--------------+---------+-------+

object (PivotGroupRule)

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

object (PivotGroupLimit)

El límite de recuento de filas o columnas que se aplicará a este grupo de elementos de tabla dinámica.

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 hace referencia a la columna C, mientras que el desplazamiento 1 haría referencia a la columna D.

object (DataSourceColumnReference)

La referencia a la columna de la fuente de datos en la que se basa esta agrupación.

{
  "value": {
    object (ExtendedValue)
  },
  "collapsed": boolean
}

object (ExtendedValue)

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

boolean

Verdadero si se contraen los datos correspondientes al valor.

{
  "valuesIndex": integer,
  "buckets": [
    {
      object (ExtendedValue)
    }
  ]
}

integer

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

object (ExtendedValue)

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.

{

  // 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.
}

object (ManualRule)

Un objeto ManualRule.

object (HistogramRule)

Un objeto HistogramRule.

object (DateTimeRule)

Un objeto DateTimeRule.

{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}

object (ManualRuleGroup)

La lista de nombres de grupos y los elementos correspondientes de los datos de origen que se asignan a cada nombre de grupo

{
  "groupName": {
    object (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}

object (ExtendedValue)

El nombre del grupo, que debe ser una string Cada grupo de una ManualRule determinada debe tener un nombre de grupo único.

object (ExtendedValue)

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

{
  "interval": number,
  "start": number,
  "end": number
}

number

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

number

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.

number

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.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

El tipo de agrupación de fecha y hora que se aplicará.

{
  "countLimit": integer,
  "applyOrder": integer
}

integer

El límite de recuento.

integer

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

{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}

string

Valores que deben incluirse. Se excluyen los valores que no aparecen aquí.

object (BooleanCondition)

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

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 =A1 en "Tabla dinámica 1" se trata como '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 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 NUMBER_GREATER y el valor =Cost, solo se incluyen las columnas en las que se incluyen "Ingresos" > "Costo".

boolean

Indica si los valores son visibles de forma predeterminada. Si es verdadero, se ignoran los visibleValues; 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.

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

object (PivotFilterCriteria)

Los criterios para la columna.

integer

El desplazamiento de columnas basado en cero del rango de origen.

object (DataSourceColumnReference)

La referencia a la columna de la fuente de datos.

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

enum (PivotValueSummarizeFunction)

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

string

Un nombre para el valor.

enum (PivotValueCalculatedDisplayType)

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.

integer

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 hace referencia a la columna C, mientras que el desplazamiento 1 haría referencia a la columna D.

string

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

object (DataSourceColumnReference)

Referencia a la columna de la fuente de datos en la que se lee este valor.