Datos móviles
Datos sobre una celda específica
Representación JSON |
---|
{ "userEnteredValue": { object ( |
Campos | |
---|---|
userEnteredValue
|
El valor que el usuario ingresó en la celda. P.ej.,
|
effectiveValue
|
El valor efectivo de la celda. Para las celdas con fórmulas, este es el valor calculado. Para celdas con literales, es lo mismo que userEnteredValue. Este campo es de solo lectura. |
formattedValue
|
El valor con formato de la celda. Este es el valor tal como se 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 formato existente. |
effectiveFormat
|
Formato eficaz que utiliza la celda. Esto incluye los resultados de la aplicación de cualquier formato condicional y, si la celda contiene una fórmula, el formato del número calculado. Si el formato efectivo es el predeterminado, no se escribirá. Este campo es de solo lectura. |
hyperlink
|
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 configurarlo, usa una fórmula |
note
|
Cualquier nota de la celda |
textFormatRuns[]
|
Secuencias de texto enriquecido aplicadas en subsecciones de la celda Las ejecuciones solo son válidas para las strings que ingresa el usuario, no para las fórmulas, los bool ni los números. Las propiedades de una ejecución comienzan 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 escriba, las ejecuciones nuevas reemplazarán cualquier ejecución anterior. Cuando escribes un |
dataValidation
|
Una regla de validación de datos en la celda, si corresponde Cuando se escriba, la nueva regla de validación de datos reemplazará cualquier regla anterior. |
pivotTable
|
Una tabla dinámica fija en esta celda. El tamaño de la tabla dinámica se calcula de forma dinámica según 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 sus campos |
dataSourceTable
|
Una tabla de fuente de datos anclada en esta celda. El tamaño de la tabla de la fuente de datos se calcula de forma dinámica según 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 la fuente de datos en sus campos |
dataSourceFormula
|
Solo salida. Información sobre una fórmula de fuente de datos en la celda. El campo se establece si |
Formato de celda
El formato de una celda.
Representación JSON |
---|
{ "numberFormat": { object ( |
Campos | |
---|---|
numberFormat
|
Formato que describe cómo se deben representar los valores numéricos para el usuario. |
backgroundColor
|
El color de fondo de la celda Obsoleto: Usa |
backgroundColorStyle
|
El color de fondo de la celda Si también se configura |
borders
|
Los bordes de la celda |
padding
|
Relleno de la celda. |
horizontalAlignment
|
Alineación horizontal del valor en la celda. |
verticalAlignment
|
Alineación vertical del valor de la celda. |
wrapStrategy
|
La estrategia de unión para el valor de la celda. |
textDirection
|
Es la dirección del texto en la celda. |
textFormat
|
Indica el formato del texto en la celda (a menos que lo anule una ejecución de formato). Si estableces un vínculo a nivel de la celda aquí, se borrarán los vínculos existentes. La configuración del campo de vínculo en |
hyperlinkDisplayType
|
Si existe uno, indica cómo se debe mostrar un hipervínculo en la celda. |
textRotation
|
La rotación se aplicó al texto de la celda. |
NumberFormat
El formato numérico de una celda
Representación JSON |
---|
{
"type": enum (
|
Campos | |
---|---|
type
|
Es el tipo de formato de número. Cuando se escribe, se debe configurar este campo. |
pattern
|
String de patrón que se usa para el formato. Si no se establece, se usará un patrón predeterminado basado en la configuración regional del usuario si es necesario para el tipo determinado. Consulta la guía de formatos de fecha y número para obtener más información sobre los patrones admitidos. |
Tipo de número de formato
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.
Enumeradores | |
---|---|
NUMBER_FORMAT_TYPE_UNSPECIFIED
|
El formato de número no se especifica y se basa en el contenido de la celda. No lo uses de forma explícita. |
TEXT
|
Formato de texto, p. ej., 1000.12
|
NUMBER
|
Formato de números, p. ej., 1,000.12
|
PERCENT
|
Formato porcentual, p. ej.
10.12%
|
CURRENCY
|
Formato de moneda, p. ej., $1,000.12
|
DATE
|
Formato de fecha, por ejemplo, 9/26/2008
|
TIME
|
Formato de fecha y hora, p. ej., 3:59:00 PM
|
DATE_TIME
|
Formato de fecha y hora (p. ej., 9/26/08 15:59:00 )
|
SCIENTIFIC
|
Formato de número científico, p. ej., 1.01E+03
|
Bordes
Los bordes de la celda
Representación JSON |
---|
{ "top": { object ( |
Campos | |
---|---|
top
|
El borde superior de la celda |
bottom
|
El borde inferior de la celda. |
left
|
Es el borde izquierdo de la celda. |
right
|
El borde derecho de la celda. |
Border
Un borde a lo largo de una celda
Representación JSON |
---|
{ "style": enum ( |
Campos | |
---|---|
style
|
El estilo del borde |
width
|
Es el ancho del borde, en píxeles. Este campo es obsoleto; el ancho se determina mediante el campo "style". |
color
|
El color del borde. Obsoleto: Usa |
colorStyle
|
El color del borde. Si también se configura |
Estilo
El estilo de un borde
Enumeradores | |
---|---|
STYLE_UNSPECIFIED
|
No se especificó el estilo. No lo uses. |
DOTTED
|
El borde está punteado. |
DASHED
|
El borde está discontinuo. |
SOLID
|
El borde es una línea sólida delgada. |
SOLID_MEDIUM
|
El borde es una línea sólida media. |
SOLID_THICK
|
El borde es una línea sólida gruesa. |
NONE
|
Sin borde. Solo se usa para actualizar un borde a fin de borrarlo. |
DOUBLE
|
El borde tiene dos líneas continuas. |
Padding
La cantidad de padding alrededor de la celda, en píxeles. Cuando se actualiza el padding, se debe especificar cada campo.
Representación JSON |
---|
{ "top": integer, "right": integer, "bottom": integer, "left": integer } |
Campos | |
---|---|
top
|
Relleno superior de la celda. |
right
|
Relleno derecho de la celda. |
bottom
|
Relleno inferior de la celda. |
left
|
Relleno izquierdo de la celda. |
Alineación vertical
Alineación vertical de texto en una celda.
Enumeradores | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
La alineación vertical no se especifica. No lo uses. |
TOP
|
El texto se alinea de manera explícita con la parte superior de la celda. |
MIDDLE
|
El texto se alinea de manera explícita en el medio de la celda. |
BOTTOM
|
El texto se alinea de manera explícita con la parte inferior de la celda. |
Estrategia Wrap
Cómo ajustar texto en una celda
Enumeradores | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
El valor predeterminado, no usar. |
OVERFLOW_CELL
|
Las líneas que superen el ancho se escribirán en la siguiente celda, siempre y cuando la celda esté vacía. Si la siguiente celda no está vacía, se comporta de la misma manera que
|
LEGACY_WRAP
|
Esta estrategia de unión representa la estrategia 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 cortarse. Esta estrategia no es compatible con todas las plataformas y se está dejando de usar. Ejemplo:
|
CLIP
|
Se recortarán las líneas que superen el ancho de la celda. El texto nunca se ajustará a la siguiente línea, a menos que el usuario inserte una línea nueva de forma manual. Ejemplo:
|
WRAP
|
Las palabras que son más largas que una línea se unen al nivel de los caracteres en lugar de recortarse. Ejemplo:
|
Dirección del texto
Es la dirección del texto en una celda.
Enumeradores | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
No se especificó la dirección del texto. No lo 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. |
Tipo de pantalla de hipervínculo
Indica si se debe renderizar un hipervínculo de forma explícita. Si no se especifica, se vincula el hipervínculo.
Enumeradores | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
El valor predeterminado: se renderiza el hipervínculo. No lo uses. |
LINKED
|
Los hipervínculos deben renderizarse de manera explícita. |
PLAIN_TEXT
|
No se debe renderizar un hipervínculo. |
Rotación de texto
Es la rotación que se aplica al texto de una celda.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión type . Es el tipo de rotación, vertical o en ángulo.
type puede ser solo una de las siguientes opciones:
|
|
angle
|
El ángulo entre la orientación estándar y la deseada. Se mide en grados. Los valores válidos deben estar comprendidos entre -90 y 90. Los ángulos positivos son en ángulo hacia arriba, los negativos en ángulo descendente. Nota: En el caso de la dirección del texto de izquierda a derecha, los ángulos positivos se encuentran en el sentido antihorario, mientras que, en el caso de la derecha a izquierda, lo hacen en el sentido de las manecillas del reloj. |
vertical
|
Si es verdadero, el texto se leerá de arriba hacia abajo, pero la orientación de los caracteres individuales no se modificará. Por ejemplo:
|
Formato de ejecución de texto
Es una ejecución de un formato de texto. El formato de esta ejecución continúa hasta el índice de inicio de la siguiente ejecución. Cuando se realiza 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 ausentes heredan el formato de la celda. |
Regla de validación de datos
Una regla de validación de datos
Representación JSON |
---|
{
"condition": {
object (
|
Campos | |
---|---|
condition
|
La condición con la que deben coincidir los datos de la celda. |
inputMessage
|
Un mensaje para mostrar al usuario cuando se agregan datos a la celda. |
strict
|
Verdadero si se deben rechazar los datos no válidos. |
showCustomUi
|
Verdadero si la IU se debe personalizar según el tipo de condición. Si es verdadero, las condiciones de "Lista" mostrarán un menú desplegable. |
Tabla de fuentes
Una tabla de fuente de datos, que permite al usuario importar una tabla de datos estática de 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
|
El ID de la fuente de datos con la que está asociada la tabla de fuente de datos. |
columnSelectionType
|
El tipo para seleccionar 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[]
|
Filtrar especificaciones en la tabla de fuente de datos. |
sortSpecs[]
|
Ordena especificaciones en la tabla de fuente de datos. El resultado de la tabla de la fuente de datos se ordena según las especificaciones de orden. |
rowLimit
|
El límite de filas que se mostrarán. Si no estableces la política, se aplicará un límite predeterminado. Consulte el editor de Hojas de cálculo para conocer los límites predeterminados y máximos. |
dataExecutionStatus
|
Solo salida. El estado de ejecución de los datos. |
DataSourceTableColumnSelectionType.
Los tipos de selección de columna de la tabla de fuentes de datos
Enumeradores | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED
|
El tipo de selección de columna predeterminado, no usar. |
SELECTED
|
Selecciona las columnas que especifica el campo columns .
|
SYNC_ALL
|
Sincroniza todas las columnas actuales y futuras de la fuente de datos. Si se configura, la tabla de la fuente de datos recupera todas las columnas de la fuente de datos en el momento de la actualización. |
Fórmula de DataSource
Una fórmula de 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. El estado de ejecución de los datos. |