gog

gog を使用して Gmail、Calendar、Drive、Contacts、Sheets、Docs を操作できます。OAuth の設定が必要です。

セットアップ（1 回限り）

• 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 送信（標準入力）: 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>
• 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 cat: 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 をアンエスケープしません。インライン改行が必要な場合は heredoc または $'Line 1\n\nLine 2' を使用してください。

• リッチテキストが必要な場合のみ --body-html を使用。

• HTML タグ: <p> で段落、<br> で改行、<strong> で太字、<em> でイタリック、<a href="url"> でリンク、<ul>/<li> でリスト。

• 例（プレーンテキスト・標準入力）:

  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 リスト）:

  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>"
  

注記

• --account の繰り返し指定を避けるため GOG_ACCOUNT=you@gmail.com を設定してください。
• スクリプト用途では --json と --no-input を推奨。
• Sheets の値は --values-json（推奨）またはインラインの行で渡せます。
• Docs はエクスポート・cat・コピーに対応。その場での編集は Docs API クライアント（gog に含まれない）が必要です。
• メール送信またはイベント作成の前に確認してください。
• gog gmail search はスレッドごとに 1 行を返します。個別メールをすべて返すには gog gmail messages search を使用してください。