Desde 30 de setembro de 2026, as APIs do Google Docs, Sheets e Slides podem criar, ler e gerenciar comentários. No Docs, sistemas também podem propor alterações como sugestões para revisão humana, sem modificar o texto diretamente. A novidade permite conectar fluxos editoriais, jurídicos e operacionais ao Workspace, desde que permissões, contexto e decisões continuem rastreáveis.
Escolha comentário, sugestão ou alteração direta
Use comentários para pedir confirmação, registrar dúvida ou atribuir uma revisão. Use sugestões quando o sistema consegue propor uma redação específica, mas a decisão precisa permanecer com uma pessoa. Reserve alterações diretas para dados de baixo risco, regras determinísticas e casos em que o proprietário autorizou a automação.
Essa separação evita que velocidade seja confundida com autoridade. Uma ferramenta pode detectar uma cláusula inconsistente e sugerir correção, mas a área jurídica continua responsável por aceitar, rejeitar ou reescrever. O mesmo vale para números de uma planilha e mensagens de uma apresentação.
Mapeie as capacidades de cada API
Na API do Docs, aplicativos podem adicionar, revisar e responder comentários, além de enviar mudanças de texto como sugestões. A API do Sheets permite comentários ligados a células específicas. A API do Slides trabalha com comentários associados a slides ou elementos da apresentação.
Modele o fluxo conforme o objeto real. Um comentário genérico no arquivo perde precisão quando o problema está em uma célula, gráfico ou trecho. Armazene o identificador do documento, posição, autor da automação, motivo, regra aplicada e estado da revisão para reconstruir a decisão depois.
Desenhe um fluxo de revisão com responsável
Um bom fluxo começa com um evento verificável: novo contrato, fechamento mensal, atualização de apresentação ou etapa do calendário editorial. A automação analisa, cria comentários ou sugestões e atribui a revisão à função correta. A publicação ou envio só ocorre depois da aprovação prevista.
Evite criar centenas de observações sem prioridade. Agrupe duplicatas, defina severidade e limite o número de comentários por execução. Quando a confiança for baixa ou as regras entrarem em conflito, gere uma única pendência explicando o que falta em vez de inventar uma correção.
- Evento que inicia a revisão
- Documento e intervalo autorizado
- Regra que gera comentário ou sugestão
- Pessoa ou grupo responsável pela decisão
- Prazo, escalada e condição de encerramento
Aplique acesso mínimo e registre identidades
O Google informa que não há um controle administrativo específico para ativar essa função. Administradores ainda podem controlar quais aplicativos acessam dados do Workspace, e usuários podem gerenciar conexões de terceiros. Solicite apenas os escopos necessários e separe ambientes de teste e produção.
Use uma identidade de serviço ou aplicativo claramente atribuída, preserve o autor original e registre quem aceitou a mudança. Comentários podem conter dados pessoais ou confidenciais; aplique retenção, acesso e classificação compatíveis com o documento, não apenas com o código da integração.
Evite duplicação e ciclos de automação
Guarde uma chave idempotente para cada regra, documento e versão. Antes de criar um comentário, verifique se a mesma observação está aberta, resolvida ou rejeitada. Sem isso, uma rotina agendada pode repetir avisos e tornar a revisão inutilizável.
Também impeça que a própria sugestão dispare uma nova análise indefinidamente. Marque alterações originadas pelo sistema, defina quais eventos merecem reprocessamento e limite tentativas. Falhas devem ir para uma fila de revisão, não para um ciclo automático sem fim.
Valide disponibilidade e resultado do piloto
O lançamento é gradual por até 15 dias a partir de 30 de setembro de 2026 e está previsto para clientes do Workspace e contas pessoais. Suporte programático a comentários nos servidores MCP de Docs, Sheets e Slides continua em prévia para desenvolvedores; não trate essa camada como produção estável sem avaliação própria.
Meça tempo até a decisão, taxa de sugestões aceitas, comentários duplicados, falsos positivos, revisões vencidas e incidentes de permissão. O objetivo não é gerar mais observações, mas reduzir espera e retrabalho sem retirar o controle de quem responde pelo documento.
Para levar daqui
Comentários e sugestões por API permitem automatizar a preparação da revisão sem automatizar a decisão. Comece com um fluxo estreito, contexto preciso, acesso mínimo, idempotência e métricas de aceitação antes de ampliar.
