Utiliser les paramètres des tâches
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 2024/09/03 (UTC).
[null,null,["Dernière mise à jour le 2024/09/03 (UTC)."],[[["In addition to standard query parameters, the Google Tasks API utilizes specific parameters for refined task management."],["These parameters control filtering by due dates, completion dates, modification times, and the visibility of completed, deleted, or hidden tasks."],["Developers can use these parameters to retrieve specific sets of tasks based on various criteria, such as completion status and due dates, using RFC 3339 timestamps for filtering."],["Parameters like `maxResults` and `pageToken` allow for pagination and control over the number of tasks returned in a response."],["The `parent` and `previous` parameters enable developers to manage task hierarchy and ordering within task lists."]]],["The Google Tasks API uses specific parameters for operations, all of which require URL encoding. These parameters filter tasks by `completedMin/Max`, `dueMin/Max`, and `updatedMin` date ranges using RFC 3339 timestamps. `maxResults` limits the number of returned items, and `pageToken` specifies the result page. `parent` and `previous` parameters determine task order, while `showCompleted`, `showDeleted`, and `showHidden` control the visibility of tasks. These parameters apply to retrieving tasks and task lists, creating, and ordering tasks.\n"]]
