GoogleSlide API を使用すると、テキスト ボックス、画像、表、基本的な図形、線、埋め込み動画などの PageElement リソースを作成および編集できます。このページの例では、presentations.batchUpdate メソッドを使用した一般的なページ要素オペレーションの一部を示しています。
これらの例では、次の変数を使用します。
- PRESENTATION_ID - プレゼンテーション ID を指定する場所を示します。この ID の値はプレゼンテーションの URL から取得できます。
- PAGE_ID - ページ オブジェクト ID を指定する場所を示します。この値は、URL から、または API 読み取りリクエストを使用して取得できます。
- PAGE_ELEMENT_ID - ページ要素オブジェクト ID を指定する場所を示します。作成する要素にこの ID を指定するか（いくつかの制限があります）、Slides API で自動的に ID を作成することもできます。要素 ID は、API 読み取りリクエストで取得できます。
これらの例は、言語に依存しない HTTP リクエストとして表示されます。Google API クライアント ライブラリを使用してさまざまな言語でバッチ アップデートを実装する方法については、次のガイドをご覧ください。
テキスト ボックスに箇条書きを追加する
次の presentations.batchUpdate コードサンプルは、InsertTextRequest メソッドを使用して、PAGE_ELEMENT_ID で指定された空のテキスト ボックスにテキストを挿入する方法を示しています。次に、サンプルでは CreateParagraphBulletsRequest メソッドを使用して、テキスト ボックスのすべてのテキストを箇条書きリストに変換します。リスト内のアイテムは \n 文字で区切られ、インデントは \t 文字で制御されます。
プレゼンテーションを作成するためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"insertText": {
"objectId": PAGE_ELEMENT_ID,
"text": "My List\n\tItem 1\n\t\tItem 2\n\t\t\tItem 3",
"insertionIndex": 0
},
"createParagraphBullets": {
"objectId": PAGE_ELEMENT_ID,
"bulletPreset": "BULLET_ARROW_DIAMOND_DISC",
"textRange": {
"type": "ALL"
}
}
}
]
}
このリクエストは、次のような箇条書きを作成します。
スライドに図形を追加する
次の presentations.batchUpdate コードサンプルは、CreateShapeRequest メソッドを使用して、PAGE_ID で指定されたスライドに波形を追加する方法を示しています。このリクエストでは、シェイプのタイプを指定して、スライド内でシェイプのサイズ調整と配置を行います。次に、InsertTextRequest メソッドを使用して、そのシェイプにテキストを追加します。このリクエストでは、行の ID を PAGE_ELEMENT_ID に設定します。
スライドにシェイプを追加するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createShape": {
"objectId": PAGE_ELEMENT_ID,
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 3000000,
"unit": "EMU"
},
"height": {
"magnitude": 3000000,
"unit": "EMU"
}
},
"transform": {
"scaleX": 0.6807,
"scaleY": 0.4585,
"translateX": 6583050,
"translateY": 1673950,
"unit": "EMU"
}
},
"shapeType": "WAVE"
}
},
{
"insertText": {
"objectId": PAGE_ELEMENT_ID,
"text": "My Wave Shape",
"insertionIndex": 0
}
}
]
}
スライドに動画を追加する
次の presentations.batchUpdate コードサンプルは、CreateVideoRequest メソッドを使用して、PAGE_ID で指定されたスライドに動画を埋め込む方法を示しています。このリクエストでは、スライド内の動画のスケーリングと配置を行い、動画の ID を PAGE_ELEMENT_ID に設定します。ソース動画の一意の識別子は VIDEO_ID に設定されています。たとえば、https://www.youtube.com/watch?v=7U3axjORYZ0 の YouTube 動画の ID は 7U3axjORYZ0 です。
スライドに動画を追加するためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createVideo": {
"objectId": PAGE_ELEMENT_ID,
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 12000,
"unit": "EMU"
},
"height": {
"magnitude": 9000,
"unit": "EMU"
}
},
"transform": {
"scaleX": 381,
"scaleY": 381,
"translateX": 152400,
"translateY": 152400,
"unit": "EMU"
}
},
"source": "YOUTUBE",
"id": VIDEO_ID
}
}
]
}
要素をコピーして編集する
次の presentations.batchUpdate コードサンプルは、DuplicateObjectRequest メソッドを使用して既存のシェイプ（PAGE_ELEMENT_ID で指定）を取得し、コピー（COPY_ELEMENT_ID で指定）を行う方法を示しています。
後続のリクエストでは、複製されたオブジェクトに次の変更を行います。
- 背景色を
LIGHT2テーマの色に設定します。 - コピーを（元のシェイプの位置から）ページの下に移動します。
- テキストのフォントを 18 pt ジョージア（ジョージア）に設定します。
- テキストを編集して「My Shape Copy」と読み上げます。
下記のリクエストでは、フィールド マスクを使用して、変更されないシェイプ プロパティ（枠線のスタイルなど）を保持しています。フィールド マスクを使用すると、パフォーマンスも向上します。
スライドのコピーについて詳しくは、スライドをコピーするのサンプルをご覧ください。
要素をコピーして編集するためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"duplicateObject": {
"objectId": PAGE_ELEMENT_ID,
"objectIds": {
PAGE_ELEMENT_ID: COPY_ELEMENT_ID
}
}
},
{
"updateShapeProperties": {
"objectId": COPY_ELEMENT_ID,
"fields": "shapeBackgroundFill.solidFill.color",
"shapeProperties": {
"shapeBackgroundFill": {
"solidFill": {
"color": {
"themeColor": "LIGHT2"
}
}
}
}
}
},
{
"updatePageElementTransform": {
"objectId": COPY_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 0,
"translateY": 1250000,
"unit": "EMU"
}
}
},
{
"updateTextStyle": {
"objectId": COPY_ELEMENT_ID,
"fields": "fontFamily,fontSize",
"textRange": {
"type": "ALL"
},
"style": {
"fontFamily": "Georgia",
"fontSize": {
"magnitude": 18,
"unit": "PT"
}
}
}
},
{
"deleteText": {
"objectId": COPY_ELEMENT_ID,
"textRange": {
"type": "ALL"
}
}
},
{
"insertText": {
"objectId": COPY_ELEMENT_ID,
"text": "My Shape Copy",
"insertionIndex": 0
}
}
]
}
更新後のシェイプとそのコピーは次のようになります。
画像または動画の概要を編集する
次の presentations.batchUpdate コードサンプルは、UpdateImagePropertiesRequest メソッドを使用して、IMAGE_ELEMENT_ID で指定された画像の枠線の外観を更新する方法を示しています。また、UpdateVideoPropertiesRequest メソッドを使用して、VIDEO_ELEMENT_ID で指定された埋め込み動画の枠線の外観を更新します。
リクエストにより、オブジェクトに次の変更が行われます。
- 画像の枠線の色を、部分的な透明度を持つ
ACCENT5テーマカラーに設定します。 - 動画の枠線の色を、透明度のない
ACCENT1テーマカラーに設定します。 - どちらの枠線の太さも 3 pt に設定します。
- 画像の枠線のスタイルを
SOLIDに設定します。 - 動画の枠線のスタイルを
DASH_DOTに設定します。
UpdateImagePropertiesRequest メソッドと UpdateVideoPropertiesRequest メソッドのどちらでも、画像と動画の枠線の外観のみを変更できます。その他のプロパティはすべて読み取り専用です。ここに示すリクエストでは、フィールド マスクを使用して、今後の API の変更からコードを保護するために、枠線のみを変更する必要があることを指定します。フィールド マスクを使用すると、パフォーマンスも向上します。
以下は、画像または動画の概要を編集するためのリクエスト プロトコルです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateImageProperties": {
"objectId": IMAGE_ELEMENT_ID,
"fields": "outline",
"imageProperties": {
"outline": {
"dashStyle": "SOLID",
"outlineFill": {
"solidFill": {
"alpha": 0.8,
"color": {
"themeColor": "ACCENT5"
}
}
},
"weight": {
"magnitude": 3,
"unit": "PT"
}
}
}
}
},
{
"updateVideoProperties": {
"objectId": VIDEO_ELEMENT_ID,
"fields": "outline",
"videoProperties": {
"outline": {
"dashStyle": "DASH_DOT",
"outlineFill": {
"solidFill": {
"alpha": 0.8,
"color": {
"themeColor": "ACCENT1"
}
}
},
"weight": {
"magnitude": 3,
"unit": "PT"
}
}
}
}
}
]
}
今回の変更により、画像と埋め込み動画は以下のようになります。
シェイプの枠線を編集する
次の presentations.batchUpdate コードサンプルは、UpdateShapePropertiesRequest メソッドを使用して既存のシェイプ（PAGE_ELEMENT_ID で指定）を取得し、その枠線の外観を更新する方法を示しています。
リクエストにより、オブジェクトに次の変更が行われます。
- 枠線の色を、部分的な透明度を持つ
ACCENT5テーマの色に設定します。 - 枠線の太さを 3 pt に設定します。
- 枠線のスタイルを
LONG_DASHに設定します。
ここに示すリクエストでは、フィールド マスクを使用して、変更されないシェイプ プロパティ（シェイプの塗りつぶしの色など）を保持しています。フィールド マスクを使用すると、パフォーマンスも向上します。
以下は、シェイプの輪郭を編集するためのリクエスト プロトコルです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateShapeProperties": {
"objectId": PAGE_ELEMENT_ID,
"fields": "outline",
"shapeProperties": {
"outline": {
"dashStyle": "LONG_DASH",
"outlineFill": {
"solidFill": {
"alpha": 0.6,
"color": {
"themeColor": "ACCENT5"
}
}
},
"weight": {
"magnitude": 3,
"unit": "PT"
}
}
}
}
}
]
}
更新後のシェイプは以下のようになります。
図形やテキスト ボックスのテキストの書式を設定する
次の presentations.batchUpdate コードサンプルは、UpdateTextStyleRequest メソッドを使用して既存のシェイプ（PAGE_ELEMENT_ID で指定）を取得し、テキストの外観を更新する方法を示しています。
リクエストにより、オブジェクトに次の変更が行われます。
- テキストの色を
ACCENT5テーマの色に設定します。 - フォントを太字、斜体（18 pt の Corsiva）に設定します。
- テキストに下線が引かれます。
ここに示すリクエストでは、フィールド マスクを使用して、変更されないテキスト スタイルのプロパティ（背景色、リンク、ベースライン オフセットなど）を保持します。フィールド マスクを使用すると、パフォーマンスも向上します。
シェイプまたはテキスト ボックスのテキストを書式設定するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateTextStyle": {
"objectId": PAGE_ELEMENT_ID,
"fields": "foregroundColor,bold,italic,fontFamily,fontSize,underline",
"style": {
"foregroundColor": {
"opaqueColor": {
"themeColor": "ACCENT5"
}
},
"bold": true,
"italic": true,
"underline": true,
"fontFamily": "Corsiva",
"fontSize": {
"magnitude": 18,
"unit": "PT"
}
},
"textRange": {
"type": "ALL"
}
}
}
]
}
更新後のシェイプ テキストは次のようになります。
Google スプレッドシートからグラフをインポートする
次の presentations.batchUpdate コードサンプルは、CreateSheetsChartRequest メソッドを使用してシートからグラフをインポートし、PAGE_ID で指定されたスライド上に配置する方法を示しています。
このリクエストには、スプレッドシート ID（SPREADSHEET_ID で指定）とスプレッドシートのグラフ ID（SPREADSHEET_CHART_ID で指定）が必要です。スライド プレゼンテーション内のグラフ ID は、PRESENTATION_CHART_ID で指定されます。
また、このリクエストでは、スライドのグラフの LinkingMode を LINKED に設定し、ソース スプレッドシートのグラフが更新された場合に、埋め込まれたグラフを更新できるようにします。
スプレッドシートからグラフをインポートするリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSheetsChart": {
"objectId": PRESENTATION_CHART_ID,
"spreadsheetId": SPREADSHEET_ID,
"chartId": SPREADSHEET_CHART_ID,
"linkingMode": "LINKED",
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 4000000,
"unit": "EMU"
},
"height": {
"magnitude": 4000000,
"unit": "EMU"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 100000,
"translateY": 100000,
"unit": "EMU"
}
}
}
]
}
スプレッドシートからグラフを更新する
次の presentations.batchUpdate コードサンプルは、RefreshSheetsChartRequest メソッドを使用してプレゼンテーション内のリンクされたグラフを更新し、スプレッドシートのソーススプレッドシートにあるそのグラフの最新バージョンに置き換える方法を示しています。このリクエストでは、スライド プレゼンテーション内のグラフ ID（PRESENTATION_CHART_ID で指定）が必要です。
スプレッドシートからグラフを更新するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"refreshSheetsChart": {
"objectId": PRESENTATION_CHART_ID
}
}
]
}