Lister les tâches avec l'API Google Tasks

Liste 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.

Identifiant
google_tasks_list_tasks

L'appel

POST https://connect.reportei.com/api/tools/google_tasks_list_tasks/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "tasklist": "<tasklist>"
  }
}

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ètreTypeObligatoireDescription
taskliststringOuiTask list id from List task lists.
dueMinstringNonOnly tasks due on or after this RFC 3339 timestamp, such as 2026-10-01T00:00:00Z.
dueMaxstringNonOnly tasks due before this RFC 3339 timestamp.
completedMinstringNonOnly tasks completed on or after this RFC 3339 timestamp.
completedMaxstringNonOnly tasks completed before this RFC 3339 timestamp.
updatedMinstringNonOnly tasks changed on or after this RFC 3339 timestamp.
showCompletedbooleanNonIncludes completed tasks. The default is true, but tasks completed in the Google apps also need showHidden set to true.
showHiddenbooleanNonIncludes hidden tasks, which are the completed tasks cleared from the list, including the ones completed in the Google apps. The default is false.
showDeletedbooleanNonIncludes deleted tasks. The default is false.
showAssignedbooleanNonIncludes the tasks assigned to the account from Google Docs or Chat spaces. The default is false.
maxResultsintegerNonTasks per page, up to 100. The default is 20.
pageTokenstringNonThe nextPageToken of the previous response.

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_list_tasks. Il devient la définition de tool de votre agent sans conversion.

Autres tools Google Tasks

Voir les 9 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.