gog

gog

Gmail／Calendar／Drive／Contacts／Sheets／Docs には gog を使用します。OAuth のセットアップが必要です。

セットアップ（一度のみ）

• gog auth credentials /path/to/client_secret.json
• gog auth add [email protected] --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 [email protected]
• Gmail の送信（プレーンテキスト）：gog gmail send --to [email protected] --subject "Hi" --body "Hello"
• Gmail の送信（複数行）：gog gmail send --to [email protected] --subject "Hi" --body-file ./message.txt
• Gmail の送信（標準入力）：gog gmail send --to [email protected] --subject "Hi" --body-file -
• Gmail の送信（HTML）：gog gmail send --to [email protected] --subject "Hi" --body-html "<p>Hello</p>"
• Gmail の下書き：gog gmail drafts create --to [email protected] --subject "Hi" --body-file ./message.txt
• Gmail の下書きの送信：gog gmail drafts send <draftId>
• Gmail の返信：gog gmail send --to [email protected] --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId>
• Calendar の予定一覧：gog calendar events <calendarId> --from <iso> --to <iso>
• Calendar の予定作成：gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>
• 色を指定して Calendar の予定を作成：gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7
• Calendar の予定を更新：gog calendar update <calendarId> <eventId> --summary "New Title" --event-color 4
• Calendar の色を表示：gog calendar colors
• Drive の検索：gog drive search "query" --max 10
• Contacts：gog contacts list --max 20
• Sheets の取得：gog sheets get <sheetId> "Tab!A1:D10" --json
• Sheets の更新：gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
• Sheets への追記：gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
• Sheets のクリア：gog sheets clear <sheetId> "Tab!A2:Z"
• Sheets のメタデータ：gog sheets metadata <sheetId> --json
• Docs のエクスポート：gog docs export <docId> --format txt --out /tmp/doc.txt
• Docs の表示：gog docs cat <docId>

Calendar の色

• 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

メールの書式設定

• プレーンテキストを推奨します。複数段落のメッセージには --body-file（標準入力の場合は --body-file -）を使用します。

• 同じ --body-file のパターンは下書きと返信にも使えます。

• --body は \n を改行に変換しません。行内に改行を入れる必要がある場合は、ヒアドキュメントまたは $'Line 1\n\nLine 2' を使用します。

• リッチな書式設定が必要な場合にのみ --body-html を使用します。

• HTML タグ：段落には <p>、改行には <br>、太字には <strong>、斜体には <em>、リンクには <a href="url">、リストには <ul>／<li> を使用します。

• 例（標準入力経由のプレーンテキスト）：

  gog gmail send --to [email protected] \
    --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 リスト）：

  gog gmail send --to [email protected] \
    --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>"
  

注意事項

• [email protected] を設定すると、毎回 --account を指定せずに済みます。
• スクリプトでは、--json と --no-input の併用を推奨します。
• Sheets の値は、--values-json（推奨）またはインラインの行で渡せます。
• Docs はエクスポート／表示／コピーに対応しています。ドキュメント内の編集には Docs API クライアントが必要です（gog には含まれていません）。
• メールの送信または予定の作成前に確認してください。
• gog gmail search はスレッドごとに 1 行を返します。個々のメールをすべて別々に返す必要がある場合は、gog gmail messages search を使用します。