幻灯片操作

您可以通过 Slides API 创建、移动和删除幻灯片。 本页上的示例展示了一些可使用此 API 实现的常用幻灯片操作。

这些示例使用以下变量:

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

复制幻灯片

以下 presentations.batchUpdate 请求可创建一个幻灯片副本,并将该副本插入演示文稿中原始幻灯片的后面。原始幻灯片通过 pageId 指定。

此请求让您可以指定副本中应包含的部分或全部页面元素 ID(具有一些限制)。在此示例中,原始幻灯片具有一个表格元素(由 ID tableElement_01指定),该元素将被映射到幻灯片副本(为其指定 ID copiedSlide_001)的新表格中(具有 ID copiedTable_001)。为副本上的所有其他元素提供随机 ID。

请求协议如下所示。 创建幻灯片指南展示了一个使用 Google API 客户端内容库实现不同语言批量更新的示例。

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "duplicateObject": {
        "objectId": pageId,
        "objectIds": {
          "pageId": "copiedSlide_001",
          "tableElement_01": "copiedTable_001"
        }
      }
    }
  ]
}

创建新幻灯片

以下 presentations.batchUpdate 请求可创建一张新幻灯片,并将其作为第四张幻灯片中插入演示文稿中。对新幻灯片进行设置以使用“Title and two columns”预定义布局。 您可以指定一个字符串作为此幻灯片的 pageId(具有一些限制),或通过在请求中忽略字段来允许 API 生成 pageId

请求协议如下所示。 创建幻灯片指南展示了一个使用 Google API 客户端内容库实现不同语言批量更新的示例。

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "createSlide": {
        "objectId": pageId,
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

将幻灯片移动到新位置

以下 presentations.batchUpdate 请求可获取两个指定的幻灯片,将它们移动到演示文稿的开头,同时保持其相对顺序。指定的幻灯片 ID 必须按现有演示文稿顺序提供,不能出现重复。

请求协议如下所示。 添加文本和形状指南展示了一个使用 Google API 客户端内容库实现不同语言批量更新的示例。

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          pageId,
          pageId2
        ],
        "insertionIndex": 0
      }
    }
  ]
}

设置幻灯片背景图像

以下 presentations.batchUpdate 请求可设置 pageId 指定的幻灯片的背景图像。 字段掩码用于仅更新幻灯片背景,无需更改它的其他属性。 通过提供 API 获取图像的网址 (imageUrl) 来指定图像。 或者,可使用 updatePageProperties 请求将幻灯片的背景设为纯色。

请求协议如下所示。 创建幻灯片指南展示了一个使用 Google API 客户端内容库实现不同语言批量更新的示例。

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": pageId,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": imageUrl
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

发送以下问题的反馈:

此网页
Slides API
Slides API