Produtividade
Google Tasks no seu produto e nos seus agentes de IA, por uma API
O toolkit do Google Tasks cobre listas de tarefas e tarefas: listar, criar, renomear e ler listas, e criar, atualizar, mover, concluir e excluir tarefas, inclusive subtarefas. O cliente conecta a conta Google uma vez por OAuth, e seu produto ou agente de IA chama cada operação por um único endpoint do Connect, sem lidar com tokens do Google.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/google_tasks_create_tasklist/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"title": "<title>"
}
}Como funciona
Do cliente conectado à primeira chamada no Google Tasks.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Google Tasks. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Google Tasks.
Pendências a partir do produto
Quando algo precisa de acompanhamento no seu app, crie uma tarefa com título, notas e data de vencimento na lista do Google Tasks do próprio cliente.
Status de tarefa nos dois sentidos
Liste as tarefas de uma lista e leia o status, para seu produto mostrar o que foi feito e marcar uma tarefa como completed ou needsAction de novo.
Agente de IA como assistente pessoal
Deixe um agente adicionar tarefas, dividir uma em subtarefas com parent e mover tarefas entre listas quando o usuário pedir.
Tools
9 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.
- Listar tarefasGETLista 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.
- 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á.
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.
Perguntas sobre o toolkit do Google Tasks
Preciso implementar a API do Google Tasks?
Não. O Connect já traz 9 tools do Google Tasks descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Google Tasks?
Pelo modo que o toolkit aceita: OAuth com o app do seu produto. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
