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)
- Andá a Cargar Horas en el menú.
- Tocá Connect Google Calendar (o el botón equivalente de conectar).
- Aceptá los permisos: la app pide solo lectura del calendario (
calendar.readonly). - Elegí el calendario, el rango de fechas, el workspace y los proyectos de Asana.
- 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)
- En Google Cloud Console, creá un OAuth client (tipo Web).
- Habilitá la Google Calendar API en el proyecto de GCP.
- Agregá el redirect URI:
{NEXTAUTH_URL}/api/google/callback
Ejemplo local: http://localhost:3000/api/google/callback.
- Completá en el entorno:
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...
- 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íntoma | Qué revisar |
|---|---|
| No se abre el login de Google | GOOGLE_CLIENT_ID / secret / NEXTAUTH_URL |
| Error de redirect_uri_mismatch | El redirect en GCP debe coincidir con {NEXTAUTH_URL}/api/google/callback |
| Lista de calendarios vacía | Calendar API habilitada; cuenta con calendarios visibles |
| “Not connected to Google Calendar” | Volvé a conectar desde Cargar Horas |