Google Slides API 可讓您建立簡報檔案及管理現有檔案。
本頁範例會使用 presentations.batchUpdate
方法提供一些常見的頁面呈現作業。
這些範例會顯示為中立語言的 HTTP 要求。如要瞭解如何使用 Google API 用戶端程式庫,以不同語言實作批次更新,請參閱下列指南:
建立簡報
下列 presentations.create
程式碼範例說明如何建立名為「我的新簡報」的空白簡報檔案。
您也可以使用 Google Drive API files.create
方法,將 application/vnd.google-apps.presentation
指定為 MIME 類型,建立空白的簡報檔案。
以下是建立簡報的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations
{ "title": "My New Presentation" }
列出現有的簡報檔案
Slides API 並未提供擷取簡報清單的方法,但 Drive API 可以。files.list
方法 (如下文) 會使用欄位遮罩傳回雲端硬碟中的簡報檔案清單,其中包含檔案 ID、檔案名稱以及開啟檔案的連結。這項要求也會將 application/vnd.google-apps.presentation
指定為 MIME 類型。
以下是列出現有簡報檔案的要求通訊協定:
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
程式碼範例說明如何使用 ReplaceAllTextRequest
方法,在 PRESENTATION_ID 指定的簡報內取代文字。您可以從呈現網址找出簡報 ID 的值。
每個字串「Gizmo Corp.」都會替換為「小工具 Inc」文字。這包括文字方塊和其他形狀、投影片上和主投影片中的文字。在此情況下,將 matchCase
設為 true
時,文字取代作業會區分大小寫。
下列是取代簡報文字的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "replaceAllText": { "containsText": { "text": "Gizmo Corp.", "matchCase": true }, "replaceText": "Gadget Inc." } } ] }