Sheets

Hoja de cálculo

Es una hoja en una hoja de cálculo.

Representación JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
Campos
properties

object (SheetProperties)

Son las propiedades de la hoja.

data[]

object (GridData)

Son los datos de la cuadrícula, si se trata de una hoja de cuadrícula.

La cantidad de objetos GridData que se devuelven depende de la cantidad de rangos solicitados en esta hoja. Por ejemplo, si esto representa Sheet1 y la hoja de cálculo se solicitó con los rangos Sheet1!A1:C10 y Sheet1!D15:E20, el primer GridData tendrá un startRow/startColumn de 0, mientras que el segundo tendrá startRow 14 (fila 15 basada en cero) y startColumn 3 (columna D basada en cero).

En el caso de una hoja de cálculo de DATA_SOURCE, no puedes solicitar un rango específico, ya que GridData contiene todos los valores.

merges[]

object (GridRange)

Son los rangos que se combinan.

conditionalFormats[]

object (ConditionalFormatRule)

Son las reglas de formato condicional de esta hoja.

filterViews[]

object (FilterView)

Son las vistas de filtro de esta hoja.

protectedRanges[]

object (ProtectedRange)

Son los rangos protegidos en esta hoja.

basicFilter

object (BasicFilter)

Es el filtro de esta hoja, si hay alguno.

charts[]

object (EmbeddedChart)

Son las especificaciones de cada gráfico de esta hoja.

bandedRanges[]

object (BandedRange)

Son los rangos con bandas (colores alternados) de esta hoja.

developerMetadata[]

object (DeveloperMetadata)

Son los metadatos del desarrollador asociados con una hoja.

rowGroups[]

object (DimensionGroup)

Todos los grupos de filas de esta hoja, ordenados por índice de inicio del rango en aumento y, luego, por profundidad del grupo.

columnGroups[]

object (DimensionGroup)

Todos los grupos de columnas de esta hoja, ordenados por índice de inicio del rango en aumento y, luego, por profundidad del grupo.

slicers[]

object (Slicer)

Son las segmentaciones de esta hoja.

tables[]

object (Table)

Son las tablas de esta hoja.

SheetProperties

Son las propiedades de una hoja.

Representación JSON 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
Campos
sheetId

integer

Es el ID de la hoja. Must be non-negative (La precisión de las coordenadas de latitud y longitud, en metros. No debe ser un valor negativo). Este campo no se puede cambiar una vez que se configura.

title

string

Es el nombre de la hoja.

index

integer

Índice de la hoja dentro de la hoja de cálculo. Cuando se agregan o actualizan propiedades de la hoja, si se excluye este campo, la hoja se agrega o se mueve al final de la lista de hojas. Cuando se actualizan los índices de las hojas o se insertan hojas, el movimiento se considera en los índices "antes del movimiento". Por ejemplo, si hay tres hojas (H1, H2 y H3) y quieres mover H1 antes de H2, el índice se debe establecer en 2. Se ignora una solicitud de actualización del índice de la hoja si el índice solicitado es idéntico al índice actual de la hoja o si el nuevo índice solicitado es igual al índice actual de la hoja + 1.

sheetType

enum (SheetType)

Es el tipo de hoja. El valor predeterminado es GRID. Este campo no se puede cambiar una vez que se configura.

gridProperties

object (GridProperties)

Son las propiedades adicionales de la hoja si esta es una cuadrícula. (Si la hoja es una hoja de objeto y contiene un gráfico o una imagen, este campo no estará presente). Cuando se escribe, es un error establecer propiedades de cuadrícula en hojas que no son de cuadrícula.

Si esta hoja es una hoja de DATA_SOURCE, este campo es solo de salida, pero contiene las propiedades que reflejan cómo se renderiza una hoja de fuente de datos en la IU, p.ej., rowCount.

hidden

boolean

Es verdadero si la hoja está oculta en la IU y falso si está visible.

tabColor
(deprecated)

object (Color)

Color de la pestaña en la IU. Obsoleto: Usa tabColorStyle.

tabColorStyle

object (ColorStyle)

Color de la pestaña en la IU. Si también se establece tabColor, este campo tendrá prioridad.

rightToLeft

boolean

Es verdadero si la hoja es RTL en lugar de LTR.

dataSourceSheetProperties

object (DataSourceSheetProperties)

Solo salida. Si está presente, el campo contiene propiedades específicas de la hoja DATA_SOURCE.

SheetType

Es el tipo de hoja.

Enums
SHEET_TYPE_UNSPECIFIED Es un valor predeterminado que no se debe usar.
GRID La hoja es una cuadrícula.
OBJECT La hoja no tiene cuadrícula y, en cambio, tiene un objeto, como un gráfico o una imagen.
DATA_SOURCE La hoja se conecta con un DataSource externo DataSource y muestra la vista previa de los datos.

GridProperties

Son las propiedades de una cuadrícula.

Representación JSON 
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
Campos
rowCount

integer

Es la cantidad de filas de la cuadrícula.

columnCount

integer

Es la cantidad de columnas de la cuadrícula.

frozenRowCount

integer

Cantidad de filas inmovilizadas en la cuadrícula.

frozenColumnCount

integer

Cantidad de columnas inmovilizadas en la cuadrícula.

hideGridlines

boolean

Es verdadero si la cuadrícula no muestra líneas en la IU.

rowGroupControlAfter

boolean

Es verdadero si el botón de activación del control de agrupación de filas se muestra después del grupo.

columnGroupControlAfter

boolean

Es verdadero si el botón de activación del control de agrupación de columnas se muestra después del grupo.

DataSourceSheetProperties

Son propiedades adicionales de una hoja de cálculo de DATA_SOURCE.

Representación JSON 
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Campos
dataSourceId

string

ID de la DataSource a la que está conectada la hoja.

columns[]

object (DataSourceColumn)

Son las columnas que se muestran en la hoja y que corresponden a los valores de RowData.

dataExecutionStatus

object (DataExecutionStatus)

Es el estado de ejecución de los datos.

GridData

Datos en la cuadrícula, así como metadatos sobre las dimensiones

Representación JSON 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
Campos
startRow

integer

Es la primera fila a la que hace referencia este GridData, con base cero.

startColumn

integer

Es la primera columna a la que hace referencia este GridData, con base cero.

rowData[]

object (RowData)

Son los datos de la cuadrícula, con una entrada por fila, comenzando con la fila en startRow. Los valores de RowData corresponderán a las columnas que comienzan en startColumn.

rowMetadata[]

object (DimensionProperties)

Son los metadatos sobre las filas solicitadas en la cuadrícula, comenzando por la fila en startRow.

columnMetadata[]

object (DimensionProperties)

Son los metadatos sobre las columnas solicitadas en la cuadrícula, comenzando por la columna en startColumn.

RowData

Son los datos sobre cada celda de una fila.

Representación JSON 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
Campos
values[]

object (CellData)

Son los valores de la fila, uno por columna.

DimensionProperties

Son propiedades sobre una dimensión.

Representación JSON 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
Campos
hiddenByFilter

boolean

Es verdadero si se está filtrando esta dimensión. Este campo es de solo lectura.

hiddenByUser

boolean

Es verdadero si esta dimensión está oculta de forma explícita.

pixelSize

integer

Es la altura (si es una fila) o el ancho (si es una columna) de la dimensión en píxeles.

developerMetadata[]

object (DeveloperMetadata)

Son los metadatos del desarrollador asociados a una sola fila o columna.

dataSourceColumnReference

object (DataSourceColumnReference)

Solo salida. Si se configura, esta es una columna en una hoja de la fuente de datos.

ConditionalFormatRule

Es una regla que describe un formato condicional.

Representación JSON 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
Campos
ranges[]

object (GridRange)

Son los rangos que se formatean si la condición es verdadera. Todos los rangos deben estar en la misma cuadrícula.

Campo de unión rule. Es la regla que controla este formato condicional. Se debe establecer exactamente una. rule puede ser solo uno de los siguientes valores:
booleanRule

object (BooleanRule)

El formato está "activado" o "desactivado" según la regla.

gradientRule

object (GradientRule)

El formato variará según los gradientes de la regla.

BooleanRule

Es una regla que puede coincidir o no, según la condición.

Representación JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
Campos
condition

object (BooleanCondition)

Es la condición de la regla. Si la condición se evalúa como verdadera, se aplica el formato.

format

object (CellFormat)

Es el formato que se aplicará. El formato condicional solo puede aplicar un subconjunto de formatos: bold, italic, strikethrough, foreground color y, background color.

GradientRule

Es una regla que aplica un formato de escala de color de gradiente según los puntos de interpolación que se indican. El formato de una celda variará según su contenido en comparación con los valores de los puntos de interpolación.

Representación JSON 
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
Campos
minpoint

object (InterpolationPoint)

Es el punto de interpolación inicial.

midpoint

object (InterpolationPoint)

Es un punto de interpolación intermedio opcional.

maxpoint

object (InterpolationPoint)

Es el punto de interpolación final.

InterpolationPoint

Es un solo punto de interpolación en un formato condicional de gradiente. Estos fijan la escala de gradientes de color según el color, el tipo y el valor elegidos.

Representación JSON 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
Campos
color
(deprecated)

object (Color)

Color que debe usar este punto de interpolación. Obsoleto: Usa colorStyle.

colorStyle

object (ColorStyle)

Color que debe usar este punto de interpolación. Si también se establece color, este campo tendrá prioridad.

type

enum (InterpolationPointType)

Indica cómo se debe interpretar el valor.

value

string

Es el valor que usa este punto de interpolación. Puede ser una fórmula. No se usa si type es MIN o MAX.

InterpolationPointType

Es el tipo de punto de interpolación.

Enums
INTERPOLATION_POINT_TYPE_UNSPECIFIED Es el valor predeterminado y no se debe usar.
MIN El punto de interpolación usa el valor mínimo en las celdas del rango del formato condicional.
MAX El punto de interpolación usa el valor máximo en las celdas del rango del formato condicional.
NUMBER El punto de interpolación usa exactamente el valor en InterpolationPoint.value.
PERCENT

El punto de interpolación es el porcentaje determinado en todas las celdas del rango del formato condicional. Esto equivale a NUMBER si el valor era =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (en el que se ignoran los errores en el rango cuando se aplana).

PERCENTILE El punto de interpolación es el percentil determinado en todas las celdas del rango del formato condicional. Esto equivale a NUMBER si el valor era: =PERCENTILE(FLATTEN(range), value / 100) (donde se ignoran los errores en el rango cuando se aplana).

FilterView

Es una vista de filtro. Para obtener más información, consulta Administra la visibilidad de los datos con filtros.

Representación JSON 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Campos
filterViewId

integer

Es el ID de la vista de filtro.

title

string

Es el nombre de la vista de filtro.

range

object (GridRange)

Es el rango que abarca esta vista de filtro.

Cuando escribas, solo se puede establecer uno de los siguientes valores: range, namedRangeId o tableId.

namedRangeId

string

Es el rango con nombre en el que se basa esta vista de filtro, si existe.

Cuando escribas, solo se puede establecer uno de los siguientes valores: range, namedRangeId o tableId.

tableId

string

Es la tabla en la que se basa esta vista de filtro, si la hay.

Cuando escribas, solo se puede establecer uno de los siguientes valores: range, namedRangeId o tableId.

sortSpecs[]

object (SortSpec)

Es el orden de clasificación por columna. Las especificaciones posteriores se usan cuando los valores son iguales en las especificaciones anteriores.

criteria
(deprecated)

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

Son los criterios para mostrar u ocultar valores por columna. La clave del mapa es el índice de la columna, y el valor es el criterio para esa columna.

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

filterSpecs[]

object (FilterSpec)

Son los criterios de filtro para mostrar u ocultar valores por columna.

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

ProtectedRange

Es un rango protegido.

Representación JSON 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
Campos
protectedRangeId

integer

Es el ID del rango protegido. Este campo es de solo lectura.

range

object (GridRange)

Es el rango que se protege. El rango puede no tener límites, en cuyo caso se considera una hoja protegida.

Cuando escribas, solo se puede establecer uno de los siguientes valores: range o namedRangeId o tableId.

namedRangeId

string

Es el rango con nombre en el que se basa este rango protegido, si corresponde.

Cuando escribas, solo se puede establecer uno de los siguientes valores: range o namedRangeId o tableId.

tableId

string

Es la tabla que respalda este rango protegido, si existe.

Cuando escribas, solo se puede establecer uno de los siguientes valores: range o namedRangeId o tableId.

description

string

Es la descripción de este rango protegido.

warningOnly

boolean

Es verdadero si este rango protegido mostrará una advertencia cuando se edite. La protección basada en advertencias significa que todos los usuarios pueden editar datos en el rango protegido, pero la edición generará una advertencia que le pedirá al usuario que confirme la edición.

Cuando se escribe: Si este campo es verdadero, se ignoran editors. Además, si este campo cambia de verdadero a falso y el campo editors no está configurado (ni incluido en la máscara de campo), los editores se establecerán en todos los editores del documento.

requestingUserCanEdit

boolean

Es verdadero si el usuario que solicitó este rango protegido puede editar el área protegida. Este campo es de solo lectura.

unprotectedRanges[]

object (GridRange)

Es la lista de rangos sin protección dentro de una hoja protegida. Los rangos sin protección solo se admiten en las hojas protegidas.

editors

object (Editors)

Usuarios y grupos con acceso de edición al rango protegido. Este campo solo es visible para los usuarios con acceso de edición al rango protegido y al documento. Los editores no son compatibles con la protección de warningOnly.

Editores

Son los editores de un rango protegido.

Representación JSON 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
Campos
users[]

string

Son las direcciones de correo electrónico de los usuarios con acceso de edición al rango protegido.

groups[]

string

Son las direcciones de correo electrónico de los grupos con acceso de edición al rango protegido.

domainUsersCanEdit

boolean

Es verdadero si cualquier persona del dominio del documento tiene acceso de edición al rango protegido. La protección del dominio solo se admite en documentos dentro de un dominio.

BasicFilter

Es el filtro predeterminado asociado a una hoja. Para obtener más información, consulta Administra la visibilidad de los datos con filtros.

Representación JSON 
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Campos
range

object (GridRange)

Es el rango que abarca el filtro.

tableId

string

Es la tabla en la que se basa este filtro, si la hay. Cuando se escribe, solo se puede establecer uno de los siguientes valores: range o tableId.

sortSpecs[]

object (SortSpec)

Es el orden de clasificación por columna. Las especificaciones posteriores se usan cuando los valores son iguales en las especificaciones anteriores.

criteria
(deprecated)

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

Son los criterios para mostrar u ocultar valores por columna. La clave del mapa es el índice de la columna, y el valor es el criterio para esa columna.

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

filterSpecs[]

object (FilterSpec)

Son los criterios de filtro por columna.

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

BandedRange

Es un rango con bandas (colores alternados) en una hoja.

Representación JSON 
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Campos
bandedRangeId

integer

Es el ID del rango agrupado. Si no se configura, consulta bandedRangeReference.

bandedRangeReference

string

Solo salida. Es la referencia del rango agrupado, que se usa para identificar el ID que no admite bandedRangeId.

range

object (GridRange)

Es el rango en el que se aplican estas propiedades.

rowProperties

object (BandingProperties)

Son las propiedades de las bandas de filas. Estas propiedades se aplican fila por fila en todo el rango. Se debe especificar al menos uno de los siguientes valores: rowProperties o columnProperties.

columnProperties

object (BandingProperties)

Son las propiedades de las bandas de columnas. Estas propiedades se aplican columna por columna en todas las columnas del rango. Se debe especificar al menos uno de los siguientes valores: rowProperties o columnProperties.

BandingProperties

Son propiedades que hacen referencia a una sola dimensión (ya sea fila o columna). Si se configuran BandedRange.row_properties y BandedRange.column_properties, los colores de relleno se aplican a las celdas según las siguientes reglas:

Por ejemplo, el color de la primera fila tiene prioridad sobre el color de la primera columna, pero el color de la primera columna tiene prioridad sobre el color de la segunda fila. Del mismo modo, el encabezado de fila tiene prioridad sobre el encabezado de columna en la celda superior izquierda, pero el encabezado de columna tiene prioridad sobre el color de la primera fila si no se configura el encabezado de fila.

Representación JSON 
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Campos
headerColor
(deprecated)

object (Color)

Es el color de la primera fila o columna. Si se configura este campo, la primera fila o columna se completa con este color, y los colores alternan entre firstBandColor y secondBandColor a partir de la segunda fila o columna. De lo contrario, la primera fila o columna se completa con firstBandColor y los colores se alternan como lo harían normalmente. Obsoleto: Usa headerColorStyle.

headerColorStyle

object (ColorStyle)

Es el color de la primera fila o columna. Si se configura este campo, la primera fila o columna se completa con este color, y los colores alternan entre firstBandColor y secondBandColor a partir de la segunda fila o columna. De lo contrario, la primera fila o columna se completa con firstBandColor y los colores se alternan como lo harían normalmente. Si también se establece headerColor, este campo tendrá prioridad.

firstBandColor
(deprecated)

object (Color)

Es el primer color que se alterna. (Obligatorio) Obsoleto: Usa firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

Es el primer color que se alterna. (Obligatorio) Si también se establece firstBandColor, este campo tiene prioridad.

secondBandColor
(deprecated)

object (Color)

Es el segundo color que se alterna. (Obligatorio) Obsoleto: Usa secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Es el segundo color que se alterna. (Obligatorio) Si también se establece secondBandColor, este campo tiene prioridad.

footerColor
(deprecated)

object (Color)

Es el color de la última fila o columna. Si no se configura este campo, la última fila o columna se completará con firstBandColor o secondBandColor, según el color de la fila o columna anterior. Obsoleto: Usa footerColorStyle.

footerColorStyle

object (ColorStyle)

Es el color de la última fila o columna. Si no se configura este campo, la última fila o columna se completará con firstBandColor o secondBandColor, según el color de la fila o columna anterior. Si también se establece footerColor, este campo tendrá prioridad.

DimensionGroup

Es un grupo que abarca un intervalo de filas o columnas en una hoja y que puede contener otros grupos o estar contenido dentro de ellos. Un grupo se puede contraer o expandir como una unidad en la hoja.

Representación JSON 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Campos
range

object (DimensionRange)

Es el rango en el que existe este grupo.

depth

integer

Es la profundidad del grupo, que representa cuántos grupos tienen un rango que contiene por completo el rango de este grupo.

collapsed

boolean

Este campo es verdadero si este grupo está contraído. Un grupo contraído permanece contraído si se expande un grupo superpuesto a una profundidad menor.

Un valor verdadero no implica que todas las dimensiones dentro del grupo estén ocultas, ya que la visibilidad de una dimensión puede cambiar independientemente de esta propiedad del grupo. Sin embargo, cuando se actualiza esta propiedad, todas las dimensiones que contiene se establecen como ocultas si este campo es verdadero o como visibles si este campo es falso.

Control de filtro

Es un filtro en una hoja.

Representación JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
Campos
slicerId

integer

Es el ID del segmentador.

spec

object (SlicerSpec)

Es la especificación del segmentador.

position

object (EmbeddedObjectPosition)

Es la posición del segmentador. Ten en cuenta que el segmentador solo se puede colocar en una hoja existente. Además, el ancho y el alto de la segmentación se pueden ajustar automáticamente para mantenerla dentro de los límites permitidos.

SlicerSpec

Son las especificaciones de un segmentador.

Representación JSON 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
Campos
dataRange

object (GridRange)

Es el rango de datos del segmentador.

filterCriteria

object (FilterCriteria)

Son los criterios de filtrado de la segmentación.

columnIndex

integer

Es el índice de columna basado en cero en la tabla de datos en la que se aplica el filtro.

applyToPivotTables

boolean

Es verdadero si el filtro se debe aplicar a las tablas dinámicas. Si no se establece, el valor predeterminado es True.

title

string

Es el título del segmentador.

textFormat

object (TextFormat)

Es el formato de texto del título en la segmentación. No se admite el campo de vínculo.

backgroundColor
(deprecated)

object (Color)

Es el color de fondo del segmentador. Obsoleto: Usa backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Es el color de fondo del segmentador. Si también se establece backgroundColor, este campo tendrá prioridad.

horizontalAlignment

enum (HorizontalAlign)

Es la alineación horizontal del título en el segmentador. Si no se especifica, el valor predeterminado es LEFT.

Tabla

Una mesa

Representación JSON 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Campos
tableId

string

Es el ID de la tabla.

name

string

Es el nombre de la tabla. Es único para todas las tablas de la misma hoja de cálculo.

range

object (GridRange)

Es el rango de la tabla.

rowsProperties

object (TableRowsProperties)

Son las propiedades de las filas de la tabla.

columnProperties[]

object (TableColumnProperties)

Son las propiedades de la columna de la tabla.

TableRowsProperties

Son las propiedades de la fila de la tabla.

Representación JSON 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Campos
headerColorStyle

object (ColorStyle)

Es el color de la fila del encabezado. Si se configura este campo, la fila de encabezado se completará con el color especificado. De lo contrario, la fila de encabezado se completará con un color predeterminado.

firstBandColorStyle

object (ColorStyle)

Es el primer color que se alterna. Si se configura este campo, la primera fila con bandas se rellena con el color especificado. De lo contrario, la primera fila con bandas se completará con un color predeterminado.

secondBandColorStyle

object (ColorStyle)

Es el segundo color que se alterna. Si se configura este campo, la segunda fila con bandas se rellena con el color especificado. De lo contrario, la segunda fila con bandas se completará con un color predeterminado.

footerColorStyle

object (ColorStyle)

Es el color de la última fila. Si no se configura este campo, no se agrega un pie de página y la última fila se completa con firstBandColorStyle o secondBandColorStyle, según el color de la fila anterior. Si actualizas una tabla existente sin pie de página para que tenga uno, el rango se expandirá en 1 fila. Si actualizas una tabla existente con un pie de página y quitas el pie de página, el rango se reducirá en 1 fila.

TableColumnProperties

Columna de la tabla.

Representación JSON 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
Campos
columnIndex

integer

Índice de columna basado en 0. Este índice es relativo a su posición en la tabla y no necesariamente es el mismo que el índice de columna en la hoja.

columnName

string

El nombre de la columna.

columnType

enum (ColumnType)

Es el tipo de columna.

dataValidationRule

object (TableColumnDataValidationRule)

Es la regla de validación de datos de la columna. Solo se establece para el tipo de columna de menú desplegable.

ColumnType

Es el tipo de columna para una columna determinada en una tabla.

Enums
COLUMN_TYPE_UNSPECIFIED Es un tipo de columna no especificado.
DOUBLE Es el tipo de columna de número.
CURRENCY Es el tipo de columna de moneda.
PERCENT Es el tipo de columna de porcentaje.
DATE Es el tipo de columna de fecha.
TIME Es el tipo de columna de tiempo.
DATE_TIME Es el tipo de columna de fecha y hora.
TEXT Es el tipo de columna de texto.
BOOLEAN Es el tipo de columna booleana.
DROPDOWN Es el tipo de columna de menú desplegable.
FILES_CHIP Es el tipo de columna de chip de archivos.
PEOPLE_CHIP Es el tipo de columna de chip de persona.
FINANCE_CHIP El tipo de columna de chip de Finance
PLACE_CHIP El tipo de columna de chip de lugar
RATINGS_CHIP El tipo de columna de chip de calificaciones

TableColumnDataValidationRule

Es una regla de validación de datos para una columna en una tabla.

Representación JSON 
{
  "condition": {
    object (BooleanCondition)
  }
}
Campos
condition

object (BooleanCondition)

Es la condición que deben cumplir los datos de la celda. Solo es válido si [BooleanCondition.type] es ONE_OF_LIST.