Descripción general de la API de Hojas de cálculo de Google

La API de Hojas de cálculo de Google es una interfaz RESTful que te permite leer y modificar los datos de una hoja de cálculo. Los usos más comunes de esta API incluyen las siguientes tareas:

  • Crea hojas de cálculo
  • Leer y escribir valores de celdas de hojas de cálculo
  • Actualizar formato de hoja de cálculo
  • Administrar Hojas conectadas

A continuación, se muestra una lista de los términos comunes que se usan en la API de Hojas de cálculo:

Hoja de cálculo

Es el objeto principal de Hojas de cálculo de Google que puede contener varias hojas, cada una con información estructurada en las celdas. Un recurso de hoja de cálculo representa todas las hojas de cálculo y tiene un valor spreadsheetId único, que contiene letras, números, guiones o guiones bajos. Puedes encontrar el ID de la hoja de cálculo en una URL de Hojas de cálculo de Google:

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

Hoja

Una página o pestaña en una hoja de cálculo. Un recurso de hoja representa cada hoja y tiene un título único y un valor numérico sheetId. Puedes encontrar el ID de la hoja en una URL de Hojas de cálculo de Google:

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

Celda

Un campo individual de texto o datos dentro de una hoja. Las celdas están organizadas en filas y columnas, y se pueden agrupar como un rango de celdas. Un recurso de CellData representa cada celda, pero no tiene un valor de ID único. En cambio, las coordenadas de fila y columna identifican las celdas.

Notación A1

Es una sintaxis que se usa para definir una celda o un rango de celdas con una cadena que contiene el nombre de la hoja y las coordenadas de inicio y finalización de la celda mediante letras de columna y números de fila. Este método es el más común y útil cuando se hace referencia a un rango absoluto de celdas.

Mostrar ejemplos

  • Sheet1!A1:B2 se refiere a las dos primeras celdas en las dos filas superiores de Hoja1.
  • Sheet1!A:A se refiere a todas las celdas de la primera columna de Hoja1.
  • Sheet1!1:2 se refiere a todas las celdas en las dos primeras filas de Hoja1.
  • Sheet1!A5:A se refiere a todas las celdas de la primera columna de la Hoja 1, a partir de la fila 5.
  • A1:B2 hace referencia a las dos primeras celdas en las dos filas superiores de la primera hoja visible.
  • Sheet1 hace referencia a todas las celdas de la Hoja1.
  • 'My Custom Sheet'!A:A se refiere a todas las celdas de la primera columna de una hoja denominada "Mi hoja personalizada". Se requieren comillas simples para los nombres de hojas con espacios, caracteres especiales o una combinación alfanumérica.
  • 'My Custom Sheet' hace referencia a todas las celdas de “Mi hoja personalizada”.

Sugerencia: Siempre que sea posible, usa nombres distintos para los objetos de tus hojas de cálculo. Por ejemplo, A1 se refiere a la celda A1 en la primera hoja visible, mientras que "A1" se refiere a todas las celdas de una hoja denominada A1. Del mismo modo, Hoja1 se refiere a todas las celdas de la Hoja1. Sin embargo, si hay un rango con nombre titulado “Hoja1”, entonces Hoja1 se refiere al rango con nombre y “Hoja1” se refiere a la hoja.

Notación R1C1

Es una sintaxis que se usa para definir una celda o un rango de celdas con una string que contiene el nombre de la hoja y las coordenadas de inicio y finalización de la celda mediante los números de fila y de columna. Este método es menos común que la notación A1, pero puede ser útil cuando se hace referencia a un rango de celdas en relación con la posición de una celda determinada.

Mostrar ejemplos

  • Sheet1!R1C1:R2C2 se refiere a las dos primeras celdas en las dos filas superiores de Hoja1.
  • R1C1:R2C2 hace referencia a las dos primeras celdas en las dos filas superiores de la primera hoja visible.
  • Sheet1!R[3]C[1] se refiere a la celda que está tres filas debajo y una columna a la derecha de la celda actual.
Rango con nombre

Celda o rango de celdas definido con un nombre personalizado para simplificar las referencias en toda la aplicación. Un recurso FilterView representa un rango con nombre.

Rango protegido

Celda o rango de celdas definido que no se puede modificar. Un recurso ProtectedRange representa un rango protegido.

Próximos pasos