Method: tasks.list

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

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 máximo para a data de conclusão de uma tarefa (como um carimbo de data/hora RFC 3339) para filtrar. 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 filtrar. Opcional. O padrão é não filtrar por data de conclusão.

dueMax

string

Limite máximo para a data de vencimento de uma tarefa (como um carimbo de data/hora RFC 3339) para filtrar. Opcional. O padrão é não filtrar por data de vencimento.

dueMin

string

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

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

Flag que indica se as tarefas concluídas são retornadas no resultado. A propriedade showHidden também precisa ser verdadeira para mostrar as 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

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

showHidden

boolean

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

updatedMin

string

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

showAssigned

boolean

Opcional. Flag 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 desse resultado.

items[]

object (Task)

Coleta 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 desse resultado.

items[]

object (Task)

Coleta de tarefas.