A integração de APIs do Google Workspace – como Drive, Gmail, Agenda e Planilhas – em aplicativos e pipelines de dados geralmente exige a escrita de código boilerplate para lidar com endpoints REST, paginação e fluxos OAuth 2.0. A equipe do Google AI acabou de lançar uma ferramenta CLI (gws) para o Google Workspace. O código-fonte aberto googleworkspace/cli (invocado via comando gws) oferece uma interface de linha de comando unificada e dinâmica para gerenciar esses serviços. Projetado tanto para desenvolvedores humanos quanto para agentes de IA, o gws elimina a necessidade de scripts wrapper customizados, fornecendo saídas JSON estruturadas, suporte nativo ao Model Context Protocol (MCP) e fluxos de trabalho de autenticação automatizados. Arquitetura de Descoberta Dinâmica de API Ao contrário das ferramentas CLI tradicionais que compilam uma lista estática de comandos, o gws constrói sua superfície de comando dinamicamente em tempo de execução. Quando executado, o gws usa uma estratégia de análise em duas fases: Ele lê o primeiro argumento para identificar o serviço de destino (por exemplo, drive). Ele busca o Google Discovery Document desse serviço (armazenado em cache por 24 horas). Ele constrói uma árvore de comandos a partir dos recursos e métodos do documento. Ele analisa os argumentos restantes, autentica e executa a requisição HTTP. Devido a essa arquitetura, o gws suporta automaticamente novos endpoints da API Google Workspace no momento em que são adicionados ao Discovery Service. Recursos Essenciais para Engenheiros de Software e Cientistas de Dados O CLI pode ser instalado via npm ( npm install -g @googleworkspace/cli ) ou compilado a partir do código-fonte ( cargo install --path . ). Uma vez instalado, ele oferece várias utilidades integradas para extração e automação de dados: Introspecção e Pré-visualização: Cada recurso inclui documentação --help gerada a partir da Discovery API. Você pode visualizar o esquema de qualquer método (por exemplo, gws schema drive.files.list ) ou usar a flag --dry-run para pré-visualizar a requisição HTTP exata antes da execução. Extração de Dados Estruturados: Por padrão, cada resposta – incluindo erros e metadados – é retornada como JSON estruturado. Auto-Paginação: Para desenvolvedores que extraem grandes conjuntos de dados, a flag --page-all lida automaticamente com os cursores da API. Ela transmite resultados paginados como NDJSON (Newline Delimited JSON), que pode ser direcionado diretamente para processadores JSON de linha de comando: Bash gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name' Integração com Agentes de IA e MCP Um caso de uso principal para o gws é atuar como um backend de chamada de ferramentas para Large Language Models (LLMs). Servidor do Model Context Protocol (MCP): Ao executar gws mcp -s drive,gmail,calendar
Fonte: MarkTechPost
Publicado em 2026-03-05