Google Slides API 可讓您在簡報頁面中新增及修改元素。本頁的範例說明如何使用 presentations.batchUpdate
方法執行常見的讀取作業。
這些範例使用下列變數:
- PRESENTATION_ID:指示您在提供表示法 ID 的位置。您可以從簡報網址找出這個 ID 的值。
- PAGE_ID:指明您提供頁面物件 ID 的位置。您可以使用網址或 API 讀取要求擷取此值。
- PAGE_ELEMENT_ID:指明您提供網頁元素物件 ID 的位置。您可以為自己建立的元素指定此 ID (須有一些限制),或允許 Slides API 自動建立元素。您可以透過 API 讀取要求擷取元素 ID。
這些範例會顯示為中立語言的 HTTP 要求。如要瞭解如何使用 Google API 用戶端程式庫,以不同語言實作批次更新,請參閱「新增形狀和文字」一文。
在投影片中新增文字方塊
以下 presentations.batchUpdate
程式碼範例說明如何使用 CreateShapeRequest
方法,在 PAGE_ID 指定的投影片中新增文字方塊 (包含「My Add Text Box」字串)。您在要求主體中指定兩項要求,一個用於建立文字方塊形狀 (具有指定的大小和位置),第二項則用於將文字插入要求主體。
第一個要求指定文字方塊要使用的物件 ID。如此即可讓第二個要求在同一個 API 呼叫中使用,進而減少負擔。
如要在投影片中新增文字方塊,要求通訊協定如下:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createShape": { "objectId": PAGE_ELEMENT_ID, "shapeType": "TEXT_BOX", "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 150, "unit": "PT" }, "height": { "magnitude": 50, "unit": "PT" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 200, "translateY": 100, "unit": "PT" } } } }, { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "My Added Text Box", "insertionIndex": 0 } } ] }
在投影片中新增圖片
下列 presentations.batchUpdate
程式碼範例說明如何使用 CreateImageRequest
方法,將圖片新增至 PAGE_ID 指定的投影片。API 會使用 IMAGE_URL 擷取圖片。這項要求也會縮放及定位投影片中的圖片。
以下是在投影片中新增圖片的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createImage": { "url": IMAGE_URL, "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 30, "unit": "PT" }, "height": { "magnitude": 30, "unit": "PT" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 200, "translateY": 100, "unit": "PT" } } } } ] }
刪除網頁或網頁元素
下列 presentations.batchUpdate
程式碼範例說明如何使用 DeleteObjectRequest
方法,透過兩個不同的要求刪除 PAGE_ELEMENT_ID 指定的網頁元素和 PAGE_ID 指定的投影片。
以下是刪除網頁或網頁元素的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteObject": { "objectId": PAGE_ELEMENT_ID }, "deleteObject": { "objectId": PAGE_ID } } ] }
編輯特定圖案中的文字
下列 presentations.batchUpdate
程式碼範例說明如何使用 DeleteTextRequest
方法,取代 PAGE_ELEMENT_ID 指定形狀中的部分文字。為此,請先使用以零為基礎的 startIndex
刪除文字,然後在該位置插入新文字。在此範例中,原始文字字串「My Shape Text: ????」會取代為「My Shape Text: Trapezoid」。
這項要求只會影響指定形狀中的文字。如要將文字取代簡報中所有位置,請使用 ReplaceAllTextRequest
方法。
下列要求通訊協定可用於編輯特定形狀中的文字:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteText": { "objectId": PAGE_ELEMENT_ID, "textRange": { "type": "FROM_START_INDEX", "startIndex": 15 } } }, { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "Trapezoid", "insertionIndex": 15 } } ] }
使用圖片取代形狀標記
標記是具有不重複字串名稱的文字方塊或形狀,例如「帳戶持有人名稱」。
以下 presentations.batchUpdate
程式碼範例說明如何使用 CreateImageRequest
方法,將形狀標記的單一例項取代為圖片,並維持相同的位置並縮放到符合標記的大小,同時維持圖片的顯示比例。
這項要求也可以用來取代某張圖片。要求是由新增映像檔,然後刪除標記。
CreateImageRequest
方法只會取代指定形狀。如要取代簡報中任何地方的標記形狀,請使用 ReplaceAllShapesWithImageRequest
方法。
形狀標記具有下列 PageElement
屬性 (可使用 presentations.pages.get
要求查看):
{ "objectId": PAGE_ELEMENT_ID, "size": { "width": { "magnitude": 3000000, "unit": "EMU" }, "height": { "magnitude": 3000000, "unit": "EMU" } }, "transform": { "scaleX": 1.13, "scaleY": 0.62, "translateX": 4800000, "translateY": 450000, "unit": "EMU" }, "shape": { "shapeType": "RECTANGLE" } }
形狀位於 PAGE_ID 指定的投影片中。如要指定取代形狀的圖片,API 會使用 IMAGE_URL 擷取圖片。為了保留圖片長寬比,同時將圖片長寬比限制在標記大小,CreateImageRequest
方法會將圖片大小設定為標記大小和縮放比例的乘積,以及圖片縮放比例係數為 1
。詳情請參閱「保留長寬比」。
以下就是將 Shape 標記替換為圖片的要求通訊協定:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createImage": { "url": IMAGE_URL, "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 3000000 * 1.13, "unit": "EMU" }, "height": { "magnitude": 3000000 * 0.62, "unit": "EMU" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 4800000, "translateY": 450000, "unit": "PT" } } } }, { "deleteObject": { "objectId": PAGE_ELEMENT_ID } } ] }