Method: tasks.list

Renvoie toutes les tâches de la liste spécifiée. Un utilisateur peut avoir jusqu'à 20 000 tâches non masquées par liste et jusqu'à 100 000 tâches à 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 données ne sont pas filtrées par date de fin.
completedMin

string

Limite infé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 données ne sont pas filtrées par date de fin.
dueMax

string

Limite supérieure de la date d'échéance d'une tâche (en tant qu'horodatage RFC 3339) à utiliser comme critère de filtrage. Facultatif. Par défaut, les données ne sont pas filtrées par date limite.
dueMin

string

Limite inférieure de la date d'échéance d'une tâche (en tant qu'horodatage RFC 3339) à utiliser comme critère de filtrage. Facultatif. Par défaut, les données ne sont pas filtrées par date limite.
maxResults

integer

Nombre maximal de tâches renvoyées sur une page. Facultatif. La valeur par défaut est 20 (la valeur maximale autorisée est de 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. Facultatif. La valeur par défaut est "True". Notez que showHidden doit également être défini sur "True" pour afficher les tâches effectuées dans des clients propriétaires, tels que l'interface utilisateur Web et les applications mobiles Google.
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 des 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 la date et 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 données ne sont pas filtrées par date et heure de la dernière modification.

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)

Collection 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)

Collection de tâches.