Google Slides 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,且
用來表示後續 API 要求中的特定投影片您可透過
使用以相同方式使用主頁和版面配置網頁的物件 ID
《fields=masters.objectId
》和《fields=layout.objectId
》。
下列是讀取投影片物件 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 } } } ] } } }, ... ] }