Utiliser les paramètres des tâches
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
En plus des paramètres de requête standards pouvant être utilisés avec la plupart des API Google, il existe un ensemble de paramètres Tasks.
Les paramètres de requête qui ne s'appliquent qu'à des opérations spécifiques dans l'API Google Tasks sont résumés dans le tableau suivant. Toutes les valeurs des paramètres doivent être encodées au format URL.
| Paramètre |
Signification |
Remarques |
Applicabilité |
completedMax |
Limite supérieure de la date de fin d'une tâche (en tant qu'horodatage RFC 3339) à utiliser pour le filtrage. |
- Valeur par défaut :
completedMax=2031-01-01
- Utilisez le format d'horodatage RFC 3339. Exemple :
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
Limite inférieure pour la date de fin d'une tâche (en tant qu'horodatage RFC 3339) à utiliser pour le filtrage. |
- Valeur par défaut :
completedMin=1970-01-01
- Utilisez le format d'horodatage RFC 3339. Exemple :
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
Limite supérieure de la date limite d'une tâche (en tant qu'horodatage RFC 3339) à utiliser pour le filtrage. |
- Valeur par défaut :
dueMax=2031-01-01
- Utilisez le format d'horodatage RFC 3339. Exemple :
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
Limite inférieure de la date limite d'une tâche (en tant qu'horodatage RFC 3339) à utiliser pour le filtrage. |
- Valeur par défaut :
dueMin=1970-01-01
- Utilisez le format d'horodatage RFC 3339. Exemple :
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
Nombre maximal d'éléments à renvoyer avec cette requête. |
- Valeur par défaut :
maxResults=20
- Valeur maximale autorisée:
maxResults=100.
|
- Récupérer les listes de tâches d'un utilisateur
- Récupérer des tâches
|
pageToken |
Jeton spécifiant la page de résultats à renvoyer. |
- Par défaut, la première page est affichée.
|
- Récupérer les listes de tâches d'un utilisateur
- Récupérer des tâches
|
parent |
Spécifiez l'ID de la tâche parente de la tâche. |
- Aucun paramètre indique une insertion ou un déplacement au premier niveau de la liste de tâches.
|
- Créer une tâche
- Trier une tâche
|
previous |
Spécifiez l'ID de la tâche précédente. |
- Aucun paramètre indique une insertion ou un déplacement à la première position de la sous-liste.
|
- Créer une tâche
- Trier une tâche
|
showCompleted |
Indiquez si vous souhaitez afficher ou non les tâches terminées. |
- Valeur par défaut :
showCompleted=true
|
|
showDeleted |
Indiquez si vous souhaitez afficher les tâches supprimées. |
- Valeur par défaut :
showDeleted=false
|
|
showHidden |
Indiquez si vous souhaitez afficher les tâches masquées. |
- Valeur par défaut :
showHidden=true
|
|
updatedMin |
Limite inférieure de la dernière date de modification d'une tâche (en tant qu'horodatage RFC 3339) à utiliser pour le filtrage. |
- Utilisez le format d'horodatage RFC 3339. Par exemple,
2010-08-09T10:57:00.000-08:00Z.
- Par défaut, le filtre n'est pas basé sur l'heure de la dernière modification.
|
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[],[],null,["# Use Tasks Parameters\n\nIn addition to the standard query parameters that can be used with most Google APIs, there is a set of Tasks parameters.\n\nRequest parameters that apply only to specific operations in the Google Tasks API are summarized in the following table. All parameter values need to be URL encoded.\n\n| Parameter | Meaning | Notes | Applicability |\n|-----------------|------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|\n| `completedMax` | Upper bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `completedMin` | Lower bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMax` | Upper bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMin` | Lower bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `maxResults` | The maximum number of elements to return with this request. | - Default: `maxResults=20` - Maximum allowable value: `maxResults=100.` | - Retrieving a user's task lists - Retrieving tasks |\n| `pageToken` | Token specifying the result page to return. | - The default is to return the first page. | - Retrieving a user's task lists - Retrieving tasks |\n| `parent` | Specify the task's parent task ID. | - No parameter indicates an insertion or a move to the top level of the task list. | - Creating a task - Ordering a task |\n| `previous` | Specify the task's previous task ID. | - No parameter indicates an insertion or a move to the first position in the sublist. | - Creating a task - Ordering a task |\n| `showCompleted` | Specify whether or not to show completed tasks. | - Default: `showCompleted=true` | - Retrieving tasks |\n| `showDeleted` | Specify whether or not to show deleted tasks. | - Default: `showDeleted=false` | - Retrieving tasks |\n| `showHidden` | Specify whether or not to show hidden tasks. | - Default: `showHidden=true` | - Retrieving tasks |\n| `updatedMin` | Lower bound for a task's last modification time (as an RFC 3339 timestamp) to filter by. | - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00Z`. - The default is not to filter by last modification time. | - Retrieving tasks |"]]
