En esta sección, se presenta un codelab que puedes usar para familiarizarte con la API de Google Sheets. También se proporciona un conjunto de ejemplos de "recetas" que muestran cómo traducir una acción prevista de Google Sheets en una solicitud a la API.
A menudo, hay más de una forma de completar una tarea determinada con la API. Cuando decidas cómo abordar una tarea, ten en cuenta lo siguiente:
- Si necesitas leer o escribir valores de celdas, la
spreadsheets.valuescolección es una mejor opción que laspreadsheetscolección. La interfaz de la primera es más fácil de usar para operaciones simples de lectura y escritura. Siempre que sea posible, usa los métodos por lotes (
spreadsheet.batchUpdate,spreadsheet.values.batchGet, yspreadsheet.values.batchUpdate) para agrupar varias solicitudes en una sola llamada al método. El uso de estos métodos por lotes mejora la eficiencia, ya que:- Reduce la sobrecarga de HTTP del cliente.
- Reduce la cantidad de consultas realizadas.
- Reduce la cantidad de revisiones en el documento.
- Garantiza la atomicidad de todos los cambios en el lote.
Recetas
En los ejemplos que se enumeran en esta sección, se muestra cómo expresar acciones comunes en Hojas de cálculo como solicitudes a la API de Hojas de cálculo v4.
Estos ejemplos se presentan en forma de solicitudes HTTP para que sean independientes del lenguaje. Para obtener información sobre cómo implementar protocolos de solicitud a la API de Hojas de cálculo en un lenguaje específico con las bibliotecas cliente de las APIs de Google, consulta las guías Leer y escribir valores de celdas y Actualizar hojas de cálculo.
Las recetas de esta sección se dividen en las siguientes categorías:
- Lectura básica: Recetas que muestran cómo leer valores de una hoja de cálculo.
- Escritura básica: Recetas que muestran cómo escribir valores en una hoja de cálculo.
- Formato básico: Recetas que muestran cómo cambiar la apariencia de las hojas de cálculo y las celdas.
- Gráficos: Recetas que muestran cómo crear y modificar gráficos en una hoja de cálculo.
- Formato condicional: Recetas que muestran cómo modificar la apariencia de las celdas según las condiciones.
- Operaciones de datos: Recetas que muestran cómo crear, mover y manipular datos en una hoja de cálculo.
- Rangos con nombre y protegidos —Recetas que muestran cómo crear, actualizar y quitar rangos con nombre y protegidos en una hoja de cálculo.
- Tablas dinámicas: Recetas que muestran cómo crear tablas dinámicas en una hoja de cálculo.
- Operaciones de filas y columnas: Recetas que muestran cómo agregar, quitar y mover filas y columnas, y actualizar sus propiedades.
- Operaciones de hojas de cálculo: Recetas que muestran cómo crear, borrar, copiar y eliminar hojas de cálculo, y también controlar sus propiedades.