Listar tarefas no Google Tasks, por uma API
Lista as tarefas de uma lista de tarefas, subtarefas incluídas, com id, title, notes, status, due, completed e parent, o id da tarefa-mãe de uma subtarefa. Tarefas concluídas nos apps do Google ficam ocultas: defina showHidden como true para vê-las. Passe nextPageToken como pageToken para ler a próxima página.
- Identificador
- google_tasks_list_tasks
A chamada
POST https://connect.reportei.com/api/tools/google_tasks_list_tasks/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"tasklist": "<tasklist>"
}
}Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.
Parâmetros
As descrições dos parâmetros seguem a documentação oficial do app, em inglês.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tasklist | string | Sim | Task list id from List task lists. |
| dueMin | string | Não | Only tasks due on or after this RFC 3339 timestamp, such as 2026-10-01T00:00:00Z. |
| dueMax | string | Não | Only tasks due before this RFC 3339 timestamp. |
| completedMin | string | Não | Only tasks completed on or after this RFC 3339 timestamp. |
| completedMax | string | Não | Only tasks completed before this RFC 3339 timestamp. |
| updatedMin | string | Não | Only tasks changed on or after this RFC 3339 timestamp. |
| showCompleted | boolean | Não | Includes completed tasks. The default is true, but tasks completed in the Google apps also need showHidden set to true. |
| showHidden | boolean | Não | Includes hidden tasks, which are the completed tasks cleared from the list, including the ones completed in the Google apps. The default is false. |
| showDeleted | boolean | Não | Includes deleted tasks. The default is false. |
| showAssigned | boolean | Não | Includes the tasks assigned to the account from Google Docs or Chat spaces. The default is false. |
| maxResults | integer | Não | Tasks per page, up to 100. The default is 20. |
| pageToken | string | Não | The nextPageToken of the previous response. |
Conexões possíveis
O seu cliente conecta a conta do Google Tasks uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/google_tasks, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
A resposta
Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.
Pronta para agentes de IA
O input desta tool é um JSON Schema, disponível em GET /api/tools/google_tasks_list_tasks. Ele vira a definição de tool do seu agente sem conversão.
Outras tools do Google Tasks
- Listar listas de tarefasGETLista as listas de tarefas da conta, com id e title. Use o id de um item como tasklist nas outras ferramentas. Passe nextPageToken como pageToken para ler a próxima página.
- Criar lista de tarefasPOSTCria uma lista de tarefas e a retorna com seu id. Uma conta pode ter até 2000 listas de tarefas.
- Atualizar lista de tarefasPATCHRenomeia uma lista de tarefas.
- Obter tarefaGETRetorna uma tarefa com title, notes, status, data de vencimento, horário de conclusão, parent e webViewLink, o link da tarefa no app web do Google Tasks.
- Criar tarefaPOSTCria uma tarefa em uma lista, na primeira posição, a menos que previous diga outra. Passe parent para criá-la como subtarefa. Tarefas atribuídas a partir do Google Docs ou de espaços do Chat não podem ser criadas aqui.
- Atualizar tarefaPATCHAltera o título, as notas, a data de vencimento ou o status de uma tarefa; só os campos enviados mudam. Defina status como completed para concluir a tarefa, ou como needsAction para reabri-la. Para mudar sua lista, parent ou posição, use Mover tarefa.
- Mover tarefaPOSTMove uma tarefa para outra posição, sob outra tarefa-mãe ou para outra lista de tarefas. Sem parent a tarefa vai para o nível principal, e sem previous vai para a primeira posição. Tarefas recorrentes não podem ir para outra lista.
- Excluir tarefaDELETEExclui uma tarefa. Uma tarefa atribuída a partir do Google Docs ou de espaços do Chat também é excluída lá.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
