簡報 API 可讓您建立、移動及刪除投影片。本頁的範例說明瞭 API 可完成的一些常見投影片作業。
這些範例使用以下變數：
- presentationId：指出您提供簡報 ID 的位置。您可以從簡報網址找到這個 ID 的值。
- pageId 和 pageId2 — 指出需要提供頁面物件 ID 的位置。您可以透過網址或使用 API 讀取要求擷取此值。
複製投影片
下列 presentations.BatchUpdate 要求會建立投影片副本，並在簡報中的原始檔案之後插入。原始投影片是由 pageId 指定。
該要求可讓您指定文案中應納入哪些或全部的頁面元素 ID，但有一些限制。在本範例中，原始投影片含有一個資料表元素 (由 ID tableElement_01 指定)，該元素會對應至投影片副本中的新資料表 (ID 為 copiedTable_001)。副本中的所有其他元素都會有隨機 ID。copiedSlide_001
要求通訊協定如下所示。建立投影片指南中的範例說明如何使用 Google API 用戶端程式庫，以不同語言實作批次更新。
POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
"requests": [
{
"duplicateObject": {
"objectId": pageId,
"objectIds": {
"pageId": "copiedSlide_001",
"tableElement_01": "copiedTable_001"
}
}
}
]
}
建立投影片
以下 presentations.BatchUpdate 要求會建立新投影片，並插入投影片中的第四張投影片。新投影片已設為使用「標題和兩欄」預先定義的版面配置。您可以指定一個字串做為投影片的 pageId (有一些限制)，也可以省略要求中的欄位，讓 API 產生 pageId。
要求通訊協定如下所示。建立投影片指南中的範例說明如何使用 Google API 用戶端程式庫，以不同語言實作批次更新。
POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": pageId,
"insertionIndex": 3,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
}
}
}
]
}
建立投影片並修改預留位置
以下 presentations.BatchUpdate 要求使用預先定義的「Title 和 two 欄」預先定義的版面配置建立新投影片，並設定標題。
POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": pageId,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
},
"placeholderIdMappings": [
{
"layoutPlaceholder": {
"type": "TITLE",
"index": 0
},
"objectId": titleId,
},
],
}
},
{
"insertText": {
"objectId": titleId,
"text": "This is my slide title",
}
},
]
}
將投影片移到新位置
以下 presentations.BatchUpdate 要求接收兩張指定的投影片，並把這些投影片移到簡報開頭，並維持其相對順序。必須以現有的簡報順序提供指定的投影片 ID，且不得重複。
要求通訊協定如下所示。新增文字和形狀指南中的範例，說明如何使用 Google API 用戶端程式庫，以不同語言實作批次更新。
POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
"requests": [
{
"updateSlidesPosition": {
"slideObjectIds": [
pageId,
pageId2
],
"insertionIndex": 0
}
}
]
}
設定投影片背景圖片
下列 presentations.BatchUpdate 要求會設定由 pageId 組成的投影片背景圖片。「欄位遮罩」只會更新投影片背景，不會變更其其他屬性。您可以透過提供 API 擷取來源網址 (imageUrl) 來指定圖片。或者，您也可以使用 updatePageProperties 要求，將投影片背景設為單色。
要求通訊協定如下所示。建立投影片指南顯示了使用 Google API 用戶端程式庫以不同語言實作批次更新的範例。
POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
"requests": [
{
"updatePageProperties": {
"objectId": pageId,
"pageProperties": {
"pageBackgroundFill": {
"stretchedPictureFill": {
"contentUrl": imageUrl
}
}
},
"fields": "pageBackgroundFill"
}
}
]
}