Google Slides API 可讓您在簡報頁面中新增及修改元素。
本頁面的範例說明如何使用
presentations.batchUpdate敬上
方法。
這些範例使用下列變數：
- PRESENTATION_ID：代表您在何處提供 簡報 ID：你可以 從簡報網址找出這個 ID 的值。
- PAGE_ID：代表您提供網頁物件的位置 ID：您可以擷取 該網址的值，或是使用 API 讀取要求。
- PAGE_ELEMENT_ID：表示您提供頁面 元素物件 ID。個人中心 可以為您建立的元素指定此 ID (有 限制) 或允許 Slides API 自動建立投影片。元素 ID 可透過 API 讀取要求擷取。
這些範例會顯示為中立語言的 HTTP 要求。學習 如何使用 Google API 實作不同語言版本的批次更新 用戶端程式庫，請參閱新增形狀和 文字。
在投影片中新增文字方塊
下列
presentations.batchUpdate敬上
程式碼範例顯示如何使用
CreateShapeRequest
方法，藉此在
由 PAGE_ID 指定的投影片。指定了兩項要求
要求主體—一個用來建立文字方塊形狀 (指定特定大小且
另一個則用來插入文字。
第一個請求會指定物件 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: ????"替換成「我的
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
}
}
]
}