Productivité
Google Tasks dans votre produit et vos agents IA, via une API
Le toolkit Google Tasks couvre les listes de tâches et les tâches : lister, créer, renommer et lire des listes, et créer, modifier, déplacer, terminer et supprimer des tâches, sous-tâches comprises. Le client connecte son compte Google une fois par OAuth, et votre produit ou agent IA appelle chaque opération via un seul endpoint Connect, sans gérer de jetons Google.
15 jours d'essai. Sans carte bancaire.
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>"
}
}Fonctionnement
Du client connecté au premier appel à Google Tasks.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Google Tasks. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Google Tasks.
Des tâches depuis votre produit
Quand quelque chose demande un suivi dans votre app, créez une tâche avec titre, notes et échéance dans la liste Google Tasks du client lui-même.
Statut des tâches dans les deux sens
Listez les tâches d'une liste et lisez leur statut, pour que votre produit montre ce qui est fait et remette une tâche en completed ou needsAction.
Agent IA comme assistant personnel
Laissez un agent ajouter des tâches, en découper une en sous-tâches avec parent et déplacer des tâches entre listes sur demande de l'utilisateur.
Tools
9 tools Google Tasks
- Lister les listes de tâchesGETListe les listes de tâches du compte, avec id et title. Utilisez l'id d'un élément comme tasklist dans les autres outils. Passez nextPageToken comme pageToken pour lire la page suivante.
- Créer une liste de tâchesPOSTCrée une liste de tâches et la renvoie avec son id. Un compte peut avoir jusqu'à 2000 listes de tâches.
- Modifier une liste de tâchesPATCHRenomme une liste de tâches.
- Lister les tâchesGETListe les tâches d'une liste, sous-tâches comprises, avec id, title, notes, status, due, completed et parent, l'id de la tâche parente d'une sous-tâche. Les tâches terminées dans les apps Google sont masquées : mettez showHidden à true pour les voir. Passez nextPageToken comme pageToken pour lire la page suivante.
- Obtenir une tâcheGETRenvoie une tâche avec title, notes, status, échéance, heure de fin, parent et webViewLink, le lien vers la tâche dans l'app web Google Tasks.
- Créer une tâchePOSTCrée une tâche dans une liste, en première position sauf indication contraire de previous. Passez parent pour la créer comme sous-tâche. Les tâches assignées depuis Google Docs ou des espaces Chat ne peuvent pas être créées ici.
- Modifier une tâchePATCHModifie le titre, les notes, l'échéance ou le statut d'une tâche ; seuls les champs envoyés changent. Mettez status à completed pour terminer la tâche, ou à needsAction pour la rouvrir. Pour changer sa liste, son parent ou sa position, utilisez Déplacer une tâche.
- Déplacer une tâchePOSTDéplace une tâche vers une autre position, sous une autre tâche parente ou vers une autre liste. Sans parent la tâche passe au premier niveau, et sans previous elle passe en première position. Les tâches récurrentes ne peuvent pas changer de liste.
- Supprimer une tâcheDELETESupprime une tâche. Une tâche assignée depuis Google Docs ou des espaces Chat y est également supprimée.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/google_tasks, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Google Tasks
Dois-je intégrer l'API Google Tasks moi-même ?
Non. Connect fournit 9 tools Google Tasks décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Google Tasks ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
