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:

  • 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