Google Slides API 可讓您建立、移動及刪除投影片。
本頁面將介紹一些常見的投影片操作
presentations.batchUpdate
敬上
方法。
這些範例使用下列變數:
- PRESENTATION_ID:代表您在何處提供 簡報 ID:你可以 從簡報網址找出這個 ID 的值。
- PAGE_ID 和 PAGE_ID2:表示在何處 您需要提供網頁物件 ID。您可以擷取 該網址的值,或是使用 API 讀取要求。
這些範例會顯示為中立語言的 HTTP 要求。學習 如何使用 Google API 實作不同語言版本的批次更新 請參閱下列指南:建立 和新增圖案和 文字。
複製投影片
下列
presentations.batchUpdate
敬上
程式碼範例顯示如何使用
DuplicateObjectRequest
。
方法,將投影片插入簡報中的原始投影片,然後再插入簡報中。
原始投影片由 PAGE_ID 指定。
這項要求可讓您指定是否要加入部分或所有網頁元素 ID 副本 (有些人 限制)。 在這個範例中,原始投影片含有表格元素 (由 TABLE_ELEMENT_ID),對應至新資料表 (由 COPY_TABLE_ELEMENT_ID) 加入投影片文案 (由 COPY_PAGE_ID)。副本中的所有其他元素皆會隨機顯示 而非客戶 ID
如要進一步瞭解如何複製
PageElement
、
包括文字方塊、圖片、表格、基本形狀、線條和內嵌影片
請參閱範例 複製並編輯
元素。
複製投影片的要求通訊協定如下:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "duplicateObject": { "objectId": PAGE_ID, "objectIds": { "PAGE_ID": "COPY_PAGE_ID", "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID" } } } ] }
製作投影片
下列
presentations.batchUpdate
敬上
程式碼範例顯示如何使用
CreateSlideRequest
。
方法建立投影片,並將其插入至第四張投影片 (使用從 0 開始的
insertionIndex
),
新投影片設為
PredefinedLayout
敬上
(共 TITLE_AND_TWO_COLUMNS
個)。您可以指定字串做為
PAGE_ID (有部分
限制),
或省略該欄位,讓 API 產生 PAGE_ID
。
以下是建立投影片的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": "PAGE_ID", "insertionIndex": 3, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" } } } ] }
建立投影片並修改預留位置
下列
presentations.batchUpdate
敬上
程式碼範例顯示如何使用
CreateSlideRequest
。
方法建立投影片
PredefinedLayout
(共 TITLE_AND_TWO_COLUMNS
)。
您可以指定一個字串做為投影片的 PAGE_ID
(有有些
限制)。
placeholderIdMappings
敬上
採用
Type
/
TITLE
。TITLE_ID 會參照投影片的預留位置形狀
以便進行修改
以下是建立投影片與修改預留位置的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": PAGE_ID, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" }, "placeholderIdMappings": [ { "layoutPlaceholder": { "type": "TITLE", "index": 0 }, "objectId": TITLE_ID, }, ], } }, { "insertText": { "objectId": TITLE_ID, "text": "This is my slide title", } }, ] }
將投影片移到新位置
下列
presentations.batchUpdate
敬上
程式碼範例顯示如何使用
UpdateSlidesPositionRequest
。
取得兩張投影片,並將該投影片移至開頭
相對排序
指定的投影片 ID (PAGE_ID 和 PAGE_ID2)
按照現有的呈現順序提供,不可重複。
以零為基礎的 insertionIndex
表示應插入投影片的位置 (以 0 為基礎)
。值必須介於 0 至
以及簡報中的投影片數量 (含首尾)。
如要將投影片移至新位置,請遵循下列要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateSlidesPosition": { "slideObjectIds": [ PAGE_ID, PAGE_ID2 ], "insertionIndex": 0 } } ] }
設定投影片背景圖片
下列
presentations.batchUpdate
敬上
程式碼範例顯示如何使用
UpdatePagePropertiesRequest
。
方法來設定由
PAGE_ID。API 會使用
IMAGE_URL。
欄位遮罩的用途是指出 必須變更投影片背景來保留其他屬性。使用欄位 口罩也有助於提高效能。
或者,UpdatePagePropertiesRequest
方法也可以用來設定
將投影片背景轉換成單色
以下是設定投影片背景圖片的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageProperties": { "objectId": PAGE_ID, "pageProperties": { "pageBackgroundFill": { "stretchedPictureFill": { "contentUrl": IMAGE_URL } } }, "fields": "pageBackgroundFill" } } ] }
產生縮圖
如要產生特定網頁的最新版本縮圖,請前往
方法是呼叫
presentations.pages.getThumbnail
敬上
方法,會傳回網頁的縮圖圖片做為內容網址。圖片
網址的預設生命週期為 30 分鐘。
您也可以使用mimeType
thumbnailSize
ThumbnailProperties
敬上
做為查詢參數
使用
ThumbnailProperties
已設定:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{ "width": 800, "height": 450, "contentUrl": "CONTENT_URL" }