通过 Google Sheets API，您可以读取演示文稿、页面和页面元素数据。本页中的示例展示了如何使用 presentations.get 和 presentations.pages.get 方法执行常见的读取操作。
这些示例使用以下占位符：
- PRESENTATION_ID - 表示您提供演示文稿 ID 的位置。您可以从演示文稿网址中发现此 ID 的值。
- PAGE_ID - 表示在何处提供页面对象 ID。您可以从网址或使用 API 读取请求检索此 ID 的值。
这些示例以 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
响应由包含所请求的对象 ID 的 Page 对象组成：
{
"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
}
}
}
]
}
}
},
...
]
}