借助 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 的请求协议：
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
的列表。您可以使用 fields 参数指定其他
PageElement
类型，以检索这些类型。例如，
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 } } } ] } } }, ... ] }