/gslides-parser - Google Slides パーサー

Google Slides プレゼンテーションの構造を GAS 経由でパースし、pptx-converter 互換のマッピング YAML を出力する。

前提条件

bash
# clasp は npx 経由で実行（インストール不要）
# Google アカウントでログイン
npx -y @google/clasp login

# Google Apps Script API を有効化
# https://script.google.com/home/usersettings

クイックスタート

bash
# 1. GAS プロジェクト初期設定（初回のみ）
python skills/gslides-parser/scripts/gslides_parser.py setup

# 2. GAS エディタで一度手動実行して権限を付与
npx @google/clasp open --cwd skills/gslides-parser/gas/

# 3. パース実行
python skills/gslides-parser/scripts/gslides_parser.py analyze \
  1ZVAI8Cjts1N44lYXgoCoZXfb0gz7BAx7A1A5-bhapvQ \
  -o output/slides/mapping.yaml

サブコマンド

| コマンド | 説明 | |---------|------| | setup | GAS プロジェクト初期設定（clasp create + push） | | analyze <id> | プレゼンテーションをパース → YAML 出力 | | json <id> | GAS パース結果の JSON だけ出力 |

オプション

analyze

| オプション | 説明 | デフォルト | |-----------|------|-----------| | -o, --output | 出力 YAML パス | output/slides/gslides_<id>_<timestamp>.yaml | | --no-gemini | Gemini セマンティック解析を無効化 | false | | --skip-push | clasp push をスキップ | false |

json

| オプション | 説明 | デフォルト | |-----------|------|-----------| | -o, --output | 出力 JSON パス | stdout | | --skip-push | clasp push をスキップ | false |

出力 YAML スキーマ（pptx-converter 互換）

yaml
source: "Google Slides: プレゼン名"
presentation_id: "1ZVAI8..."
presentation_url: "https://docs.google.com/presentation/d/1ZVAI8.../edit"
generated_at: "2026-02-10T12:00:00"
slide_width_pt: 720
slide_height_pt: 405

slides:
  - slide_number: 1
    object_id: "p6"
    layout: "TITLE"
    elements:
      - id: "g1234abcd"
        type: text
        role: title
        hint: "メインタイトル。"
        position: { left: 36, top: 150, width: 648, height: 80 }
        style: { font: "Noto Sans JP", size: 36, bold: true, color: "333333" }
        value: "タイトルテキスト"
        placeholder: "{{slide_1_title}}"

placeholders:
  - key: "{{slide_1_title}}"
    type: text
    role: title
    current: "タイトルテキスト"

処理フロー

[ユーザー] → python gslides_parser.py analyze <id>
                    │
        ┌───────────┴───────────┐
        │  1. clasp push        │  GAS コードを反映
        │     (gas/ → GAS)      │
        └───────────┬───────────┘
                    │
        ┌───────────┴───────────┐
        │  2. clasp run         │  parsePresentation() 実行
        │     parsePresentation │  → JSON 構造を返す
        └───────────┬───────────┘
                    │
        ┌───────────┴───────────┐
        │  3. gas_to_yaml.py    │  セマンティック解析
        │     JSON → YAML 変換  │  + プレースホルダー付与
        └───────────┬───────────┘
                    │
        ┌───────────┴───────────┐
        │  4. YAML 出力         │  pptx-converter 互換
        └───────────┘

GAS パーサーがパースする要素

| 要素タイプ | 抽出情報 | |-----------|---------| | Shape (テキスト) | テキスト、スタイル(font/size/bold/color)、プレースホルダー判定、塗りつぶし色 | | Image | ソースURL、コンテンツURL、リンク | | Table | 全セルテキスト、行列数、ヘッダー検出、セルスタイル | | Group | 子要素の再帰的パース | | SheetsChart | スプレッドシートID、チャートID | | Line | 線種、太さ、色 | | WordArt | レンダリングテキスト | | Video | ソース、URL、動画ID |

セマンティック解析

ヒューリスティックで以下のロールを自動判定:

• テキスト: title, subtitle, heading, body, caption, label, footnote, page_number, bullet_list
• 画像: hero_image, logo, icon, photo, decorative, background
• テーブル: data_table, comparison_table, schedule_table
• チャート: revenue_chart, trend_chart, comparison_chart
• シェイプ: accent_decoration, callout, divider, background_shape
• グループ: process_flow, feature_cards, step_diagram

トラブルシューティング

| エラー | 原因 | 対処法 | |--------|------|--------| | Not logged in | clasp 未ログイン | npx @google/clasp login | | Script API disabled | GAS API 無効 | GAS API 設定 で有効化 | | PERMISSION_DENIED | OAuth スコープ未承認 | GAS エディタで一度手動実行して権限付与 | | Function not found | push 未完了 | npx @google/clasp push --force | | タイムアウト | 大きなプレゼン | GAS エディタから直接実行 |

関連スキル

• gslides-creator: パース結果の YAML を使ってテンプレートから新スライドを作成
• pptx-converter: PPTX ファイルの同等機能（extract → build → convert）
• gas-clasp-ops: clasp プロジェクト管理