Obtenir une tâche avec l'API Google Tasks
Renvoie 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.
- Identifiant
- google_tasks_get_task
L'appel
POST https://connect.reportei.com/api/tools/google_tasks_get_task/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"tasklist": "<tasklist>",
"task": "<task>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| tasklist | string | Oui | Task list id from List task lists. |
| task | string | Oui | Task id from List tasks. |
Connexions possibles
Votre client connecte son compte Google Tasks une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
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.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/google_tasks_get_task. Il devient la définition de tool de votre agent sans conversion.
Autres 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.
- 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.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
