Method: tasks.list

Retorna todas as tarefas na lista de tarefas especificada. Um usuário pode ter até 20.000 tarefas não ocultas por lista e até 100.000 tarefas no total de uma 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 superior 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 superior 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.

dueMin

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.

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 mostrada. Opcional.

showCompleted

boolean

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

showDeleted

boolean

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

showHidden

boolean

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

updatedMin

string

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

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 de 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.