Configuración de Google Calendar

Para qué sirve

Cargar Horas lee eventos de Google Calendar y los convierte en entradas de time tracking de Asana. La conexión con Google es independiente del login con Asana.

Requisitos

  • Sesión iniciada con Asana.
  • Cuenta de Google con acceso al calendario que querés usar.
  • Plan Asana Business+ (time tracking).
  • (Admin) App OAuth en Google Cloud con la Google Calendar API habilitada.

Cómo se usa (usuario)

  1. Andá a Cargar Horas en el menú.
  2. Tocá Connect Google Calendar (o el botón equivalente de conectar).
  3. Aceptá los permisos: la app pide solo lectura del calendario (calendar.readonly).
  4. Elegí el calendario, el rango de fechas, el workspace y los proyectos de Asana.
  5. Continuá el flujo (ver Cargar Horas).

Desconectar

En el paso de conexión de Cargar Horas podés desconectar Google. Eso borra la cookie de tokens; la sesión de Asana no se toca.

Cómo se configura (admin / deploy)

  1. En Google Cloud Console, creá un OAuth client (tipo Web).
  2. Habilitá la Google Calendar API en el proyecto de GCP.
  3. Agregá el redirect URI:
{NEXTAUTH_URL}/api/google/callback

Ejemplo local: http://localhost:3000/api/google/callback.

  1. Completá en el entorno:
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...
  1. Asana y Google usan flujos separados a propósito: Asana es el login; Google vive en una cookie httpOnly propia.

Saberes clave

  • La app no escribe en el calendario: solo lee eventos y crea time entries en Asana.
  • Si no aparecen calendarios, casi siempre es porque la Calendar API no está habilitada o el OAuth client tiene mal el redirect.
  • Los eventos de todo el día, cancelados o rechazados se ignoran (detalle en Cargar Horas).

Problemas comunes

SíntomaQué revisar
No se abre el login de GoogleGOOGLE_CLIENT_ID / secret / NEXTAUTH_URL
Error de redirect_uri_mismatchEl redirect en GCP debe coincidir con {NEXTAUTH_URL}/api/google/callback
Lista de calendarios vacíaCalendar API habilitada; cuenta con calendarios visibles
“Not connected to Google Calendar”Volvé a conectar desde Cargar Horas