Google Slides API を使用すると、プレゼンテーション ページの要素を追加、変更できます。このページの例では、presentations.batchUpdate メソッドを使用して一般的な読み取りオペレーションを実行する方法を示します。
これらの例では、次の変数を使用します。
- PRESENTATION_ID - プレゼンテーション ID を指定する場所を示します。この ID の値は、プレゼンテーションの URL から確認できます。
- PAGE_ID - ページ オブジェクト ID を指定する場所を示します。この値は、URL から取得することも、API 読み取りリクエストを使用して取得することもできます。
- PAGE_ELEMENT_ID - ページ要素オブジェクト ID を指定する場所を示します。作成する要素にこの ID を指定することも（一部の制限あり）、Slides API に自動的に作成させることもできます。要素 ID は、API 読み取りリクエストで取得できます。
これらの例は、言語に依存しない HTTP リクエストとして示されています。Google API クライアント ライブラリを使用して、さまざまな言語でバッチ更新を実装する方法については、シェイプとテキストを追加するをご覧ください。
スライドにテキスト ボックスを追加する
次の presentations.batchUpdate コードサンプルは、CreateShapeRequest メソッドを使用して、PAGE_ID で指定されたスライドに新しいテキスト ボックス（「My Added Text Box」という文字列を含む）を追加する方法を示しています。リクエスト本文には、テキスト ボックスの形状（サイズと位置を指定して）を作成するリクエストと、テキストを挿入するリクエストの 2 つのリクエストが指定されます。
最初のリクエストでは、テキスト ボックスに使用するオブジェクト ID を指定します。これにより、2 番目のリクエストが同じ API 呼び出しでそれを使用できるようになり、オーバーヘッドが削減されます。
スライドにテキスト ボックスを追加するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createShape": {
"objectId": PAGE_ELEMENT_ID,
"shapeType": "TEXT_BOX",
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 150,
"unit": "PT"
},
"height": {
"magnitude": 50,
"unit": "PT"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 200,
"translateY": 100,
"unit": "PT"
}
}
}
},
{
"insertText": {
"objectId": PAGE_ELEMENT_ID,
"text": "My Added Text Box",
"insertionIndex": 0
}
}
]
}スライドに画像を追加する
次の presentations.batchUpdate コードサンプルは、CreateImageRequest メソッドを使用して、PAGE_ID で指定されたスライドに画像を追加する方法を示しています。API は IMAGE_URL を使用して画像を取得します。このリクエストでは、画像のサイズ変更とスライドへの配置も行われます。
スライドに画像を追加するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createImage": {
"url": IMAGE_URL,
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 30,
"unit": "PT"
},
"height": {
"magnitude": 30,
"unit": "PT"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 200,
"translateY": 100,
"unit": "PT"
}
}
}
}
]
}ページまたはページ要素を削除する
次の presentations.batchUpdate コードサンプルは、DeleteObjectRequest メソッドを使用して、2 つの個別のリクエストで PAGE_ELEMENT_ID で指定されたページ要素と PAGE_ID で指定されたスライドを削除する方法を示しています。
ページまたはページ要素を削除するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"deleteObject": {
"objectId": PAGE_ELEMENT_ID
},
"deleteObject": {
"objectId": PAGE_ID
}
}
]
}指定した形状のテキストを編集する
次の presentations.batchUpdate コードサンプルは、DeleteTextRequest メソッドを使用して、PAGE_ELEMENT_ID で指定されたシェイプ内のテキストの一部を置き換える方法を示しています。これを行うには、まずゼロベースの startIndex を使用してテキストを削除してから、その位置に新しいテキストを挿入します。この例では、元のテキスト文字列「My Shape Text: ????」が「My Shape Text: Trapezoid」に置き換えられています。
このリクエストは、指定された形状のテキストにのみ影響します。プレゼンテーション内のすべてのテキストを置き換えるには、ReplaceAllTextRequest メソッドを使用します。
指定されたシェイプのテキストを編集するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteText": { "objectId": PAGE_ELEMENT_ID, "textRange": { "type": "FROM_START_INDEX", "startIndex": 15 } } }, { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "Trapezoid", "insertionIndex": 15 } } ] }
図形タグを画像に置き換える
タグは、一意の文字列名（「account-holder-name」など）を持つテキスト ボックスまたはシェイプです。
次の presentations.batchUpdate コードサンプルは、CreateImageRequest メソッドを使用して、シェイプタグの単一インスタンスを画像に置き換え、同じ位置を維持し、画像のアスペクト比を維持しながらタグのサイズに合わせてスケーリングする方法を示しています。
このリクエストを使用して、ある画像を別の画像に置き換えることもできます。このリクエストは、新しいイメージを追加してからタグを削除するものです。
CreateImageRequest メソッドは、指定したシェイプのみを置き換えます。プレゼンテーション内のすべてのタグシェイプを置き換えるには、ReplaceAllShapesWithImageRequest メソッドを使用します。
シェイプタグには、次の PageElement プロパティがあります（presentations.pages.get リクエストを使用して確認できます）。
{
"objectId": PAGE_ELEMENT_ID,
"size": {
"width": {
"magnitude": 3000000,
"unit": "EMU"
},
"height": {
"magnitude": 3000000,
"unit": "EMU"
}
},
"transform": {
"scaleX": 1.13,
"scaleY": 0.62,
"translateX": 4800000,
"translateY": 450000,
"unit": "EMU"
},
"shape": {
"shapeType": "RECTANGLE"
}
}シェイプは、PAGE_ID で指定されたスライド上に配置されます。シェイプに代わる画像を指定するため、API は IMAGE_URL を使用して画像を取得します。画像のアスペクト比を維持しながらタグのサイズに制限するには、CreateImageRequest メソッドで、画像サイズをタグのサイズとスケールの積に設定し、画像のスケール ファクタを 1 に設定します。詳細については、アスペクト比を保持するをご覧ください。
シェイプタグを画像に置き換えるリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createImage": {
"url": IMAGE_URL,
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 3000000 * 1.13,
"unit": "EMU"
},
"height": {
"magnitude": 3000000 * 0.62,
"unit": "EMU"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 4800000,
"translateY": 450000,
"unit": "PT"
}
}
}
},
{
"deleteObject": {
"objectId": PAGE_ELEMENT_ID
}
}
]
}