Method: tasks.list

Renvoie toutes les tâches de la liste de tâches spécifiée. Par défaut, les tâches attribuées ne sont pas renvoyées (à partir de Docs et d'espaces Chat). Un utilisateur peut avoir jusqu'à 20 000 tâches non masquées par liste et jusqu'à 100 000 tâches au total à la fois.

Requête HTTP

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
tasklist

string

Identifiant de la liste de tâches.

Paramètres de requête

Paramètres
completedMax

string

Limite supérieure de la date de fin d'une tâche (au format code temporel RFC 3339) à utiliser pour filtrer. Facultatif. Par défaut, le filtre par date de fin n'est pas appliqué.
completedMin

string

Limite inférieure de la date de fin d'une tâche (au format code temporel RFC 3339) à utiliser pour filtrer. Facultatif. Par défaut, aucun filtre n'est appliqué à la date de fin.
dueMax

string

Limite supérieure de la date limite d'une tâche (au format code temporel RFC 3339) à utiliser pour filtrer. Facultatif. Par défaut, le filtre par date limite n'est pas activé.
dueMin

string

Limite inférieure de la date limite d'une tâche (au format code temporel RFC 3339) à utiliser pour filtrer. Facultatif. Par défaut, le filtre par date limite n'est pas appliqué.
maxResults

integer

Nombre maximal de tâches renvoyées sur une page. Facultatif. La valeur par défaut est 20 (valeur maximale autorisée: 100).
pageToken

string

Jeton spécifiant la page de résultats à renvoyer. Facultatif.
showCompleted

boolean

Indicateur indiquant si les tâches terminées sont renvoyées dans le résultat. Notez que showHidden doit également être défini sur "true" pour afficher les tâches terminées dans les clients propriétaires, tels que l'UI Web et les applications mobiles de Google. Facultatif. La valeur par défaut est "True".
showDeleted

boolean

Indicateur indiquant si les tâches supprimées sont renvoyées dans le résultat. Facultatif. La valeur par défaut est "False" (faux).
showHidden

boolean

Indicateur indiquant si les tâches masquées sont renvoyées dans le résultat. Facultatif. La valeur par défaut est "False" (faux).
updatedMin

string

Limite inférieure de l'heure de dernière modification d'une tâche (au format code temporel RFC 3339) à utiliser pour filtrer. Facultatif. Par défaut, le filtrage par heure de dernière modification n'est pas activé.
showAssigned

boolean

Facultatif. Indicateur indiquant si les tâches attribuées à l'utilisateur actuel sont renvoyées dans le résultat. Facultatif. La valeur par défaut est "False" (faux).

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :

Représentation JSON 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
Champs
kind

string

Type de la ressource. Il s'agit toujours de "tasks#tasks".
etag

string

ETag de la ressource.
nextPageToken

string

Jeton utilisé pour accéder à la page suivante de ce résultat.
items[]

object (Task)

Ensemble de tâches.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

Pour en savoir plus, consultez le guide d'autorisation.

Tâches

Représentation JSON 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
Champs
kind

string

Type de la ressource. Il s'agit toujours de "tasks#tasks".
etag

string

ETag de la ressource.
nextPageToken

string

Jeton utilisé pour accéder à la page suivante de ce résultat.
items[]

object (Task)

Ensemble de tâches.