gog

O que gog faz?

Use gog para Gmail/Calendário/Drive/Contatos/Planilhas/Documentos. Requer configuração OAuth.

Configuração (uma vez)

• gog auth credentials /caminho/para/client_secret.json
• gog auth add [email protected] --services gmail,calendar,drive,contacts,docs,sheets
• gog auth list

Comandos comuns

• Pesquisa no Gmail: gog gmail search 'newer_than:7d' --max 10
• Pesquisa de mensagens do Gmail (por e-mail, ignora threads): gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account [email protected]
• Envio de e-mail (simples): gog gmail send --to [email protected] --subject "Oi" --body "Olá"
• Envio de e-mail (várias linhas): gog gmail send --to [email protected] --subject "Oi" --body-file ./mensagem.txt
• Envio de e-mail (stdin): gog gmail send --to [email protected] --subject "Oi" --body-file -
• Envio de e-mail (HTML): gog gmail send --to [email protected] --subject "Oi" --body-html "<p>Olá</p>"
• Rascunho no Gmail: gog gmail drafts create --to [email protected] --subject "Oi" --body-file ./mensagem.txt
• Enviar rascunho: gog gmail drafts send <idDoRascunho>
• Responder e-mail: gog gmail send --to [email protected] --subject "Re: Oi" --body "Resposta" --reply-to-message-id <idDaMsg>
• Listar eventos do calendário: gog calendar events <idDoCalendario> --from <iso> --to <iso>
• Criar evento no calendário: gog calendar create <idDoCalendario> --summary "Título" --from <iso> --to <iso>
• Criar evento com cor: gog calendar create <idDoCalendario> --summary "Título" --from <iso> --to <iso> --event-color 7
• Atualizar evento no calendário: gog calendar update <idDoCalendario> <idDoEvento> --summary "Novo Título" --event-color 4
• Mostrar cores do calendário: gog calendar colors
• Pesquisar no Drive: gog drive search "consulta" --max 10
• Contatos: gog contacts list --max 20
• Obter dados de planilha: gog sheets get <idDaPlanilha> "Aba!A1:D10" --json
• Atualizar planilha: gog sheets update <idDaPlanilha> "Aba!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
• Adicionar linhas à planilha: gog sheets append <idDaPlanilha> "Aba!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
• Limpar planilha: gog sheets clear <idDaPlanilha> "Aba!A2:Z"
• Metadados da planilha: gog sheets metadata <idDaPlanilha> --json
• Exportar documento: gog docs export <idDoDoc> --format txt --out /tmp/doc.txt
• Visualizar documento: gog docs cat <idDoDoc>

Cores do Calendário

• Use gog calendar colors para ver todas as cores de evento disponíveis (IDs 1-11)
• Adicione cores aos eventos com a flag --event-color <id>
• IDs das cores dos eventos (da saída de gog calendar colors):
  • 1: #a4bdfc
  • 2: #7ae7bf
  • 3: #dbadff
  • 4: #ff887c
  • 5: #fbd75b
  • 6: #ffb878
  • 7: #46d6db
  • 8: #e1e1e1
  • 9: #5484ed
  • 10: #51b749
  • 11: #dc2127

Formatação de E-mail

• Prefira texto simples. Use --body-file para mensagens de vários parágrafos (ou --body-file - para stdin).

• O mesmo padrão --body-file funciona para rascunhos e respostas.

• --body não interpreta \n. Se precisar de quebras de linha inline, use um heredoc ou $'Linha 1\n\nLinha 2'.

• Use --body-html apenas quando precisar de formatação rica.

• Tags HTML: <p> para parágrafos, <br> para quebras de linha, <strong> para negrito, <em> para itálico, <a href="url"> para links, <ul>/<li> para listas.

• Exemplo (texto simples via stdin):

  gog gmail send --to [email protected] \
    --subject "Acompanhamento de Reunião" \
    --body-file - <<'EOF'
  Olá Nome,
  
  Obrigado pela reunião de hoje. Próximos passos:
  - Item um
  - Item dois
  
  Atenciosamente,
  Seu Nome
  EOF
  

• Exemplo (lista em HTML):

  gog gmail send --to [email protected] \
    --subject "Acompanhamento de Reunião" \
    --body-html "<p>Olá Nome,</p><p>Obrigado pela reunião de hoje. Aqui estão os próximos passos:</p><ul><li>Item um</li><li>Item dois</li></ul><p>Atenciosamente,<br>Seu Nome</p>"
  

Notas

• Defina [email protected] para evitar repetir --account.
• Para scripts, prefira --json junto com --no-input.
• Os valores das planilhas podem ser passados via --values-json (recomendado) ou como linhas inline.
• Documentos suporta export/cat/copy. Edições in-place requerem um cliente da API Docs (não disponível no gog).
• Confirme antes de enviar e-mails ou criar eventos.
• gog gmail search retorna uma linha por thread; use gog gmail messages search quando precisar que cada e-mail individual seja retornado separadamente.