Google Slides API を使用すると、プレゼンテーションのページに含まれる要素の追加や変更ができます。このページの例は、presentations.batchUpdate メソッドを使用して一般的な読み取りオペレーションを実行する方法を示しています。
サンプルで使用する変数は次のとおりです。
- PRESENTATION_ID - プレゼンテーション ID を指定する場所を示します。この ID の値はプレゼンテーションの URL で確認できます。
- PAGE_ID - ページ オブジェクト 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 つのリクエストが指定されており、1 つ目のリクエストで（指定のサイズ、位置に）テキストボックスの形状を作成し、その中に 2 つ目のリクエストでテキストを挿入しています。
最初のリクエストでは、テキスト ボックスに使用するオブジェクト ID を指定します。2 つ目のリクエストで、その ID を同じ 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 メソッドを使用して、シェイプタグの 1 つのインスタンスを画像で置き換え、画像のアスペクト比を維持しつつ、位置を変えずに画像がタグのサイズに収まるようにスケーリングする方法を示しています。
このリクエストによって、任意の画像を別の画像で置換することも可能です。このリクエストは、新しい画像を追加して、タグを削除するという処理で構成されます。
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
}
}
]
}