簡報 API 可讓您管理現有簡報檔案及建立新簡報檔案。本頁的範例列舉了一些可透過 API 達成的常見簡報作業。
這些範例使用以下變數：
- presentationId：指出您提供簡報 ID 的位置。您可以從簡報網址找到這個 ID 的值。
- pageId：指出您提供頁面物件 ID 的位置。您可以透過網址或使用 API 讀取要求擷取此值。
- pageElementId：指出您提供網頁元素物件 ID 的位置。您可以為自己建立 (有一些限制) 的元素指定這個 ID，或允許 API 自動建立元素 ID；您可以透過 API 讀取要求擷取元素 ID。
建立新簡報
以下 presentations.create 要求會建立一個新的空白簡報檔案，名稱為「My New presentation」(我的新簡報)。此外，您也可以將 application/vnd.google-apps.presentation 指定為 mimeType，也可以使用 Google Drive API Files.create 方法建立空白的簡報檔案。
要求通訊協定如下所示。建立及管理簡報指南中的範例，說明如何使用 Google API 用戶端程式庫，以不同語言實作批次更新。
POST https://slides.googleapis.com/v1/presentations
{
"title": "My New Presentation"
}
列出現有的簡報檔案
簡報 API 並未提供擷取簡報清單的方法，但您可以使用 Drive API 輕鬆完成這項操作。這裡的 Drive API Files.list 要求使用欄位遮罩，傳回雲端硬碟中簡報檔案的清單，其中包含檔案 ID、標題和連結。
要求通訊協定如下所示。Drive API 的「搜尋檔案」指南提供使用 Google API 用戶端程式庫以不同語言實作檔案搜尋要求的範例。
GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)
這項要求的回應結構如下：
{
"files": [
{
"id": "abcdefghijklmnopqrstuvwxyz0123456789",
"name": "Project Vision",
"webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk"
},
{
"id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
"name": "Untitled Presentation",
"webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk"
},
...
]
}
在簡報過程中取代文字
下列 presentations.BatchUpdate 要求會在 presentationId 指定的簡報過程中取代文字。「Gizmo Corp.」字串的每個例項都會替換成「Widget Inc.」文字。包括文字方塊和其他形狀、投影片和主投影片中的文字。在此情況下，替換文字會區分大小寫。
要求通訊協定如下所示。合併資料至簡報指南中的範例說明如何使用 Google API 用戶端程式庫，以不同語言實作批次更新。
POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
"requests": [
{
"replaceAllText": {
"containsText": {
"text": "Gizmo Corp.",
"matchCase": true
},
"replaceText": "Gadget Inc."
}
}
]
}