Google Contacts 操作スキル (gog v0.10.0)
gog CLI でGoogle連絡先を操作する。
実行パス: gog
認証アカウント: (gogで認証したアカウント)
Execution Notes
execツールで実行時、timeout: 60を指定
連絡先検索
名前・メール・電話で検索
gog contacts search "田中"
gog contacts search "tanaka@example.com"
gog contacts search "090-1234"検索結果を絞り込み
gog contacts search "山田" --max 10連絡先一覧
gog contacts list
gog contacts list --max 50
gog contacts list --json連絡先詳細
gog contacts get <resourceName>
# resourceNameは "people/c12345678" のような形式連絡先作成
基本
gog contacts create --name "山田太郎"フル情報
gog contacts create \
--name "山田太郎" \
--email "yamada@example.com" \
--phone "090-1234-5678"複数メール・電話
gog contacts create \
--name "佐藤花子" \
--email "sato@company.com" \
--email "sato.personal@example.com" \
--phone "090-1111-2222" \
--phone "03-1234-5678"連絡先更新
gog contacts update <resourceName> --name "新しい名前"
gog contacts update <resourceName> --email "new@example.com"
gog contacts update <resourceName> --phone "080-9999-8888"連絡先削除
gog contacts delete <resourceName>
gog contacts delete <resourceName> --force # 確認スキップディレクトリ連絡先（組織の連絡先）
# 組織ディレクトリの一覧
gog contacts directory list
# ディレクトリ検索
gog contacts directory search "部署名"その他の連絡先
# その他の連絡先一覧
gog contacts other list作成オプション一覧
| オプション | 説明 |
|---|---|
--name | 名前 |
--email | メールアドレス（複数可） |
--phone | 電話番号（複数可） |
--organization | 会社名 |
--title | 役職 |
--note | メモ |
出力オプション
| オプション | 説明 |
|---|---|
--json | JSON出力 |
--plain | TSV出力 |
--max N | 最大N件 |
resourceName について
連絡先のIDは resourceName 形式:
people/c12345678901234567890
list や search の結果から取得できる。
典型ワークフロー
連絡先検索→情報取得
# 1. 検索
gog contacts search "田中" --json
# 2. 詳細取得
gog contacts get "people/c1234567890"新規連絡先作成
gog contacts create \
--name "新規顧客 株式会社ABC" \
--email "contact@abc-corp.com" \
--phone "03-1234-5678" \
--organization "株式会社ABC" \
--title "営業部長" \
--note "2026年2月商談開始"連絡先更新
# 電話番号変更
gog contacts update "people/c1234567890" --phone "080-新番号"注意事項
- resourceName: 操作には正確なresourceNameが必要
- 重複: 同名の連絡先は複数作成可能
- 同期: 変更は即時反映
- 削除: 完全削除（ゴミ箱なし）