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:
- Crear hojas de cálculo
- Lee y escribe valores de celda de hoja de cálculo
- Actualizar el formato de la 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
Objeto principal de Hojas de cálculo de Google que puede contener varias hojas, cada una con información estructurada de celdas. Un recurso de hoja de cálculo representa a cada hoja 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 una pestaña dentro de una hoja de cálculo Un recurso de hoja representa cada hoja y tiene un título y un valor numérico
sheetId
únicos. 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 se organizan en filas y columnas, y se pueden agrupar como un rango de celdas. Un recurso 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
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 iniciales y finales de la celda mediante letras y números de fila. Este método es el más común y útil cuando se hace referencia a un rango de celdas absoluto.
Mostrar ejemplos
Sheet1!A1:B2
se refiere a las primeras dos celdas en las dos primeras filas de Sheet1.Sheet1!A:A
hace referencia a todas las celdas de la primera columna de Sheet1.Sheet1!1:2
hace referencia a todas las celdas en las primeras dos filas de Sheet1.Sheet1!A5:A
hace referencia a todas las celdas de la primera columna de la Hoja 1, desde la fila 5 en adelante.A1:B2
hace referencia a las primeras dos celdas en las primeras dos filas de la primera hoja visible.Sheet1
hace referencia a todas las celdas de Sheet1.'My Custom Sheet'!A:A
hace referencia a todas las celdas de la primera columna de una hoja denominada "Mi hoja personalizada". Se requieren comillas simples para los nombres de hoja 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" hace referencia a la celda A1 de 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 Hoja1. Sin embargo, si existe un rango con el nombre "Hoja1", entonces "Hoja1" hace referencia al rango con nombre y "Hoja1" hace referencia a la hoja.
- Notación R1C1
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 celda de inicio y finalización mediante números de filas y números de columnas. 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 relacionado con la posición de una celda determinada.
Mostrar ejemplos
Sheet1!R1C1:R2C2
se refiere a las primeras dos celdas en las dos primeras filas de Sheet1.R1C1:R2C2
hace referencia a las primeras dos celdas en las primeras dos filas de la primera hoja visible.Sheet1!R[3]C[1]
hace referencia a la celda que está tres filas debajo y una columna a la derecha de la celda actual.
- Rango con nombre
Una celda o un 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
Una celda o un rango de celdas definido que no se puede modificar. Un recurso ProtectedRange representa un rango protegido.
Próximos pasos
Para obtener información sobre el desarrollo con las API de Google Workspace, incluido el manejo de la autenticación y la autorización, consulta Desarrolla en Google Workspace.
Para obtener información sobre cómo configurar y ejecutar una app simple de la API de Hojas de cálculo, lee la Descripción general de las guías de inicio rápido.