Google Slides API 可讓您建立並編輯頁面上的表格。
本頁列出了一些常見的資料表作業
presentations.batchUpdate
方法。
這些範例使用下列變數:
- PRESENTATION_ID:代表您在何處提供 簡報 ID:你可以 從簡報網址找出這個 ID 的值。
- PAGE_ID:指示您在提供網頁物件的位置。 ID您可以擷取 該網址的值,或是使用 API 讀取要求。
- TABLE_ID:表示您提供頁面 元素物件 ID 找出您需要的表格您可以為自己建立的元素指定此 ID (有部分 限制) 或允許 Slides API 自動建立投影片。元素 ID 可透過 API 讀取要求擷取。
以下示例顯示為 HTTP 要求中立語言。學習 如何使用 Google API 實作不同語言版本的批次更新 用戶端程式庫,請參閱新增形狀和 文字。
建立表格
下列
presentations.batchUpdate
程式碼範例顯示如何使用
CreateTableRequest
方法,將表格新增至 PAGE_ID 指定的投影片。
這個資料表有 8 列和 5 欄。請注意, Slides API
會忽略size
transform
elementProperties
。
相反地,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
方法移除第六列。然後使用
DeleteTableColumnRequest
方法移除第四欄。該資料表是由
TABLE_ID。rowIndex
和 columnIndex
中的
cellLocation
是 0 的基礎。
以下是刪除資料表列或欄的要求通訊協定:
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 指定。受影響的儲存格位於
第五列和第三欄rowIndex
和其中的 columnIndex
cellLocation
是從 0 開始計算
以下是編輯資料表資料的要求通訊協定:
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
方法,即可設定資料表元素的標題列格式,也就是
tableRange
,
由 TABLE_ID 指定。然後使用
TableCellProperties
方法,將標題列的背景顏色設為黑色。
每個要求都會使用
UpdateTextStyleRequest
將標題列中一個儲存格的文字格式設為粗體、白色 18-pt
柬埔寨字型
textRange
。個人中心
您必須針對標頭中的每個儲存格重複這項要求
rowIndex
和 location
中的 columnIndex
和
cellLocation
是以 0 為基礎。
以下是設定表格標題列格式的要求通訊協定:
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
方法,在第六列下方新增三列。然後使用
InsertTableColumnsRequest
方法,將兩個資料欄新增至同一表格中的第四欄。
資料表是由 TABLE_ID 指定。rowIndex
和
cellLocation
中的 columnIndex
是以 0 為基礎。
下方是插入資料表列或欄的要求通訊協定:
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 } } ] }