基本朗读

您可以通过 Google Slides API 读取演示文稿、页面和页面元素数据。本页上的示例展示了如何同时使用 presentations.getpresentations.pages.get 方法执行常见读取操作。

这些示例使用以下占位符:

  • PRESENTATION_ID - 表示您提供演示文稿 ID 的位置。您可以通过演示文稿网址查找此 ID 的值。
  • PAGE_ID - 表示您提供页面对象 ID 的位置。您可以从网址或使用 API 读取请求检索此 ID 的值。

为保证语言中立性,这些示例以 HTTP 请求的形式呈现。这些示例从此示例演示文稿读取数据,该演示文稿的 PRESENTATION_ID1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc。此演示文稿中第一张幻灯片PAGE_IDge63a4b4_1_0

此处的示例使用字段掩码以便仅返回请求的有关演示文稿、幻灯片和页面元素的特定信息。使用字段掩码也可以提升性能。

读取幻灯片对象 ID

以下 presentations.get 代码示例展示了如何从演示文稿中检索所有幻灯片对象 ID 的列表。这些 ID 按幻灯片演示顺序返回,可用于在后续 API 请求中指示特定幻灯片。您可以使用 fields=masters.objectIdfields=layout.objectId 通过相同方式获取母版和布局页面的对象 ID。

以下是用于读取幻灯片对象 ID 的请求协议:

GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId

响应由一个包含请求的对象 ID 的 Presentation 对象组成:

{
  "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) 仅返回有关 linetable 页面元素的信息(如果页面上存在任何此类元素)。

以下是用于从页面读取形状元素的请求协议:

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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}