​

slides

orc slides は --target CONNECTION_ID でスライドの接続先を選びます。現在は Google Workspace 接続に対応しています。接続 ID は位置引数ではありません。

get は presentations.get の応答を返し、create は --title でプレゼンテーションを作成します。api get と api update は Discovery にある読み取りと書き込みのメソッドを呼び出します。batch-requests create は各オブジェクトに Request キーが一つだけあることを検証します。schemas list/get は接続なしでメソッド・Request 型・スキーマを調べます。

既存の接続に Slides スコープがなければ再接続してください。書き込みには manage モードが必要です。--readonly は書き込みを拒否し、--wrap-untrusted は外部のテキストを囲みます。タイムアウト後は、再送する前にプレゼンテーションを読み直して結果を確認してください。

exports get PRESENTATION_ID --format pdf|pptx --output FILE は PDF または PowerPoint を保存します（Drive export、上限 10 MB）。drive.file では、アプリで作成したファイルか Picker 等でアプリへのアクセスを許可したファイルだけを対象にできます。ユーザーが所有しているだけでは足りず、共有・再接続だけで既存ファイルへのアクセスが増えるわけではありません。対象外は share/reconnect を案内する CONFLICT を返します。制限付きの drive / drive.readonly スコープは追加しません。

thumbnails get PRESENTATION_ID PAGE_ID [--size SMALL|MEDIUM|LARGE] は content_url、width、height を返します。--output FILE を付けると CLI が PNG を保存します。URL は通常 30 分間有効で、URL を知る人は画像へアクセスできます。どちらも --readonly で利用できます。

create --markdown FILE は Slidev Markdown から新規作成し、update PRESENTATION_ID --markdown FILE は全スライドを置換します。FILE は UTF-8 ファイルのパス、または標準入力を読む - です。API の markdown フィールドには内容を直接渡します。先頭の frontmatter title をプレゼンテーション名に使い、--title だけでの作成も使えます。タイトル・本文・notes・hide を変換し、未対応の機能は安全なテキストに戻して 0 始まりの slide_index とともに report に返します。

get PRESENTATION_ID --format markdown [--output deck.md] は既存のスライドを Slidev Markdown に変換します。タイトル・本文・リスト・表・画像 URL・発表者ノート・hide を保持し、手作業で追加したテキストも位置順に読み込みます。API は { markdown, report } を返します。区別できないレイアウトの別名は cover / center 等に正規化します。図形・動画・チャート等の未対応要素と、有効期限のある contentUrl は report に記録します。画像は sourceUrl を優先します。

Get a presentation

Create a presentation

Get a presentation

Connection ID of the slides backend (currently a google-workspace connection); max 200 chars

型: string。必須。

Create a presentation

Path to a UTF-8 file, or - for stdin. Slidev Markdown content. CLI: path to a UTF-8 file, or - for stdin.; max 1000000 chars

型: string。任意。

(required) Connection ID of the slides backend (currently a google-workspace connection); max 200 chars

型: string。任意。

Body field: title; max 500 chars

型: string。任意。

Call a read-only Slides API method

(required) Read-only Discovery method ID, for example presentations.pages.get.; enum: presentations.get|presentations.pages.get|presentations.pages.getThumbnail

型: string。任意。

Path and query parameters by Discovery name, for example {"presentationId":"…","pageObjectId":"…"}. Run orc slides schemas get <method> for parameters.; (JSON object, e.g. '{"custom_id":"x"}')

型: string。任意。

(required) Connection ID of the slides backend (currently a google-workspace connection); max 200 chars

型: string。任意。

Call a mutating Slides API method

Request body in the Discovery request schema.; (JSON object, e.g. '{"custom_id":"x"}')

型: string。任意。

(required) Mutating Discovery method ID, for example presentations.batchUpdate.; enum: presentations.batchUpdate|presentations.create

型: string。任意。

Path and query parameters by Discovery name, for example {"presentationId":"…","pageObjectId":"…"}. Run orc slides schemas get <method> for parameters.; (JSON object, e.g. '{"custom_id":"x"}')

型: string。任意。

(required) Connection ID of the slides backend (currently a google-workspace connection); max 200 chars

型: string。任意。

Apply Slides batchUpdate requests

(required) batchUpdate requests, each with exactly one Request key, for example {"createSlide":{…}}. Run orc slides schemas list for types.; JSON array of objects (use --stdin for large resources)

型: string。任意。

(required) Connection ID of the slides backend (currently a google-workspace connection); max 200 chars

型: string。任意。

Slides WriteControl, for example {"requiredRevisionId":"…"}.; (JSON object, e.g. '{"custom_id":"x"}')

型: string。任意。

List Slides API methods and request types

Get a Slides API schema

Export a presentation

Connection ID of the slides backend (currently a google-workspace connection); max 200 chars

型: string。必須。

Get a slide thumbnail

Connection ID of the slides backend (currently a google-workspace connection); max 200 chars

型: string。必須。

Thumbnail width: SMALL 200px, MEDIUM 800px, LARGE 1600px. Google chooses the default when omitted.; enum: SMALL|MEDIUM|LARGE

型: string。任意。

Replace all slides from Slidev Markdown

(required) Path to a UTF-8 file, or - for stdin. Slidev Markdown content. CLI: path to a UTF-8 file, or - for stdin.; max 1000000 chars

型: string。任意。

(required) Connection ID of the slides backend (currently a google-workspace connection); max 200 chars

型: string。任意。

Inspect a method schema

Read a page

Apply batch requests

Export PDF

Export PowerPoint

Save a slide thumbnail

Create from Markdown

Replace all slides from stdin

Read as Slidev Markdown

Markdown の --dry-run は API に dry_run: true を送り、Google への書き込みを行いません。create は Google を呼ばず、update は現在のスライド ID と revision を読み取ります。応答は presentation_id（create は null）、slide_count、requests（Phase 1）、notes（slide_object_id と text）、report を含み、update は write_control.requiredRevisionId も返します。notes の object ID は作成後に決まるため、notes はリクエストではありません。実行時は Phase 1 でスライドを更新し、notes がある場合だけ GET と revision 付きの Phase 2 で全 notes を書き込みます。notes の失敗時はスライドの書き込み済みを示すエラーを返します。update を再実行して置換・再試行できます。

箇条書き・番号付きリストはネストを含む native bullet に変換します。トップレベルのリストごとに一つの preset を使います。ネストの種類が混在する場合は最上位のスタイルを適用し、lists report に記録します。表は編集可能な table とし、先頭行を太字にします。太字・斜体・inline code（Courier New）・リンクをテキストスタイルにし、範囲は UTF-16 で計算します。Markdown 画像と frontmatter image: は絶対 HTTPS URL を受け付けます。Google が画像を取得し、Orchestor は取得・アップロードしません。background: はページ全体に引き伸ばす画像です。相対パス・data:・HTTP は report に返し、他の内容は変換します。Mermaid・KaTeX・code block・v-click・component・未知の option は report に残ります。通常の code block は編集可能な等幅文字列です。

画像の配置は 16:9（9,144,000 × 5,143,500 EMU）を基準とします。本文や列に文字列・表・Markdown 画像が混在する場合は縦に並べ、必要に応じて本文 placeholder をサイズ指定した native 要素に置換します。HTTPS 画像は Google がアクセスできる必要があります。createImage は縦横比を維持し、背景画像は引き伸ばします。

Workspace と connector:backend-execute が必要です。schemas は接続を必要としません。

orc slides では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。