GoogleSlide API を使用すると、ページ上の表を作成、編集できます。このページの例では、presentations.batchUpdate
メソッドを使用した一般的なテーブル オペレーションをいくつか示しています。
これらの例では、次の変数を使用します。
- PRESENTATION_ID - プレゼンテーション ID を指定する場所を示します。この ID の値はプレゼンテーションの URL から確認できます。
- PAGE_ID - ページ オブジェクト ID を指定する場所を示します。この値は、URL から、または API 読み取りリクエストを使用して取得できます。
- TABLE_ID - 作業中のテーブルのページ要素オブジェクト ID を指定する場所を示します。作成する要素にこの ID を指定するか(いくつかの制限があります)、Slides API で自動的に ID を作成することもできます。要素 ID は、API 読み取りリクエストで取得できます。
これらの例は、言語に依存しない HTTP リクエストとして表示されます。Google API クライアント ライブラリを使用してさまざまな言語でバッチ アップデートを実装する方法については、シェイプとテキストを追加するをご覧ください。
テーブルを作成する
次の presentations.batchUpdate
コードサンプルは、CreateTableRequest
メソッドを使用して、PAGE_ID で指定されたスライドにテーブルを追加する方法を示しています。
この表には 8 行 5 列があります。なお、Slides API では、elementProperties
の一部として指定された size
または transform
フィールドは無視されます。代わりに、API は、指定された行数と列数(可能な場合)に対応できるサイズで、スライドのほぼ中央に配置されたテーブルを作成します。
テーブルを作成するためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createTable": { "objectId": TABLE_ID, "elementProperties": { "pageObjectId": PAGE_ID, }, "rows": 8, "columns": 5 } } ] }
表の行または列を削除
次の presentations.batchUpdate
コードサンプルは、DeleteTableRowRequest
メソッドを使用して 6 番目の行を削除する方法を示しています。次に、DeleteTableColumnRequest
メソッドを使用して 4 番目の列を削除します。テーブルは TABLE_ID で指定されます。cellLocation
内の rowIndex
と columnIndex
はどちらもゼロベースです。
テーブルの行または列を削除するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteTableRow": { "tableObjectId": TABLE_ID, "cellLocation": { "rowIndex": 5 } } }, { "deleteTableColumn": { "tableObjectId": TABLE_ID, "cellLocation": { "columnIndex": 3 } } } ] }
テーブルのデータを編集
次の presentations.batchUpdate
コードサンプルは、DeleteTextRequest
メソッドを使用して textRange
内のセル内のすべてのテキストを削除する方法を示しています。次に、InsertTextRequest
メソッドを使用して「Kangaroo」という新しいテキストに置き換えます。
テーブルは TABLE_ID で指定されます。影響を受けるセルは 5 行目と 3 列目にあります。cellLocation
内の rowIndex
と columnIndex
はどちらもゼロベースです。
テーブルデータを編集するためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteText": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 4, "columnIndex": 2 }, "textRange": { "type": "ALL", } } }, { "insertText": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 4, "columnIndex": 2 }, "text": "Kangaroo", "insertionIndex": 0 } } ] }
表の見出し行の書式を設定
次の presentations.batchUpdate
コードサンプルは、UpdateTableCellPropertiesRequest
メソッドを使用して、TABLE_ID で指定された tableRange
内のテーブル要素のヘッダー行をフォーマットする方法を示しています。次に、TableCellProperties
メソッドを使用して、ヘッダー行の背景色を黒に設定します。
以下の各リクエストでは、UpdateTextStyleRequest
メソッドを使用して、ヘッダー行の 1 つのセルのテキスト形式を textRange
内の太字、白色 18 pt のカンブリア フォントに設定します。次に、ヘッダー内の追加のセルごとにこのリクエストを繰り返す必要があります。
location
と cellLocation
内の rowIndex
と columnIndex
はどちらもゼロベースです。
テーブルのヘッダー行をフォーマットするためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateTableCellProperties": { "objectId": TABLE_ID, "tableRange": { "location": { "rowIndex": 0, "columnIndex": 0 }, "rowSpan": 1, "columnSpan": 3 }, "tableCellProperties": { "tableCellBackgroundFill": { "solidFill": { "color": { "rgbColor": { "red": 0.0, "green": 0.0, "blue": 0.0 } } } } }, "fields": "tableCellBackgroundFill.solidFill.color" } }, { "updateTextStyle": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 0, "columnIndex": 0 }, "style": { "foregroundColor": { "opaqueColor": { "rgbColor": { "red": 1.0, "green": 1.0, "blue": 1.0 } } }, "bold": true, "fontFamily": "Cambria", "fontSize": { "magnitude": 18, "unit": "PT" } }, "textRange": { "type": "ALL" }, "fields": "foregroundColor,bold,fontFamily,fontSize" } }, // Repeat the above request for each additional cell in the header row.... ] }
これらの更新後、書式設定されたヘッダー行は次のようになります。
表の行または列を挿入
次の presentations.batchUpdate
コードサンプルは、InsertTableRowsRequest
メソッドを使用して 6 番目の行の下に 3 行を追加する方法を示しています。次に、InsertTableColumnsRequest
メソッドを使用して、同じテーブルの 4 列目の左側に 2 つの列を追加します。
テーブルは TABLE_ID で指定されます。cellLocation
内の rowIndex
と columnIndex
はどちらもゼロベースです。
テーブルの行または列を挿入するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "insertTableRows": { "tableObjectId": TABLE_ID, "cellLocation": { "rowIndex": 5 }, "insertBelow": true, "number": 3 } }, { "insertTableColumns": { "tableObjectId": TABLE_ID, "cellLocation": { "columnIndex": 3 }, "insertRight": false, "number": 2 } } ] }