Productividad
Google Tasks en tu producto y en tus agentes de IA, con una API
El toolkit de Google Tasks cubre listas de tareas y tareas: listar, crear, renombrar y leer listas, y crear, actualizar, mover, completar y eliminar tareas, incluidas las subtareas. El cliente conecta su cuenta de Google una vez con OAuth, y tu producto o agente de IA llama a cada operación por un único endpoint de Connect, sin manejar tokens de Google.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/google_tasks_create_tasklist/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"title": "<title>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Google Tasks.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Google Tasks. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Google Tasks.
Pendientes desde tu producto
Cuando algo necesita seguimiento en tu app, crea una tarea con título, notas y fecha de vencimiento en la lista de Google Tasks del propio cliente.
Estado de tareas en ambos sentidos
Lista las tareas de una lista y lee su estado, para que tu producto muestre lo hecho y vuelva a marcar una tarea como completed o needsAction.
Agente de IA como asistente personal
Deja que un agente agregue tareas, divida una en subtareas con parent y mueva tareas entre listas cuando el usuario lo pida.
Tools
9 tools de Google Tasks
- Listar listas de tareasGETLista las listas de tareas de la cuenta, con id y title. Usa el id de un elemento como tasklist en las demás herramientas. Pasa nextPageToken como pageToken para leer la página siguiente.
- Crear lista de tareasPOSTCrea una lista de tareas y la devuelve con su id. Una cuenta puede tener hasta 2000 listas de tareas.
- Actualizar lista de tareasPATCHCambia el nombre de una lista de tareas.
- Listar tareasGETLista las tareas de una lista de tareas, subtareas incluidas, con id, title, notes, status, due, completed y parent, el id de la tarea madre de una subtarea. Las tareas completadas en las apps de Google quedan ocultas: pon showHidden en true para verlas. Pasa nextPageToken como pageToken para leer la página siguiente.
- Obtener tareaGETDevuelve una tarea con title, notes, status, fecha de vencimiento, hora de finalización, parent y webViewLink, el enlace a la tarea en la app web de Google Tasks.
- Crear tareaPOSTCrea una tarea en una lista, en la primera posición salvo que previous indique otra. Pasa parent para crearla como subtarea. Las tareas asignadas desde Google Docs o espacios de Chat no se pueden crear aquí.
- Actualizar tareaPATCHCambia el título, las notas, la fecha de vencimiento o el estado de una tarea; solo cambian los campos enviados. Pon status en completed para completar la tarea, o en needsAction para reabrirla. Para cambiar su lista, parent o posición, usa Mover tarea.
- Mover tareaPOSTMueve una tarea a otra posición, bajo otra tarea madre o a otra lista de tareas. Sin parent la tarea va al nivel principal, y sin previous va a la primera posición. Las tareas recurrentes no pueden pasar a otra lista.
- Eliminar tareaDELETEElimina una tarea. Una tarea asignada desde Google Docs o espacios de Chat se elimina también allí.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/google_tasks, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Google Tasks
¿Necesito implementar la API de Google Tasks?
No. Connect ya trae 9 tools de Google Tasks descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Google Tasks?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
