Preparar la hoja de cálculo

Qué hacer en Google Sheets antes de conectar: crear una hoja de cálculo, compartirla y copiar su enlace

No necesitas crear un proyecto de Google Cloud, activar una API ni descargar una clave JSON — la cuenta de servicio ya está configurada por parte del servicio. Lo único que necesitas aportar es la propia hoja de cálculo, el acceso a ella y su enlace.

Paso 1. Crea una hoja de cálculo

Abre Google Sheets y crea una hoja de cálculo nueva — o usa una con la que ya trabajes. El nombre de la hoja de cálculo puede ser cualquiera, el servicio no lo comprueba.

Paso 2. Copia la dirección de la cuenta de servicio

La dirección se muestra en tu cuenta — es la cuenta con la que compartirás la hoja de cálculo.

  1. Abre Conexión API — el elemento "Conexión API" del menú de usuario (esquina superior derecha de tu cuenta).
  2. Busca la tarjeta "Google Sheets".
  3. En la fila "Cuenta de servicio", haz clic en el icono de copiar junto a la dirección — aparece la notificación "Correo copiado".
Captura de pantallaLa tarjeta "Google Sheets" de la página "Conexión API" en el estado "No conectado": la fila "Cuenta de servicio" con la dirección y un botón de copiar, la fila "Hoja de cálculo" con el valor "No conectado", y el botón "Conectar" en el encabezado de la tarjeta.

Paso 3. Comparte la hoja de cálculo con el rol "Editor"

  1. Abre tu hoja de cálculo en el navegador.
  2. Haz clic en "Compartir" en la esquina superior derecha (en algunas versiones de la interfaz de Google este elemento se llama "Configuración de uso compartido").
  3. Pega la dirección copiada de la cuenta de servicio.
  4. Elige el rol "Editor".
  5. Haz clic en "Enviar".
El rol "Lector" no es suficiente: el servicio no solo lee la hoja de cálculo, también escribe resultados en ella. Hasta que se conceda el acceso, la hoja de cálculo simplemente no existe para el servicio — la prueba de conexión responde "Hoja de cálculo no encontrada o no compartida con la cuenta de servicio".
Estos mismos cinco pasos siempre están a mano en tu cuenta: el botón "¿Cómo?" junto a la dirección de la cuenta de servicio los abre en una ventana. El servicio muestra esa misma ventana por sí solo cuando detecta que falta acceso.

Paso 4. Copia el enlace de la hoja de cálculo

El enlace es la dirección de la hoja de cálculo abierta, tomada de la barra de direcciones del navegador:

https://docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit

Cópialo entero — no hace falta extraer el identificador del medio de la dirección, el servicio lo toma él solo.

La hoja de cálculo está lista. Siguiente — Conectar la hoja de cálculo.