簡介

Google Slides API 可讓您建立及修改 Google 簡報檔案。

應用程式可與 Google Slides API 整合,製作精美的簡報 自動擷取使用者和系統提供的資料。例如,您可以 使用資料庫中的客戶詳細資料,並結合預先設計好的 和所選設定選項,以便建立已完成的簡報 手動建立模型花費的時間也少了不少

API 總覽

presentations 集合的用途是 方法,可讓您在簡報內取得及更新元素。

Slides API 的大多數工作可能會建立及更新 簡報做法是使用 batchUpdate 方法: 這個方法會採用一系列 要求 這些物件可讓您進行以下操作:

  • 建立簡報
  • 在投影片中新增元素,例如圖案或表格
  • 插入、變更及移除文字
  • 將轉換套用至元素
  • 變更投影片順序

詳情請參閱「批次更新」一文。查看入門指南 ,透過簡單的端對端範例瞭解如何使用 API。

簡報的結構

Slides API 中的簡報是由頁面組成,其中包含頁面 元素。

簡報 ID 可以從以下網址取得:

https://docs.google.com/presentation/d/presentationId/edit

簡報 ID 是包含字母、數字和某些特殊符號的字串 字元。下列規則運算式可用來擷取 來自 Google 試算表網址的簡報 ID:

/presentation/d/([a-zA-Z0-9-_]+)

如果您已熟悉 Drive API,則 presentationId 對應的是 檔案 ID 資源。

網頁和網頁元素是以物件 ID 識別。

Pages

Google 簡報包含下列頁面:

碩士 投影片主投影片會定義預設文字樣式、背景和頁面 元素。頁次 必須出現在所有投影片中的元素都應新增到主投影片中大多數 但有些簡報則只有一個主投影片,或有些則沒有。
版面配置 版面配置可做為範本,用於決定網頁元素如何排列 會在投影片中預設顯示每個版面配置都與一個 主要節點。
簡報 這些網頁包含您要對觀眾顯示的內容。 大多數的投影片都是以主投影片和版面配置為基礎。您可以指定 您建立每張投影片時要使用的版面配置
附註 這些頁麵包含簡報講義的內容,包括 包含投影片演講者備忘稿的圖案每張投影片都有 對應的記事頁面只有演講者備忘稿圖案中的文字可以 透過 Slides API 修改而成
記事本主 記事本主工具會定義所有人的預設文字樣式和網頁元素 附註頁面記事主投影片在 Slides API 中為唯讀狀態。

網頁元素

網頁元素是貼在網頁上的視覺元件。API 可顯示多種網頁元素:

群組 系統會將一組網頁元素視為個別單元。他們可以 移動、縮放及旋轉。
圖案 純視覺物件,例如矩形、刪節號和文字方塊。 形狀可以包含文字,因此是最常用於建立的網頁元素 。
圖片 匯入簡報的圖片。
影片 已將影片匯入簡報。
折線圖 視覺線、曲線或連接頭。
資料表 內容格線。
WordArt 行為與形狀更相似的視覺文字元素。
SheetsChart 從 Google 試算表匯入簡報的圖表。

批次更新

batchUpdate 方法 可讓你更新簡報的多個面向。變更會歸入同一個群組: 批次執行,這樣當一個要求失敗時,其他一個要求 (可能相依) 並寫入變更

batchUpdate 方法的運作方式為擷取一或多個項目 要求 物件,每個物件都會指定單一種類的要求執行。另有 不同類型的要求這是要求類型細目資料 歸入不同類別

使用簡報: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
使用網頁元素: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
使用資料表: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
使用圖表: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
使用圖片和影片: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
使用文字: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

batchUpdate 方法會傳回回應主體。 當中含有 回覆 針對每個要求建立 Cloud Storage 值區每則回應都會使用相同的索引 要求;不含適用回應的要求, 將空白各種 Create 要求通常會有回應, 您也知道新加入物件的 ID

使用物件 ID

Slides API 中的簡報是由「頁面」和「頁面元素」組成。 這些物件包含物件 ID 字串 (在 簡報

在建立時指定物件 ID

使用 batchUpdate 方法,將 您也可以選擇為新物件指定物件 ID。這樣您就能建立 物件,並在同一批次更新要求中加以修改, 並降低配額用量

在大部分情況下,我們建議產生隨機物件 ID。舉例來說,如果您在 使用 Java,java.util.UUID.randomUUID().toString() 應該就能正常運作

當應用程式需要長時間追蹤物件時 時間,不需要依賴物件 ID,因為物件 ID 可能會有所變更。請參閱以下資訊 一節。

持續追蹤物件,不使用物件 ID

提出 Slides API 要求時,物件 ID 通常會保留。(任何 例外狀況請參閱該方法的參考說明文件)。製作 使用 Drive API 的完整簡報副本時,也會保留物件 ID。

不過,您不能依附於呈現內容後變更的物件 ID 已變更。舉例來說,如果有人使用 Google 簡報 使用者介面,可用於複製貼上網頁元素,然後刪除原始,也就是網頁元素 這樣就會取得新的專屬 ID,以及您先前透過 API 提供的 ID 就會遺失因此,我們不建議您將物件 ID 儲存在自己的 實現應用程式的儲存空間相反地,您應該 文字內容或替代文字

新建立的簡報預設會使用一組一致的 ID 投影片、主投影片和文字方塊。這些 ID 可能會隨時變動 因此我們不建議您使用這項功能請改為找出 您想使用 呼叫 create()get().