Google 簡報 API 可讓您建立及修改 Google 簡報。
應用程式可與 Google 幻燈片 API 整合，自動根據使用者和系統提供的資料建立精美的幻燈片。舉例來說，您可以使用資料庫中的顧客詳細資料，並搭配預先設計的範本和所選設定選項，以比手動製作更快速的方式建立完整簡報。
API 總覽
presentations 集合提供方法，可讓您取得及更新簡報中的元素。
您使用 Slides API 時，大部分的工作可能會是建立及更新簡報。您可以使用 batchUpdate 方法執行這項操作；這個方法會接收 Request 物件清單，讓您執行下列操作：
- 建立簡報
- 在投影片中加入圖案或表格等元素
- 插入、變更及移除文字
- 將轉換套用至元素
- 變更投影片順序
詳情請參閱「批次更新」。請參閱入門指南，瞭解如何使用 API 的簡易端對端範例。
簡報的結構
Slides API 中的簡報由頁面組成，而頁面包含頁面元素。
您可以從網址取得簡報 ID：
https://docs.google.com/presentation/d/presentationId/edit
呈現 ID 是包含英文字母、數字和部分特殊字元的字串。您可以使用下列規則運算式，從 Google 試算表網址中擷取簡報 ID：
/presentation/d/([a-zA-Z0-9-_]+)
如果您熟悉 Drive API，presentationId 會對應至 File 資源的 ID。
系統會使用物件 ID 識別網頁和網頁元素。
Pages
Google 簡報有以下幾種頁面：
| 碩士 | 投影片主控項會定義所有使用此主控項的投影片中顯示的預設文字樣式、背景和頁面元素。必須顯示在所有投影片面上的頁面元素應加入至母片。大部分簡報都有一個主頁面，但有些可能會有多個，也可能沒有。 |
| 版面配置 | 版面配置可做為範本，用於預設情況下在使用版面配置的簡報中安排頁面元素。每個版面配置都會與一個主版面配置相關聯。 |
| 簡報 | 這些網頁包含你要向觀眾呈現的內容。 大多數投影片都是以母片和版面配置為基礎。您可以在建立時指定每個投影片要使用的版面配置。 |
| 附註 | 這些頁面包含簡報講義內容，包括包含投影片演講者備忘稿的形狀。每個投影片都會有一個對應的筆記頁面。只有演講者備忘稿形狀中的文字可以使用 Sheets API 修改。 |
| 附註母片 | 筆記母片可為所有筆記頁面定義預設文字樣式和頁面元素。在 Slides API 中，筆記母片為唯讀。 |
網頁元素
頁面元素是放置在頁面上的視覺元件。API 會公開多種網頁元素：
| 群組 | 一組會視為個別單元的網頁元素。您可以一起移動、縮放及旋轉這些圖層。 |
| 圖案 | 純視覺物件，例如矩形、橢圓形和文字方塊。形狀可包含文字，因此是建立投影片最常見的頁面元素。 |
| 圖片 | 匯入至 Google 簡報的圖形。 |
| 影片 | 匯入至簡報的影片。 |
| 折線圖 | 視覺線條、曲線或連接線。 |
| 資料表 | 內容格線。 |
| WordArt | 視覺文字元素，其行為更像是形狀。 |
| SheetsChart | 從 Google 試算表匯入 Google 簡報的圖表。 |
批次更新
batchUpdate 方法可讓您更新簡報的多個層面。變更會分組成一個批次，這樣如果有一個要求失敗，就不會寫入其他 (可能相關) 變更。
batchUpdate 方法會採用一或多個 Request 物件，每個物件都會指定要執行的單一類型要求。要求有許多不同類型。以下是要求類型細目，分為不同類別。
batchUpdate 方法會傳回回應內文，其中包含每個要求的 Response。每個回應都會與對應要求共用相同的索引；如果要求沒有適用的回應，該索引的回應會為空白。各種 Create 要求通常都有回應，因此您可以知道新新增物件的 ID。
使用物件 ID
簡報 API 中的簡報由頁面和頁面元素組成。這些物件包含在簡報中專屬的 物件 ID 字串。
在建立時指定物件 ID
使用 batchUpdate 方法建立網頁或網頁元素時，您可以選擇為新物件指定物件 ID。這樣一來，您就能在同一個 batchUpdate 要求中建立及修改物件，盡量減少對 Slides API 的呼叫次數，並降低配額使用量。
在大多數情況下，建議您產生隨機物件 ID。舉例來說，如果您使用的是 Java，java.util.UUID.randomUUID().toString() 應該可以正常運作。
如果應用程式想在較長的時間內追蹤物件，請勿依賴物件 ID，因為物件 ID 可能會變更。詳情請參閱下文。
在不使用物件 ID 的情況下追蹤物件
您發出 Slides API 要求時，系統通常會保留物件 ID。(任何例外狀況都會在方法的參考說明文件中列出)。使用 Drive API 複製整份簡報時，也會保留物件 ID。
不過，您無法依賴物件 ID 在簡報在「簡報」使用者介面中變更後仍保持不變。舉例來說，如果有人使用簡報 UI 複製貼上頁面元素，然後刪除原始元素，頁面元素現在就會擁有新的不重複 ID，而您先前透過 API 提供的 ID 將會遺失。因此，我們不建議您將物件 ID 儲存在應用程式的儲存空間中。請改為透過文字內容或替代文字，在簡報中尋找物件。
新建立的簡報通常會使用一組一致的 ID 來代表預設投影片、母片和文字方塊。這些 ID 會隨時間變更，因此我們不建議您依賴這項功能。請改為使用呼叫 create() 或 get() 傳回的呈現物件，找出您要修改的元素。