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 } } ] }