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

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