簡報作業

Google 簡報 API 可讓您建立簡報檔案及管理現有檔案。本頁的範例將示範使用 presentations.batchUpdate 方法呈現的一些常見的頁面作業。

以下範例是以 HTTP 要求為不受語言限制。如要瞭解如何使用 Google API 用戶端程式庫,以不同語言實作批次更新,請參閱下列指南:

建立簡報

下列 presentations.create 程式碼範例說明如何建立名稱為「My NewPresentation」的空白簡報檔案。

您也可以將 application/vnd.google-apps.presentation 指定為 MIME 類型,使用 Google Drive API files.create 方法建立空白的簡報檔案。

以下是用於建立簡報的要求通訊協定:

POST https://slides.googleapis.com/v1/presentations
{
  "title": "My New Presentation"
}

列出現有的簡報檔案

deck 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."
      }
    }
  ]
}