Method: tasks.list

Retorna todas as tarefas na lista de tarefas especificada. Não retorna tarefas atribuídas por padrão (nos Documentos, nos espaços do Chat). Um usuário pode ter até 20.000 tarefas não ocultas por lista e até 100.000 tarefas ao mesmo tempo.

Solicitação HTTP

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
tasklist

string

Identificador da lista de tarefas.

Parâmetros de consulta

Parâmetros
completedMax

string

Limite superior para a data de conclusão de uma tarefa (como um carimbo de data/hora RFC 3339) para filtragem. Opcional. O padrão não é filtrar por data de conclusão.

completedMin

string

Limite inferior para a data de conclusão de uma tarefa (como um carimbo de data/hora RFC 3339) para filtragem. Opcional. O padrão não é filtrar por data de conclusão.

dueMax

string

Limite superior para a data de conclusão de uma tarefa (como um carimbo de data/hora RFC 3339) para filtragem. Opcional. O padrão não é filtrar por data de conclusão.

dueMin

string

Limite inferior para a data de conclusão de uma tarefa (como um carimbo de data/hora RFC 3339) para filtragem. Opcional. O padrão não é filtrar por data de conclusão.

maxResults

integer

Número máximo de tarefas retornadas em uma página. Opcional. O padrão é 20 (máximo permitido: 100).

pageToken

string

Token que especifica a página de resultados a ser retornada. Opcional.

showCompleted

boolean

Sinalização que indica se tarefas concluídas são retornadas no resultado. showHidden também precisa ser "True" para mostrar tarefas concluídas em clientes próprios, como a interface da Web e os apps para dispositivos móveis do Google. Opcional. O padrão é "True".

showDeleted

boolean

Sinalização que indica se tarefas excluídas são retornadas no resultado. Opcional. O valor padrão é falso.

showHidden

boolean

Sinalizador que indica se tarefas ocultas são retornadas no resultado. Opcional. O valor padrão é falso.

updatedMin

string

Limite inferior para o horário da última modificação de uma tarefa (como um carimbo de data/hora RFC 3339) para filtragem. Opcional. O padrão não é filtrar pela hora da última modificação.

showAssigned

boolean

Opcional. Sinalizador que indica se as tarefas atribuídas ao usuário atual são retornadas no resultado. Opcional. O valor padrão é falso.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:

Representação JSON
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
Campos
kind

string

Tipo do recurso. É sempre "tasks#tasks".

etag

string

ETag do recurso.

nextPageToken

string

Token usado para acessar a próxima página deste resultado.

items[]

object (Task)

Coleção de tarefas.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

Para mais informações, consulte o Guia de autorização.

Tarefas

Representação JSON
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
Campos
kind

string

Tipo do recurso. É sempre "tasks#tasks".

etag

string

ETag do recurso.

nextPageToken

string

Token usado para acessar a próxima página deste resultado.

items[]

object (Task)

Coleção de tarefas.