La API de Hojas de cálculo de Google es una interfaz RESTful que te permite leer y modificar un archivo datos de una hoja de cálculo. Los usos más comunes de esta API incluyen los siguientes: tareas:
- Crear hojas de cálculo
- Leer y escribir valores de celdas en una hoja de cálculo
- Actualizar el formato de la hoja de cálculo
- Administrar Hojas conectadas
A continuación, se muestra una lista de términos comunes usados en la API de Hojas de cálculo:
- Hoja de cálculo
El objeto principal de Hojas de cálculo de Google que puede contener varias hojas, cada una con información estructurada contenida en celdas. R El recurso de hoja de cálculo representa todas las hojas de cálculo y tiene una valor único de
spreadsheetId
, que contenga letras, números, guiones o guiones bajos. Puedes encontrar el ID de 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 dentro de una hoja de cálculo. R Sheet resource representa cada hoja y tiene un título único y valores Es un valor de
sheetId
. Tú 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
Es 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. R El recurso CellData representa cada celda, pero no tiene un valor de ID único. En cambio, la fila y las coordenadas de columnas identifican las celdas.
- Notación A1
Sintaxis que se usa para definir una celda o rango de celdas con una cadena que contiene el nombre de la hoja y las coordenadas inicial y final de la celda mediante letras de columnas y números de filas. 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 la Hoja1.Sheet1!A:A
hace referencia a todas las celdas de la primera columna de la Hoja1.Sheet1!1:2
hace referencia a todas las celdas de las dos primeras filas de la 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
hace referencia a todas las celdas de la primera columna de una hoja llamada "Mi hoja personalizada". Las comillas simples son necesarias para los nombres de las 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 dentro 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 llamada A1. Del mismo modo, Hoja1 hace referencia a todas las celdas de la Hoja1. Sin embargo, si hay un rango con nombre titulado "Hoja1", Hoja1 hace referencia al rango con nombre y "Hoja1" se refiere a la hoja.
- Notación R1C1
Sintaxis que se usa para definir una celda o rango de celdas con una cadena que contiene el nombre de la hoja y las coordenadas inicial y final de la celda mediante números de fila y números de columna. Este método es menos común que la notación A1, pero se puede es útil cuando se hace referencia a un rango de celdas en relación con el rango de una celda determinada posición.
Mostrar ejemplos
Sheet1!R1C1:R2C2
se refiere a las dos primeras celdas en las dos filas superiores de la 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 se encuentra 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 referencias a lo largo de una aplicación. R El recurso FilterView representa un rango con nombre.
- Rango protegido
Celda o rango de celdas definido que no se puede modificar. R El recurso ProtectedRange representa un rango protegido.
Próximos pasos
Para aprender sobre el desarrollo con APIs de Google Workspace, incluido el manejo autenticación y autorización, consulta Desarrolla en Google Workspace.
Para aprender a configurar y ejecutar una aplicación simple de la API de Sheets, lee el Descripción general de las guías de inicio rápido.