Cómo usar los parámetros de Tasks
Además de los parámetros de consulta estándar que se pueden usar con la mayoría de las API de Google, hay un conjunto de parámetros de Tareas.
En la siguiente tabla, se resumen los parámetros de solicitud que se aplican solo a operaciones específicas en la API de Google Tasks. Todos los valores de los parámetros deben estar codificados en URL.
| Parámetro |
Significado |
Notas |
Aplicabilidad |
completedMax |
Límite superior para la fecha de finalización de una tarea (como una marca de tiempo RFC 3339) con la que se debe filtrar. |
- Valor predeterminado:
completedMax=2031-01-01
- Usa el formato de marca de tiempo RFC 3339. Por ejemplo:
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
Límite inferior de la fecha de finalización de una tarea (como una marca de tiempo RFC 3339) para filtrar. |
- Valor predeterminado:
completedMin=1970-01-01
- Usa el formato de marca de tiempo RFC 3339. Por ejemplo:
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
Límite superior para la fecha límite de una tarea (como una marca de tiempo RFC 3339) con la que se debe filtrar. |
- Valor predeterminado:
dueMax=2031-01-01
- Usa el formato de marca de tiempo RFC 3339. Por ejemplo:
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
Límite inferior de la fecha límite de una tarea (como una marca de tiempo RFC 3339) para filtrar. |
- Valor predeterminado:
dueMin=1970-01-01
- Usa el formato de marca de tiempo RFC 3339. Por ejemplo:
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
La cantidad máxima de elementos que se mostrarán con esta solicitud. |
- Valor predeterminado:
maxResults=20
- Valor máximo permitido:
maxResults=100.
|
- Recupera las listas de tareas de un usuario
- Recupera tareas
|
pageToken |
El token que especifica la página de resultados que se mostrará. |
- La opción predeterminada es mostrar la primera página.
|
- Recupera las listas de tareas de un usuario
- Recupera tareas
|
parent |
Especifica el ID de la tarea principal de la tarea. |
- Ningún parámetro indica una inserción o un movimiento al nivel superior de la lista de tareas.
|
- Crea una tarea
- Ordenar una tarea
|
previous |
Especifica el ID de tarea anterior de la tarea. |
- Ningún parámetro indica una inserción o un movimiento a la primera posición en la sublista.
|
- Crea una tarea
- Ordenar una tarea
|
showCompleted |
Especifica si se muestran o no las tareas completadas. |
- Valor predeterminado:
showCompleted=true
|
|
showDeleted |
Especifica si se muestran o no las tareas borradas. |
- Valor predeterminado:
showDeleted=false
|
|
showHidden |
Especifica si se muestran o no las tareas ocultas. |
- Valor predeterminado:
showHidden=true
|
|
updatedMin |
Límite inferior según la última hora de modificación de una tarea (como una marca de tiempo RFC 3339) para filtrar. |
- Usa el formato de marca de tiempo RFC 3339. Por ejemplo:
2010-08-09T10:57:00.000-08:00Z.
- La configuración predeterminada no permite filtrar según la hora de la última modificación.
|
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-09-03 (UTC)
[null,null,["Última actualización: 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"]]
