Google スライド API を使用すると、Google スライド プレゼンテーションを作成、変更できます。
アプリを Google Sheets API と統合して美しいスライド資料を作成可能 自動的に検出されます。たとえば、 データベースから顧客情報を使用し、事前に設計した プレゼンテーション作成用のテンプレートと選択した構成オプション 手動で作成するよりもわずかな時間で済みます。
API の概要
presentations コレクションには、 メソッドを使用すると、プレゼンテーション内の要素を取得、更新できます。
スライド API での作業のほとんどは、作成と更新が 説明します。これを行うには、 batchUpdate メソッド。 このメソッドは、 リクエスト オブジェクトを使用して、次のことができます。
- スライドを作成
- 図形や表などの要素をスライドに追加する
- テキストを挿入、変更、削除する
- 要素に変換を適用する
- スライドの順序を変更する
詳細については、バッチ アップデートをご覧ください。スタートガイドを見る をご覧ください。
プレゼンテーションの構造
スライド API のプレゼンテーションは複数のページで構成され、その中にページ あります。
プレゼンテーションの ID は次の URL から取得できます。
https://docs.google.com/presentation/d/presentationId/edit
プレゼンテーション ID は、文字、数字、 あります。次の正規表現を使用して、 Google スプレッドシートの URL からプレゼンテーション ID を取得する:
/presentation/d/([a-zA-Z0-9-_]+)
Drive API を使い慣れている場合は、presentationId
が
ファイルの ID
リソースです。
ページとページ要素はオブジェクト ID で識別されます。
ページ
Google スライドには次のようなページがあります。
修士号 | スライド マスターでデフォルトのテキスト スタイル、背景、ページを定義 すべてのスライドに共通する要素です。ページ すべてのスライドに表示する必要のある要素は、マスターに追加してください。ほとんど プレゼンテーションにはマスターが 1 つしかありませんが、複数のマスターやマスターがない場合もあります。 |
レイアウト | レイアウトは、ページ要素の配置に関するテンプレートの役割を果たします。 設定することもできます。各レイアウトは 1 つの あります。 |
スライド | このページには、オーディエンスに提示しているコンテンツが含まれています。 ほとんどのスライドはマスターとレイアウトに基づいています。どの Pod が 作成の際に使用するレイアウトを指定します。 |
注 | これらのページには、 スライドのスピーカー ノートを含む図形を作成できます。各スライドに 1 つずつ 対応するメモページで行いますスピーカー ノートのシェイプに含まれるテキストのみを スライド API で変更しました。 |
メモマスター | メモマスターは、すべてのアプリケーションに適用されるデフォルトのテキスト スタイルとページ要素を定義します。 できます。Sheets API では、メモ マスターは読み取り専用です。 |
ページ要素
ページ要素は、ページに配置される視覚的コンポーネントです。API では、数種類のページ要素が公開されています。
グループ | 個別のユニットとして扱われるページ要素のセット。ユーザーは、 まとめて移動、スケーリング、回転できます。 |
図形 | 長方形、省略記号、テキスト ボックスなどの単純な視覚的オブジェクト。 シェイプにはテキストを含めることができるため、作成すべき最も一般的なページ要素です。 説明します。 |
画像 | スライドにインポートされた画像。 |
動画 | スライドにインポートされた動画。 |
線 | 視覚的な線、曲線、コネクタ |
表 | コンテンツのグリッド。 |
WordArt | シェイプのように動作する視覚的なテキスト要素。 |
SheetsChart | Google スプレッドシートからスライドにインポートされたグラフ。 |
バッチ アップデート
batchUpdate メソッド を使用すると、プレゼンテーションのさまざまな側面を更新できます。変更は 1 つにまとめて 1 つのリクエストが失敗した場合、他のリクエストには依存しないように 記録されます。
batchUpdate
メソッドは、1 つ以上の
リクエスト
各オブジェクトは、実行するリクエストの種類を 1 つ指定します。他にも
多種多様なリクエストに対応できます。これがリクエストの種類の内訳です
さまざまなカテゴリに分類されています
batchUpdate
メソッドはレスポンスの本文を返します。
これには
レスポンス
表示されます。各レスポンスは、対応するレスポンスと同じインデックスを占有します。
request該当するレスポンスがないリクエストについては、そのインデックスのレスポンスが
は空になります。通常、さまざまな Create
リクエストにはレスポンスがあるため、
新しく追加されたオブジェクトの ID がわかっている必要があります。
オブジェクト ID の操作
スライド API のプレゼンテーションは、ページとページ要素で構成されます。 これらのオブジェクトには、オブジェクト内で一意のオブジェクト ID 文字列が含まれます。 説明します。
作成時にオブジェクト ID を指定する
batchUpdate メソッドを使用して 必要に応じて、新しいオブジェクトのオブジェクト ID を指定できます。これにより 同じ batchUpdate リクエスト内で修正できるため、 呼び出しの回数を減らし、割り当て使用量を削減します。
ほとんどの場合、ランダムなオブジェクト ID を生成することをおすすめします。たとえば、
Java を使用している場合、java.util.UUID.randomUUID().toString()
は正常に動作するはずです。
アプリケーションで、長期間にわたってオブジェクトを追跡する場合 オブジェクト ID は変更される可能性があるため、依存しないでください。以下をご覧ください。 セクションをご覧ください。
オブジェクト ID を使用せずにオブジェクトを追跡する
スライド API でリクエストを行う際、オブジェクト ID は通常保持されます。(任意の 例外については、メソッドのリファレンス ドキュメントで説明されています)。目標を プレゼンテーション全体のコピーを作成する場合、オブジェクト ID も保持されます。
ただし、プレゼンテーション後にオブジェクト ID が変更されていないことを前提にすることはできません。 変更することもできます。たとえば、他のユーザーが Google スライドの ページ要素をコピーして貼り付けた後、元のページ要素を削除する UI 新しい一意の ID と、以前 API で指定した ID が追加されます。 失われます。そのため、オブジェクト ID をストレージ クラスに保存することは 自動的にスケールします。プレゼンテーション内のオブジェクトを見つけるには、 テキスト コンテンツまたは代替テキストです。
新規に作成したプレゼンテーションでは、通常、デフォルトとして一貫した ID のセットが使用される テキスト ボックスが含まれています。これらの ID は今後変更される可能性があり、 そのため、この機能に依存することはおすすめしません。代わりに、画像内の要素を見つける プレゼンテーション オブジェクトを使って create() または get().