Method: tasks.list

Renvoie toutes les tâches de la liste spécifiée. Ne permet pas d'afficher les tâches attribuées par défaut (dans Docs et dans les 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 d'achèvement d'une tâche (en tant qu'horodatage RFC 3339) à utiliser comme critère de filtrage. Facultatif. Par défaut, les filtres ne sont pas filtrés par date de fin.

completedMin

string

Limite inférieure de la date d'achèvement d'une tâche (sous forme d'horodatage RFC 3339) à utiliser comme critère de filtrage. Facultatif. Par défaut, les filtres ne sont pas filtrés par date de fin.

dueMax

string

Limite supérieure de la date d'échéance d'une tâche (sous forme d'horodatage RFC 3339) à utiliser comme critère de filtrage. Facultatif. Par défaut, les filtres ne sont pas filtrés par date d'échéance.

dueMin

string

Limite inférieure de la date d'échéance d'une tâche (sous forme d'horodatage RFC 3339) à utiliser comme critère de filtrage. Facultatif. Par défaut, les filtres ne sont pas filtrés par date d'échéance.

maxResults

integer

Nombre maximal de tâches renvoyées par 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

Indique si les tâches terminées sont renvoyées dans le résultat. Notez que la valeur de "showHidden" doit également être définie sur "True" pour afficher les tâches effectuées dans les clients propriétaires, tels que l'interface utilisateur Web et les applications mobiles Google. Facultatif. La valeur par défaut est "True".

showDeleted

boolean

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

showHidden

boolean

Indique 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 la dernière modification d'une tâche (en tant qu'horodatage RFC 3339) à utiliser comme critère de filtrage. Facultatif. Par défaut, les filtres ne sont pas filtrés en fonction de l'heure de la dernière modification.

showAssigned

boolean

Facultatif. Indique 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 relatif aux autorisations.

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.