Ejemplos

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 demuestran cómo traducir una acción prevista de Hojas de cálculo de Google 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 colección spreadsheets.values es una mejor opción que la colección spreadsheets. 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 y spreadsheet.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 HTTP del cliente.
    • Reduce la cantidad de búsquedas 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 de la API de Hojas de cálculo v4.

Estos ejemplos se presentan en forma de solicitudes HTTP para que sean independientes del idioma. Para obtener información sobre cómo implementar protocolos de solicitud de la API de Sheets en un lenguaje específico con las bibliotecas cliente de las APIs de Google, consulta las guías Cómo leer y escribir valores de celdas y Cómo 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.
  • Escritura básica: Recetas que muestran cómo escribir valores en una hoja.
  • Formato básico: Recetas que muestran cómo cambiar la apariencia de las hojas y las celdas
  • Gráficos: Recetas que muestran cómo crear y modificar gráficos en una hoja.
  • Formato condicional: Recetas que muestran cómo alterar la apariencia de las celdas según las condiciones.
  • Operaciones con 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.
  • Operaciones con filas y columnas: Recetas que muestran cómo agregar, quitar y mover filas y columnas, y actualizar sus propiedades.
  • Operaciones de hojas: Recetas que muestran cómo crear, borrar, copiar y eliminar hojas, y también cómo controlar sus propiedades.