Управляйте Google Workspace (Gmail, Календарь, Диск, Контакты, Таблицы, Документы) с помощью CLI-утилиты gog

Как применить

В метаданных указано, что gog можно установить с помощью формулы gogcli в Homebrew.

Документы поддерживают экспорт, просмотр и копирование; для редактирования на месте требуется клиент Docs API, которого нет в составе gog.

Выполните шаги настройки один раз: gog auth credentials /path/to/client_secret.json, gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets и gog auth list. При отправке писем в Gmail предпочтительно использовать обычный текст: передавайте многострочные сообщения с помощью --body-file (или --body-file - для ввода из stdin), и тот же шаблон --body-file подходит также для черновиков и ответов. Обратите внимание, что --body не раскрывает экранирование \n, поэтому для вставки переносов строк используйте heredoc или $'Line 1\n\nLine 2'; применяйте --body-html только при необходимости форматирования. Например, сообщение в обычном тексте можно отправить через stdin, а HTML-список — с помощью --body-html. В Календаре используйте gog calendar colors, чтобы увидеть все доступные цвета событий (ID 1–11), и добавляйте цвета к событиям с помощью флага --event-color <id>; ID цветов из вывода 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.

Настройка выполняется один раз, начиная с gog auth credentials /path/to/client_secret.json.

Затем настройка продолжается с gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets.

Завершите настройку с помощью gog auth list.

Поиск в Gmail: gog gmail search 'newer_than:7d' --max 10

Поиск сообщений в Gmail (по каждому письму, без учета веток переписки): gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com

Отправка письма в Gmail (обычный текст): gog gmail send --to a@b.com --subject "Hi" --body "Hello"

Отправка письма в Gmail (многострочный текст): gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt

Отправка письма в Gmail (из stdin): gog gmail send --to a@b.com --subject "Hi" --body-file -

Отправка письма в Gmail (HTML): gog gmail send --to a@b.com --subject "Hi" --body-html "<p>Hello</p>"

Черновик в Gmail: gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt

Отправка черновика в Gmail: gog gmail drafts send <draftId>

Ответ в Gmail: gog gmail send --to a@b.com --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId>

Список событий календаря: gog calendar events <calendarId> --from <iso> --to <iso>

Создание события в календаре: gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>

Создание события в календаре с указанием цвета: gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7

Обновление события в календаре: gog calendar update <calendarId> <eventId> --summary "New Title" --event-color 4

Отображение цветов в календаре: gog calendar colors

Поиск в Диске: gog drive search "query" --max 10

Контакты: gog contacts list --max 20

Получение данных таблицы: gog sheets get <sheetId> "Tab!A1:D10" --json

Обновление данных таблицы: gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED

Добавление данных в таблицу: gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS

Очистка данных таблицы: gog sheets clear <sheetId> "Tab!A2:Z"

Метаданные таблицы: gog sheets metadata <sheetId> --json

Экспорт документа: gog docs export <docId> --format txt --out /tmp/doc.txt

Чтение содержимого документа: gog docs cat <docId>

Используйте gog calendar colors, чтобы увидеть все доступные цвета событий (ID от 1 до 11).

Для задания цветов событиям используйте флаг --event-color <id>.

ID цветов событий берутся из вывода gog calendar colors.

ID цвета 1 — #a4bdfc.

ID цвета 2 — #7ae7bf.

ID цвета 3 — #dbadff.

ID цвета 4 — #ff887c.

ID цвета 5 — #fbd75b.

ID цвета 6 — #ffb878.

ID цвета 7 — #46d6db.

ID цвета 8 — #e1e1e1.

ID цвета 9 — #5484ed.

ID цвета 10 — #51b749.

ID цвета 11 — #dc2127.

При отправке писем в Gmail предпочтительно использовать обычный текст; для многострочных сообщений применяйте --body-file (или --body-file - для ввода с терминала).

Тот же шаблон --body-file подходит и для черновиков, и для ответов.

--body не раскрывает экранированные последовательности \n; если нужны переносы строк внутри текста, используйте heredoc или $'Line 1\n\nLine 2'.

Используйте --body-html только тогда, когда требуется форматирование.

Обычное текстовое сообщение можно отправить через ввод с терминала, как показано в примере.

  gog gmail send --to recipient@example.com \
    --subject "Meeting Follow-up" \
    --body-file - <<'EOF'
  Hi Name,

  Thanks for meeting today. Next steps:
  - Item one
  - Item two

  Best regards,
  Your Name
  EOF

HTML-список можно отправить с помощью --body-html, как показано в примере.

  gog gmail send --to recipient@example.com \
    --subject "Meeting Follow-up" \
    --body-html "<p>Hi Name,</p><p>Thanks for meeting today. Here are the next steps:</p><ul><li>Item one</li><li>Item two</li></ul><p>Best regards,<br>Your Name</p>"

Установите GOG_ACCOUNT=you@gmail.com, чтобы избежать повторения --account.

Для скриптов лучше использовать --json вместе с --no-input.

Значения таблиц можно передавать через --values-json (рекомендуется) или в виде строк внутри текста.

Подтвердите действие перед отправкой письма или созданием событий.

gog gmail search возвращает по одной строке на каждую ветку обсуждения; используйте gog gmail messages search, если нужно получить каждое отдельное письмо отдельно.