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
|
Es el valor efectivo de la celda. En el caso de 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 muestra al usuario. Este campo es de solo lectura. |
userEnteredFormat
|
Es el formato que el usuario ingresó para la celda. Cuando escribas, el formato nuevo se combinará con el existente. |
effectiveFormat
|
Es el formato efectivo que usa la celda. Esto incluye los resultados de la aplicación de 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á el formato efectivo. 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 configurarlo, usa una fórmula |
note
|
Cualquier nota en la celda |
textFormatRuns[]
|
Ejecuciones de texto enriquecido aplicadas a subsecciones de la celda. Las ejecuciones solo son válidas en cadenas ingresadas por el usuario, no en fórmulas, números ni valores booleanos. Las propiedades de una ejecución comienzan en un índice específico del texto y continúan hasta la siguiente ejecución. Las ejecuciones heredarán las propiedades de la celda, a menos que se cambien de forma explícita.
Cuando escribas, las ejecuciones nuevas reemplazarán las anteriores. Cuando se escribe un |
dataValidation
|
Una regla de validación de datos en la celda, si la hay 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 en sí se calcula de forma dinámica en función de sus datos, agrupación, filtros, valores, etcétera. Solo la celda superior izquierda de la tabla dinámica contiene la definición de la tabla dinámica. Las otras celdas contendrán los valores calculados de los resultados del filtro 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 fuente de datos contiene la definición de la tabla de 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 |
chipRuns[]
|
Opcional. Ejecuciones de chips aplicados a subsecciones de la celda. Las propiedades de una ejecución comienzan en un índice específico del texto y continúan hasta la siguiente ejecución.
Cuando se realiza la lectura, se incluyen todas las ejecuciones con y sin chips. Las ejecuciones sin chips tendrán un
Cuando se escribe, solo se incluyen las ejecuciones con chips. Las ejecuciones que contienen chips tienen una longitud de 1 y se representan en el texto que ingresa el usuario con un símbolo de marcador de posición “@”. Las ejecuciones nuevas reemplazarán las anteriores. Si escribes un |
CellFormat
Es el formato de una celda.
Representación JSON |
---|
{ "numberFormat": { object ( |
Campos | |
---|---|
numberFormat
|
Es un formato que describe cómo se deben representar los valores numéricos al usuario. |
backgroundColor
|
Es el color de fondo de la celda. Obsoleto: Usa |
backgroundColorStyle
|
Es el color de fondo de la celda. Si también se establece |
borders
|
Los bordes de la celda. |
padding
|
Es el padding de la celda. |
horizontalAlignment
|
Es la alineación horizontal del valor en la celda. |
verticalAlignment
|
Es la alineación vertical del valor en la celda. |
wrapStrategy
|
Es la estrategia de unión para el valor de la celda. |
textDirection
|
Es la dirección del texto en la celda. |
textFormat
|
Es el formato del texto en la celda (a menos que se anule con una ejecución de formato). Si estableces un vínculo a nivel de la celda aquí, se borrarán los vínculos existentes de la celda. Establecer el campo de vínculo en un |
hyperlinkDisplayType
|
Si existe, cómo se debe mostrar un hipervínculo en la celda. |
textRotation
|
Es la rotación aplicada 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. Cuando se escribe, se debe configurar este campo. |
pattern
|
Es la cadena 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. |
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 de forma explícita. |
TEXT
|
Formato de texto, p. ej., 1000.12
|
NUMBER
|
Formato de número, 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 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
|
Es el borde superior de la celda. |
bottom
|
Es el borde inferior de la celda. |
left
|
Es el borde izquierdo de la celda. |
right
|
Es el borde derecho de la celda. |
Borde
Es un borde a lo largo de una celda.
Representación JSON |
---|
{ "style": enum ( |
Campos | |
---|---|
style
|
Es el estilo del borde. |
width
|
Es el ancho del borde, en píxeles. Obsoleto. El ancho se determina según el campo "style". |
color
|
Es el color del borde. Obsoleto: Usa |
colorStyle
|
Es el color del borde. Si también se establece |
Estilo
Es el estilo de un borde.
Enumeraciones | |
---|---|
STYLE_UNSPECIFIED
|
No se especifica el estilo. No uses esta opción. |
DOTTED
|
El borde está punteado. |
DASHED
|
El borde tiene una línea discontinua. |
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 usa solo cuando se actualiza un borde para borrarlo. |
DOUBLE
|
El borde tiene dos líneas sólidas. |
Padding
Es 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
|
Es el padding superior de la celda. |
right
|
Es el padding derecho de la celda. |
bottom
|
Es el padding inferior de la celda. |
left
|
Es el padding izquierdo de la celda. |
VerticalAlign
Es la alineación vertical del texto en una celda.
Enumeraciones | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
No se especifica la alineación vertical. No uses esta opción. |
TOP
|
El texto se alinea explícitamente en la parte superior de la celda. |
MIDDLE
|
El texto se alinea explícitamente en el medio de la celda. |
BOTTOM
|
El texto se alinea explícitamente en la parte inferior de la celda. |
WrapStrategy
Cómo ajustar el texto de una celda
Enumeraciones | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
Es el valor predeterminado; no se debe 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 esta 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 antigua estrategia de unión de Hojas de cálculo de Google, en la que las palabras más largas que una línea se cortan en lugar de dividirse. Esta estrategia no es compatible con todas las plataformas y se eliminará gradualmente. Ejemplo:
|
CLIP
|
Se recortarán las líneas que sean más largas que el ancho de la celda. El texto nunca se unirá 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 a nivel de los caracteres en lugar de cortarse. Ejemplo:
|
TextDirection
Es la dirección del texto en una celda.
Enumeraciones | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
No se especificó la dirección del texto. No uses esta opción. |
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 un hipervínculo de forma explícita. Si no se especifica, el hipervínculo se vincula.
Enumeraciones | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
El valor predeterminado: se renderiza el hipervínculo. No uses esta opción. |
LINKED
|
Se debe renderizar un hipervínculo de forma explícita. |
PLAIN_TEXT
|
No se debe renderizar un hipervínculo. |
TextRotation
Es la rotación aplicada 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 solo puede ser uno de los siguientes:
|
|
angle
|
Es el ángulo entre la orientación estándar y la orientación deseada. Se mide en grados. Los valores válidos están entre -90 y 90. Los ángulos positivos se inclinan hacia arriba y los negativos hacia abajo. Nota: Para la dirección de texto LTR, los ángulos positivos se encuentran en el sentido contrario a las manecillas del reloj, mientras que para la dirección RTL, se encuentran 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
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
|
Es 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. |
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 para mostrarle al usuario cuando agrega datos a la celda. |
strict
|
Es verdadero si se deben rechazar los datos no válidos. |
showCustomUi
|
Es verdadero si la IU se debe personalizar según el tipo de condición. Si es verdadero, las condiciones "List" mostrarán un menú desplegable. |
DataSourceTable
Es una tabla de fuente de datos que permite al usuario importar una tabla estática de datos 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
|
Es el ID de la fuente de datos con la que está asociada la tabla de fuentes de datos. |
columnSelectionType
|
Es el tipo para seleccionar columnas para la tabla de la fuente de datos. La configuración predeterminada es |
columns[]
|
Columnas seleccionadas para la tabla de la fuente de datos. El |
filterSpecs[]
|
Especificaciones del filtro en la tabla de la fuente de datos |
sortSpecs[]
|
Especificaciones de orden en la tabla de la fuente de datos El resultado de la tabla de la fuente de datos se ordena según las especificaciones de orden. |
rowLimit
|
Es el límite de filas que se mostrarán. Si no se establece, se aplica un límite predeterminado. Consulta el editor de Hojas de cálculo para conocer el límite predeterminado y máximo. |
dataExecutionStatus
|
Solo salida. Es el estado de ejecución de los datos. |
DataSourceTableColumnSelectionType
Son los tipos de selección de columnas de la tabla de la fuente de datos.
Enumeraciones | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED
|
Es el tipo de selección de columna predeterminado. No lo uses. |
SELECTED
|
Selecciona las columnas especificadas por el campo columns .
|
SYNC_ALL
|
Sincroniza todas las columnas actuales y futuras de la fuente de datos. Si se establece, la tabla de la fuente de datos recupera todas las columnas de la fuente de datos en el momento de la actualización. |
DataSourceFormula
Una fórmula de fuente de datos.
Representación JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object ( |
Campos | |
---|---|
dataSourceId
|
Es 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. |
ChipRun
La ejecución de un chip. El chip continúa hasta el índice de inicio de la siguiente ejecución.
Representación JSON |
---|
{
"startIndex": integer,
"chip": {
object ( |
Campos | |
---|---|
startIndex
|
Obligatorio. Es el índice de caracteres basado en cero donde comienza esta ejecución, en unidades de código UTF-16. |
chip
|
Opcional. El chip de esta ejecución |
Chip
El chip inteligente
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión properties . Las propiedades del chip
properties solo puede ser uno de los siguientes:
|
|
personProperties
|
Son las propiedades de una persona vinculada. |
richLinkProperties
|
Propiedades de un vínculo enriquecido |
PersonProperties
Son propiedades específicas de una persona vinculada.
Representación JSON |
---|
{
"email": string,
"displayFormat": enum ( |
Campos | |
---|---|
email
|
Obligatorio. La dirección de correo electrónico vinculada a esta persona. Este campo siempre está presente. |
displayFormat
|
Opcional. Es el formato de visualización del chip de persona. Si no se establece, se usa el formato de visualización predeterminado. |
DisplayFormat
Formato de visualización preferido cuando esté disponible.
Enumeraciones | |
---|---|
DISPLAY_FORMAT_UNSPECIFIED
|
Es un valor predeterminado que no se debe usar. |
DEFAULT
|
Es el formato de visualización predeterminado. |
LAST_NAME_COMMA_FIRST_NAME
|
Formato de visualización del apellido y el nombre |
EMAIL
|
Formato de visualización del correo electrónico. |
RichLinkProperties
Son las propiedades de un vínculo a un recurso de Google (como un archivo en Drive, un video de YouTube, una dirección de Maps o un evento de Calendario). Solo los archivos de Drive se pueden escribir como chips. Todos los demás tipos de vínculos enriquecidos son de solo lectura.
Los URIs no pueden superar los 2,000 bytes cuando se escriben.
NOTA: Para escribir chips de archivos de Drive, se requiere al menos uno de los permisos de OAuth drive.file
, drive.readonly
o drive
.
Representación JSON |
---|
{ "uri": string, "mimeType": string } |
Campos | |
---|---|
uri
|
Obligatorio. Es el URI del vínculo. Siempre está presente. |
mimeType
|
Solo salida. El tipo MIME del vínculo, si hay uno (por ejemplo, cuando es un archivo en Drive) |