/gslides-parser - Google Slides パーサー

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

前提条件

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

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

クイックスタート

# 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 互換）

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 プロジェクト管理