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 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

La siguiente es una lista de términos comunes usados en esta API:

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. Un Spreadsheet resource representa cada de la hoja de cálculo y tiene un formato valor spreadsheetId, que contenga letras, números, guiones o guiones bajos. Puedes encontrar la 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. Un Sheet resource representa cada y tiene un título único y valores numéricos Valor 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. Un CellData resource representa cada pero no tiene un valor de ID único. En cambio, las filas y columnas coordenadas 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 inicial y final 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 todas las celdas de las dos primeras filas y columnas 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 todas las celdas de las dos primeras filas y columnas de la primera hoja visible.
  • Sheet1 hace referencia a todas las celdas de la Hoja1.
  • 'Jon's_Data'!A1:D5 se refiere a todas las celdas de las primeras cinco filas y cuatro columnas de una hoja llamada "Jon's_Data".
  • 'My Custom Sheet'!A:A hace referencia a todas las celdas de la primera columna de una hoja llamada "Mi hoja personalizada".
  • 'My Custom Sheet' hace referencia a todas las celdas de "Mi hoja personalizada".

Las comillas simples son necesarias para los nombres de las hojas con espacios, caracteres especiales o una combinación alfanumérica.

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 llamada "A1". De manera similar, Sheet1 hace referencia a todas las celdas de la Hoja1. Sin embargo, si hay un rango con nombre llamado "Sheet1", entonces Sheet1 se refiere al rango con nombre y Sheet1 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 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 puede ser útil al hacer referencia a un rango de celdas en relación con un determinado la posición de la celda.

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. Un FilterView recurso representa un rango con nombre.
Rango protegido
Celda o rango de celdas definido que no se puede modificar. R ProtectedRange recurso representa un rango protegido.