CellData
Datos sobre una celda específica.
Representación JSON |
---|
{ "userEnteredValue": { object ( |
Campos | |
---|---|
userEnteredValue
|
Es el valor que el usuario ingresó en la celda. p.ej.,
|
effectiveValue
|
Valor efectivo de la celda. Para las celdas con fórmulas, este es el valor calculado. En el caso de las celdas con literales, es lo mismo que userEnteredValue. Este campo es de solo lectura. |
formattedValue
|
Es el valor con formato de la celda. Este es el valor tal como se le muestra al usuario. Este campo es de solo lectura. |
userEnteredFormat
|
Indica el formato que el usuario ingresó para la celda. Cuando escribas, el nuevo formato se combinará con el existente. |
effectiveFormat
|
Formato efectivo que utiliza la celda. Esto incluye los resultados de aplicar cualquier formato condicional y, si la celda contiene una fórmula, el formato de número calculado. Si el formato efectivo es el predeterminado, no se escribirá. Este campo es de solo lectura. |
hyperlink
|
Es un hipervínculo al que apunta esta celda, si corresponde. Si la celda contiene varios hipervínculos, este campo estará vacío. Este campo es de solo lectura. Para establecerlo, usa un
|
note
|
Cualquier nota en la celda |
textFormatRuns[]
|
Ejecuciones de texto enriquecido aplicadas a subsecciones de la celda Las ejecuciones solo son válidas en las cadenas ingresadas por el usuario, no en fórmulas, booleanos ni números. Las propiedades de una ejecución se inician en un índice específico del texto y continúan hasta la próxima ejecución. Las ejecuciones heredarán las propiedades de la celda, a menos que se modifiquen de forma explícita.
Cuando escribas, las ejecuciones nuevas reemplazarán a las anteriores. Cuando escribas un nuevo
|
dataValidation
|
Una regla de validación de datos en la celda, si existe. Cuando escribas, la nueva regla de validación de datos reemplazará cualquier regla anterior. |
pivotTable
|
Una tabla dinámica anclada en esta celda. El tamaño de la tabla dinámica se calcula dinámicamente en función de sus datos, agrupación, filtros, valores, etc. Solo la celda superior izquierda de la tabla dinámica contiene su definición. Las otras celdas contendrán los valores calculados de los resultados de la tabla dinámica en su
|
dataSourceTable
|
Una tabla de fuente de datos anclada en esta celda. El tamaño de la tabla de la fuente de datos se calcula dinámicamente en función de su configuración. Solo la primera celda de la tabla de la fuente de datos contiene la definición de la tabla de la fuente de datos. Las otras celdas contendrán los valores de visualización del resultado de la tabla de fuente de datos en su
|
dataSourceFormula
|
Solo salida. Información sobre la fórmula de una fuente de datos en la celda. El campo se establece si
|
CellFormat
Indica el formato de una celda.
Representación JSON |
---|
{ "numberFormat": { object ( |
Campos | |
---|---|
numberFormat
|
Un formato que describe cómo se deben representar los valores numéricos al usuario. |
backgroundColor
|
El color de fondo de la celda. Obsoleto: usar
|
backgroundColorStyle
|
El color de fondo de la celda. Si
|
borders
|
Los bordes de la celda. |
padding
|
El relleno de la celda. |
horizontalAlignment
|
Es la alineación horizontal del valor de la celda. |
verticalAlignment
|
Es la alineación vertical del valor de la celda. |
wrapStrategy
|
Es la estrategia de unión del valor de la celda. |
textDirection
|
Indica la dirección del texto de la celda. |
textFormat
|
El formato del texto de la celda (a menos que un formato que se ejecute lo anule). Si estableces un vínculo a nivel de la celda aquí, se borrarán los vínculos existentes de la celda. Configurar el campo de vínculo en una
|
hyperlinkDisplayType
|
Si existe uno, indica cómo se debe mostrar un hipervínculo en la celda. |
textRotation
|
Es la rotación que se aplica al texto de la celda. |
NumberFormat
Es el formato de número de una celda.
Representación JSON |
---|
{
"type": enum (
|
Campos | |
---|---|
type
|
Es el tipo de formato de número. Al escribir, se debe establecer este campo. |
pattern
|
Cadena de patrón usada para dar formato. Si no se establece, se usará un patrón predeterminado basado en la configuración regional del usuario en caso de ser necesario para el tipo determinado. Consulta la Guía sobre formatos de fecha y número para obtener más información sobre los patrones admitidos. |
NumberFormatType
Es el formato de número de la celda. En esta documentación, se supone que la configuración regional es en_US, pero el formato real depende de la configuración regional de la hoja de cálculo.
Enumeraciones | |
---|---|
NUMBER_FORMAT_TYPE_UNSPECIFIED
|
El formato de número no se especifica y se basa en el contenido de la celda. No lo uses explícitamente. |
TEXT
|
Formato de texto, p. ej.,
1000.12
|
NUMBER
|
Formato de números, p. ej.,
1,000.12
|
PERCENT
|
Formato de porcentaje, p. ej.,
10.12%
|
CURRENCY
|
Formato de moneda, p. ej.,
$1,000.12
|
DATE
|
Formato de fecha, p. ej.,
9/26/2008
|
TIME
|
Formato de hora, p. ej.,
3:59:00 PM
|
DATE_TIME
|
Formato de fecha + hora, p. ej.,
9/26/08 15:59:00
|
SCIENTIFIC
|
Formato de números científicos, p. ej.,
1.01E+03
|
Bordes
Los bordes de la celda.
Representación JSON |
---|
{ "top": { object ( |
Campos | |
---|---|
top
|
Borde superior de la celda. |
bottom
|
Borde inferior de la celda. |
left
|
Borde izquierdo de la celda. |
right
|
Borde derecho de la celda. |
Borde
Un borde a lo largo de una celda
Representación JSON |
---|
{ "style": enum ( |
Campos | |
---|---|
style
|
El estilo del borde. |
width
|
Indica el ancho del borde en píxeles. Obsoleto; el ancho se determina por el valor de "estilo" . |
color
|
El color del borde. Obsoleto: usar
|
colorStyle
|
El color del borde. Si
|
Estilo
Es el estilo de un borde.
Enumeraciones | |
---|---|
STYLE_UNSPECIFIED
|
No se especificó el estilo. No la uses. |
DOTTED
|
El borde está punteado. |
DASHED
|
El borde es discontinuo. |
SOLID
|
El borde es una línea continua delgada. |
SOLID_MEDIUM
|
El borde es una línea continua mediana. |
SOLID_THICK
|
El borde es una línea continua gruesa. |
NONE
|
Sin borde. Se utiliza solo cuando se actualiza un borde para borrarlo. |
DOUBLE
|
El borde tiene dos líneas continuas. |
Relleno
Es la cantidad de padding alrededor de la celda, en píxeles. Cuando se actualiza el padding, se deben especificar todos los campos.
Representación JSON |
---|
{ "top": integer, "right": integer, "bottom": integer, "left": integer } |
Campos | |
---|---|
top
|
Padding superior de la celda. |
right
|
El padding derecho de la celda. |
bottom
|
Padding inferior de la celda |
left
|
Relleno izquierdo de la celda. |
VerticalAlign
Es la alineación vertical del texto de una celda.
Enumeraciones | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
No se especificó la alineación vertical. No la uses. |
TOP
|
El texto se alinea explícitamente con la parte superior de la celda. |
MIDDLE
|
El texto está alineado de manera explícita con el centro de la celda. |
BOTTOM
|
El texto se alinea explícitamente con la parte inferior de la celda. |
WrapStrategy
Cómo ajustar texto en una celda
Enumeraciones | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
El valor predeterminado, no usar. |
OVERFLOW_CELL
|
Las líneas que sean más largas que el ancho de la celda se escribirán en la siguiente celda, siempre que la celda esté vacía. Si la siguiente celda no está vacía, se comporta igual que
|
LEGACY_WRAP
|
Esta estrategia de ajuste representa la estrategia de ajuste anterior de Hojas de cálculo de Google, en la que las palabras que son más largas que una línea se recortan en lugar de romperse. Esta estrategia no es compatible con todas las plataformas y se eliminará gradualmente. Ejemplo:
|
CLIP
|
Las líneas que sean más largas que el ancho de la celda se recortarán. El texto nunca se ajustará a la siguiente línea, a menos que el usuario inserte manualmente una nueva línea. Ejemplo:
|
WRAP
|
Las palabras que son más largas que una línea se unen a nivel de carácter en lugar de recortarse. Ejemplo:
|
TextDirection
Indica la dirección del texto de una celda.
Enumeraciones | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
No se especificó la dirección del texto. No la uses. |
LEFT_TO_RIGHT
|
El usuario estableció la dirección del texto de izquierda a derecha. |
RIGHT_TO_LEFT
|
El usuario estableció la dirección del texto de derecha a izquierda. |
HyperlinkDisplayType
Indica si se debe renderizar de forma explícita un hipervínculo. Si no se especifica, se vincula el hipervínculo.
Enumeraciones | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
El valor predeterminado: se renderiza el hipervínculo. No la uses. |
LINKED
|
Un hipervínculo debe representarse de manera explícita. |
PLAIN_TEXT
|
No se debe renderizar un hipervínculo. |
TextRotation
Es la rotación que se aplica al texto de una celda.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión
type Indica el tipo de rotación, ya sea vertical o angular.
type
solo puede ser una de las siguientes opciones:
|
|
angle
|
El ángulo entre la orientación estándar y la orientación deseada. Se mide en grados. Los valores válidos deben estar entre -90 y 90. Los ángulos positivos son hacia arriba y los negativos, hacia abajo. Nota: Para la dirección de texto LTR, los ángulos positivos son en sentido antihorario, mientras que para RTL, en el sentido de las manecillas del reloj, en el sentido de las manecillas del reloj. |
vertical
|
Si es verdadero, el texto se lee de arriba abajo, pero la orientación de los caracteres individuales no cambia. Por ejemplo:
|
TextFormatRun
Ejecución en formato de texto El formato de esta ejecución continúa hasta el índice de inicio de la siguiente ejecución. Durante la actualización, se deben configurar todos los campos.
Representación JSON |
---|
{
"startIndex": integer,
"format": {
object (
|
Campos | |
---|---|
startIndex
|
El índice de caracteres basado en cero donde comienza esta ejecución, en unidades de código UTF-16. |
format
|
Es el formato de esta ejecución. Los valores faltantes heredan el formato de la celda. |
DataValidationRule
Una regla de validación de datos.
Representación JSON |
---|
{
"condition": {
object (
|
Campos | |
---|---|
condition
|
Es la condición con la que deben coincidir los datos de la celda. |
inputMessage
|
Es un mensaje que se muestra al usuario cuando se agregan datos a la celda. |
strict
|
Es verdadero si se deben rechazar los datos no válidos. |
showCustomUi
|
Es verdadero si la IU debe personalizarse según el tipo de condición. Si es "true", "Lista" condiciones mostrará un menú desplegable. |
DataSourceTable
Una tabla de fuente de datos, que permite al usuario importar una tabla estática de datos desde el
DataSource
a Hojas de cálculo. Esto también se conoce como "Extraer" en el editor de Hojas de cálculo.
Representación JSON |
---|
{ "dataSourceId": string, "columnSelectionType": enum ( |
Campos | |
---|---|
dataSourceId
|
Es el ID de la fuente de datos con la que está asociada la tabla de fuente de datos. |
columnSelectionType
|
El tipo con el que se seleccionarán columnas para la tabla de fuente de datos. La configuración predeterminada es
|
columns[]
|
Columnas seleccionadas para la tabla de fuente de datos. El
|
filterSpecs[]
|
Filtra las especificaciones en la tabla de fuente de datos. |
sortSpecs[]
|
Ordenar las especificaciones en la tabla de fuente de datos El resultado de la tabla de fuente de datos se ordena según las especificaciones de orden. |
rowLimit
|
El límite de filas para mostrar. Si no la estableces, se aplicará un límite predeterminado. Consulta el editor de Hojas de cálculo para conocer los límites máximo y predeterminado. |
dataExecutionStatus
|
Solo salida. Es el estado de ejecución de los datos. |
DataSourceTableColumnSelectionType
Los tipos de selección de columnas de la tabla de fuente de datos.
Enumeraciones | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED
|
El tipo de selección de columnas predeterminado; no usar. |
SELECTED
|
Seleccionar columnas especificadas por
columns
.
|
SYNC_ALL
|
Sincroniza todas las columnas actuales y futuras de la fuente de datos. Si se configura, la tabla de fuente de datos recupera todas las columnas de la fuente de datos en el momento de la actualización. |
DataSourceFormula
Fórmula de la fuente de datos.
Representación JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object (
|
Campos | |
---|---|
dataSourceId
|
El ID de la fuente de datos con la que está asociada la fórmula. |
dataExecutionStatus
|
Solo salida. Es el estado de ejecución de los datos. |