Google 簡報 API 可讓您讀取簡報、網頁和網頁元素資料。本頁的範例將說明如何使用 presentations.get 和 presentations.pages.get 方法執行常見的讀取作業。
以下範例使用的預留位置：
- PRESENTATION_ID：指出您提供呈現 ID 的位置。您可以透過顯示網址探索這個 ID 的值。
- PAGE_ID：指出您在何處提供頁面物件 ID。您可以從網址或使用 API 讀取要求擷取這個值。
以下範例是以 HTTP 要求為不受語言限制。這些範例請參閱這個呈現範例，其中 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc 是其 PRESENTATION_ID。本簡報第一張投影片的 PAGE_ID 為 ge63a4b4_1_0。
此處的範例使用欄位遮罩，只會傳回簡報、投影片和頁面元素的相關特定資訊。使用欄位遮罩也能改善效能。
讀取投影片物件 ID
下列 presentations.get 程式碼範例說明如何從呈現中擷取所有投影片物件 ID 的清單。這些 ID 會以投影片簡報順序傳回，可用於在後續 API 要求中指出特定投影片。您可以使用 fields=masters.objectId 和 fields=layout.objectId 取得主要頁面和版面配置頁面的物件 ID。
以下是讀取投影片物件 ID 的要求通訊協定：
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
回應由 Presentation 物件組成，其中包含要求的物件 ID：
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}
讀取網頁中的元素物件 ID
下列 presentations.pages.get 程式碼範例說明如何擷取網頁上所有網頁元素的物件 ID 清單。
以下要求通訊協定可從網頁中讀取元素物件 ID：
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
回應由 Page 物件組成，該物件包含要求的物件 ID：
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}
讀取頁面中的形狀元素
下列 presentations.pages.get 程式碼範例說明如何擷取網頁上所有 Shapes 的清單。如要擷取其他 PageElement 種類，請使用 fields 參數指定這些種類。舉例來說，fields=pageElements(line,table) 只會傳回 line 和 table 頁面元素的相關資訊 (如果有的話)。
以下要求通訊協定可從網頁中讀取形狀元素：
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
回應會包含 Page 物件，其中包含要求的形狀元素。空白大括號表示網頁元素不屬於形狀類型；在本例中，這些元素就是圖片網頁元素。
{
"pageElements": [
{},
{},
{
"shape": {
"shapeProperties" {
"outline" {
"dashStyle": "SOLID",
"outlineFill": {
"solidFill": {
"alpha": 1,
"color": {
"rgbColor": {}
}
},
},
"propertyState": "NOT_RENDERED",
"weight": {
"magnitude": 9525,
"unit": "EMU"
}
},
"shadow": {
"alignment": "BOTTOM_LEFT",
"alpha": 1,
"blurRadius": {
"unit": "EMU"
},
"color": {
"rgbColor": {}
},
"propertyState": "NOT_RENDERED",
"rotateWithShape": false,
"transform": {
"scaleX": 1,
"scaleY": 1,
"unit": "EMU"
},
"type": "OUTER"
},
"shapeBackgroundFill" : {
"propertyState": "NOT_RENDERED",
"solidFill": {
"alpha": 1,
"color": {
"rgbColor: {
"blue": 1,
"green": 1,
"red": 1
}
}
}
}
},
"shapeType": "TEXT_BOX",
"text": {
"textElements": [
{
"endIndex": 11,
"paragraphMarker": {
"style": {
"alignment": "START",
"direction": "LEFT_TO_RIGHT",
"indentEnd": {
"unit": "PT"
},
"indentFirstLine": {
"unit": "PT"
},
"indentStart": {
"unit": "PT"
},
"lineSpacing": 100,
"spaceAbove": {
"unit": "PT"
},
"spaceBelow": {
"unit": "PT"
},
"spacingMode": "COLLAPSE_LISTS"
}
}
},
{
"endIndex": 11,
"textRun": {
"content": "Baby Album\n",
"style": {
"backgroundColor": {},
"baselineOffset": "NONE",
"bold": false,
"fontFamily": "Arial",
"fontSize": {
"magnitude": 14,
"unit": "PT"
},
"foregroundColor": {
"opaqueColor": {
"rgbColor": {}
}
},
"italic": false,
"smallCaps": false,
"strikethrough": false,
"underline": false
}
}
}
]
}
}
},
...
]
}