Descripción general de la API de Hojas de cálculo de Google (original) (raw)

Descripción general de la API de Hojas de cálculo de Google

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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. La API de Hojas de cálculo te permite hacer lo siguiente:

• Crear hojas de cálculo
• Lee y escribe valores de celdas de una hoja de cálculo
• Actualiza el formato de la hoja de cálculo
• Administra Hojas conectadas

A continuación, se muestra una lista de términos comunes que se usan en la API de Hojas de cálculo:

Spreadsheet

Es el objeto principal de Hojas de cálculo de Google. Puede contener varios Sheets, cada uno con información estructurada en Cells. El recurso spreadsheets representa una hoja de cálculo. Contiene un valor spreadsheetId único.

ID de la hoja de cálculo

Es el identificador único de una hoja de cálculo. Es una cadena particular que contiene letras, números y algunos caracteres especiales que hacen referencia a una hoja de cálculo y se puede obtener de la URL de la hoja de cálculo. Los IDs de las hojas de cálculo son estables, incluso si cambia el nombre de la hoja.

https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID

Hojas de cálculo

Es una página o pestaña dentro de una hoja de cálculo. El recurso Sheets representa una hoja. Contiene un valor sheetId numérico único y una hoja title como parte del objeto SheetProperties.

ID de la hoja

Es el identificador único de una hoja específica dentro de una hoja de cálculo. Es un número entero particular que contiene números que hacen referencia a una hoja y se puede obtener de la URL de la hoja de cálculo. Los IDs de hoja son estables, incluso si cambia el nombre de la hoja. Para ver un ejemplo, consulta ID de hoja de cálculo.

Cell

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. El recurso Cells representa cada celda, pero no tiene un valor de ID único. En su lugar, las coordenadas de fila y columna 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, además de las coordenadas de la celda inicial y final con 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 hace referencia 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 hace referencia a todas las celdas de la primera columna de la Hoja 1, a partir de la fila 5.
• A1:B2 se refiere 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 hace referencia 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 obligatorias para los nombres de las hojas con espacios o caracteres especiales.

Sugerencia: Siempre que sea posible, usa nombres distintos para los objetos de tus hojas de cálculo. Por ejemplo, A1 (sin comillas) hace referencia a la celda A1 en la primera hoja visible. 'A1' hace referencia a una hoja con el nombre A1. De manera similar, Hoja1 hace referencia a una hoja con el nombre Hoja1. Sin embargo, si hay un rango con nombre titulado “Hoja1”, Hoja1 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, además de las coordenadas de celda inicial y final con números de fila y columna. 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 en relación con la posición de una celda determinada.

Mostrar ejemplos

• Sheet1!R1C1:R2C2 hace referencia a las dos primeras celdas de las dos filas superiores de la Hoja1.
• R1C1:R2C2 se refiere a las dos primeras celdas de las dos filas superiores 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

Es una celda o un rango de celdas definido con un nombre personalizado para simplificar las referencias en una aplicación. Un recurso FilterView representa un rango con nombre.

Rango protegido

Es una celda o un rango de celdas definidos que no se pueden modificar. Un recurso ProtectedRange representa un rango protegido.

• Para obtener información sobre el desarrollo con las APIs de Google Workspace, incluida la administración de la autenticación y la autorización, consulta Desarrollo en Google Workspace.
• Para aprender a configurar y ejecutar una app de la API de Hojas de cálculo, consulta laguía de inicio rápido de JavaScript.

Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.

Última actualización: 2025-05-08 (UTC)