Google Sheets API を使用すると、スライドの作成、移動、削除を行うことができます。スライドにある例では、
このページでは、一般的なスライドの操作について説明します。
presentations.batchUpdate
メソッドを呼び出します。
これらの例では、次の変数を使用します。
- PRESENTATION_ID - リソースに プレゼンテーション ID。Google Chat では プレゼンテーションの URL からこの ID の値を検出します。
- PAGE_ID および PAGE_ID2 - そのページ オブジェクト ID。必要に応じて この値を取得するには、URL から、または API 読み取りリクエストを使用します。
これらの例では、言語に依存しない HTTP リクエストとして記載しています。学習内容 Google API を使用してさまざまな言語でバッチ アップデートを実装する方法 次のガイドをご覧ください。 スライドおよび図形の追加と text。
スライドをコピーする
次の
presentations.batchUpdate
コードサンプルを使用して、Terraform で
DuplicateObjectRequest
メソッドを使用して、スライドのコピーを作成し、プレゼンテーションの元のスライドの後に挿入します。
元のスライドは PAGE_ID で指定します。
このリクエストでは、ページ要素 ID の一部またはすべてを コピー(一部 制限など)。 この例では、元のスライドにテーブル要素( TABLE_ELEMENT_ID など)を使用して、新しいテーブル( COPY_TABLE_ELEMENT_ID)を表示します( COPY_PAGE_ID)。コピーのその他の要素はすべて、ランダムに あります。
ファイルのコピーについて詳しくは、
PageElement
テキスト ボックス、画像、表、基本的な図形、線、埋め込み動画など、
サンプル「画像のコピーと編集を
要素をご覧ください。
スライドをコピーするリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "duplicateObject": { "objectId": PAGE_ID, "objectIds": { "PAGE_ID": "COPY_PAGE_ID", "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID" } } } ] }
スライドを作成する
次の
presentations.batchUpdate
コードサンプルを使用して、Terraform で
CreateSlideRequest
メソッドを使ってスライドを作成し、4 番目のスライドとして挿入します(ゼロベースの
insertionIndex
)が含まれています。
新しいスライドでは、
PredefinedLayout
/TITLE_AND_TWO_COLUMNS
。イベントタイプとして使用する文字列を
スライドの PAGE_ID(一部
制限)、
または、フィールドを省略して API で PAGE_ID を生成できるようにします。
含まれます。
スライドを作成するためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": "PAGE_ID", "insertionIndex": 3, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" } } } ] }
スライドを作成してプレースホルダを変更する
次の
presentations.batchUpdate
コードサンプルを使用して、Terraform で
CreateSlideRequest
メソッドを使用し、
PredefinedLayout
/TITLE_AND_TWO_COLUMNS
。
スライドの PAGE_ID として使用する文字列を指定できます
(一部の
制限)。
「
placeholderIdMappings
使用
Type
/
TITLE
。TITLE_ID はスライドのプレースホルダのシェイプを参照します。
変更できるようにします。
スライドを作成してプレースホルダを変更するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": PAGE_ID, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" }, "placeholderIdMappings": [ { "layoutPlaceholder": { "type": "TITLE", "index": 0 }, "objectId": TITLE_ID, }, ], } }, { "insertText": { "objectId": TITLE_ID, "text": "This is my slide title", } }, ] }
スライドを新しい位置に移動
次の
presentations.batchUpdate
コードサンプルを使用して、Terraform で
UpdateSlidesPositionRequest
メソッドを使って、指定された 2 つのスライドを
相対的な順序を維持します。
指定されたスライド ID(PAGE_ID と PAGE_ID2)
重複しない形で、既存の表示順に指定する必要があります。「
ゼロベースの insertionIndex
は、スライドの挿入位置を示します(
必要があります。値は 0 ~
プレゼンテーションのスライド数を含めます。
スライドを新しい位置に移動するためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateSlidesPosition": { "slideObjectIds": [ PAGE_ID, PAGE_ID2 ], "insertionIndex": 0 } } ] }
スライドの背景画像を設定する
次の
presentations.batchUpdate
コードサンプルを使用して、Terraform で
UpdatePagePropertiesRequest
メソッドで、指定したスライドの背景画像を設定するために
PAGE_ID。この API は、
IMAGE_URL。
フィールド マスクを使用して、 他のプロパティが維持されるように、スライドの背景を変更する必要があります。フィールドを使用 パフォーマンスも向上します
または、UpdatePagePropertiesRequest
メソッドを使用して、
背景を無地に変更できます。
スライドの背景画像を設定するためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageProperties": { "objectId": PAGE_ID, "pageProperties": { "pageBackgroundFill": { "stretchedPictureFill": { "contentUrl": IMAGE_URL } } }, "fields": "pageBackgroundFill" } } ] }
サムネイルを生成
特定のページの最新バージョンのサムネイルを
プレゼンテーションの
presentations.pages.getThumbnail
メソッドを呼び出し、ページのサムネイル画像をコンテンツ URL として返します。イメージ
URL のデフォルトの有効期間は 30 分です。
次のように、返された mimeType
と thumbnailSize
を指定することもできます。
ThumbnailProperties
フィールドをクエリ パラメータとして渡します。
URL とともにページのサムネイルを生成するリクエスト プロトコルは次のとおりです。
ThumbnailProperties
セット:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{ "width": 800, "height": 450, "contentUrl": "CONTENT_URL" }