Usar parâmetros de tarefas
Além dos parâmetros de consulta padrão que podem ser usados com a maioria das APIs do Google, há um conjunto de parâmetros de tarefas.
Os parâmetros de solicitação que se aplicam apenas a operações específicas na API Google Tasks estão resumidos na tabela a seguir. Todos os valores de parâmetros precisam ser codificados no URL.
Parâmetro |
Significado |
Observações |
Aplicabilidade |
completedMax |
Limite superior para a data de conclusão de uma tarefa (como um carimbo de data/hora RFC 3339) para filtrar. |
- Padrão:
completedMax=2031-01-01
- Use o formato de carimbo de data/hora RFC 3339. Por exemplo:
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
Limite inferior para a data de conclusão de uma tarefa (como um carimbo de data/hora RFC 3339) para filtrar. |
- Padrão:
completedMin=1970-01-01
- Use o formato de carimbo de data/hora RFC 3339. Por exemplo:
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
Limite superior para a data de conclusão de uma tarefa (como um carimbo de data/hora RFC 3339) para filtrar. |
- Padrão:
dueMax=2031-01-01
- Use o formato de carimbo de data/hora RFC 3339. Por exemplo:
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
Limite inferior para a data de conclusão de uma tarefa (como um carimbo de data/hora RFC 3339) para filtrar. |
- Padrão:
dueMin=1970-01-01
- Use o formato de carimbo de data/hora RFC 3339. Por exemplo:
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
O número máximo de elementos para retornar com essa solicitação. |
- Padrão:
maxResults=20
- Valor máximo permitido:
maxResults=100.
|
- Como recuperar listas de tarefas de um usuário
- Como recuperar tarefas
|
pageToken |
Token especificando a página de resultados a ser retornada. |
- O padrão é retornar a primeira página.
|
- Como recuperar listas de tarefas de um usuário
- Como recuperar tarefas
|
parent |
Especifique o ID da tarefa pai da tarefa. |
- Nenhum parâmetro indica uma inserção ou uma mudança para o nível superior da lista de tarefas.
|
- Como criar uma tarefa
- Como pedir uma tarefa
|
previous |
Especifique o ID da tarefa anterior. |
- Nenhum parâmetro indica uma inserção ou uma mudança para a primeira posição na sublista.
|
- Como criar uma tarefa
- Como pedir uma tarefa
|
showCompleted |
Especifique se tarefas devem ser exibidas ou não. |
- Padrão:
showCompleted=true
|
|
showDeleted |
Especifique se tarefas devem ou não ser exibidas. |
- Padrão:
showDeleted=false
|
|
showHidden |
Especifique se você quer ou não mostrar tarefas ocultas. |
|
|
updatedMin |
Limite inferior para o horário da última modificação de uma tarefa (como um carimbo de data/hora RFC 3339) para filtragem. |
- Use o formato de carimbo de data/hora RFC 3339. Por exemplo,
2010-08-09T10:57:00.000-08:00Z .
- O padrão é não filtrar pela hora da última modificação.
|
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-03 UTC.
[null,null,["Última atualização 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"]]