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 agrupación de filas en la tabla dinámica.

object (PivotGroup)

Cada columna agrupada 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 en la tabla dinámica. La clave del mapa es el desplazamiento de columna del rango de origen que deseas filtrar y el valor es los criterios 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 que se aplican a las columnas de origen antes de agregar datos para 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)

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

object (DataExecutionStatus)

Solo salida. Estado de ejecución de los datos para las tablas dinámicas de fuentes de datos.

object (GridRange)

El rango del que la tabla dinámica lee los datos.

string

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

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

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

object (PivotGroupValueMetadata)

Metadatos sobre los valores de la agrupación.

enum (SortOrder)

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

object (PivotGroupSortValueBucket)

La cubeta del grupo de tabla de tabla opuesto por el que se quiere ordenar. Si no se especifica, la ordenación es alfabética según los valores de este grupo.

boolean

Es verdadero si se deben repetir los encabezados de este grupo de elementos de tabla dinámica. Esta opción solo es válida para los grupos de filas y las columnas la ignoran.

De forma predeterminada, minimizamos la repetición de encabezados, ya que no mostramos los que tienen un nivel superior cuando son 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 el campo repeatheaders como verdadero, el "T1" se repetirá en "Feb" y "mar".

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

string

Las etiquetas que se pueden usar para los grupos de filas y columnas que se pueden personalizar. Por ejemplo, en la siguiente tabla dinámica, la etiqueta de fila es Region (que podría cambiarse a State) y la etiqueta de la columna es Product (que podría cambiarse 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, bórrala y 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)

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

object (PivotGroupLimit)

El límite 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 el origen era C10:E15, un sourceColumnOffset de 0 significa que este grupo hace referencia a la columna C, mientras que el desplazamiento 1 se refiere a la columna D.

object (DataSourceColumnReference)

Es la referencia a la columna de 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 porque se calcularán los valores).

boolean

Es 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 de esta agrupación.

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 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 corresponde a un valor en el segundo grupo de columnas. Si no se enumeran valores, esto indica que la fila debe ordenarse de acuerdo con el "Total general" en los grupos de columnas. Si se muestra un solo valor, correspondería al uso del “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)

Es un ManualRule.

object (HistogramRule)

Es un HistogramRule.

object (DateTimeRule)

Es un 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)

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

object (ExtendedValue)

Son 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 como máximo en un grupo de una ManualRule determinada. Los elementos que no aparezcan en ningún grupo aparecerán por su cuenta.

{
  "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 debajo del inicio 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 que están por encima del final se agrupan en un solo bucket. Este campo es opcional.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

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

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

integer

Es el límite de cantidad.

integer

Es el orden en el que se aplica el límite de grupos a la tabla dinámica.

Los límites del grupo dinámico 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 las solicitudes de escritura, para personalizar completamente los pedidos que se aplican, todos los límites del grupo de elementos dinámicos deben tener este campo configurado con un número único. De lo contrario, el orden lo determina el índice de la lista PivotTable.rows y, luego, la lista PivotTable.columns.

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

string

Son los valores que se deben incluir. Se excluyen los valores que no se mencionan aquí.

object (BooleanCondition)

Es 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 las condiciones 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.

El 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 llamadas "Revenue" y "Cost" y se aplica una condición a la columna "Revenue" con el tipo NUMBER_GREATER y el valor =Cost, solo se incluyen las columnas en las que "Revenue" > "Cost" se incluyen.

boolean

Si los valores son visibles de forma predeterminada. Si es verdadero, visibleValues se ignora, 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 de la columna.

integer

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

object (DataSourceColumnReference)

Es la referencia a la columna de 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)

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

string

Es un nombre para usar para el valor.

enum (PivotValueCalculatedDisplayType)

Si se especifica, indica que los valores dinámicos deben mostrarse como resultado de un cálculo con otro valor de tabla dinámica. Por ejemplo, si calculadoDisplayType se especifica como PERCENT_OF_GRAND_TOTAL, todos los valores dinámicos se muestran como un 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.

integer

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

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

string

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

object (DataSourceColumnReference)

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