此页面由 Cloud Translation API 翻译。

幻灯片操作

您可以使用 Google Sheets API 创建、移动和删除幻灯片。本单元中的示例本页将展示使用 presentations.batchUpdate 方法。

这些示例使用以下变量：

PRESENTATION_ID - 表示您在哪里提供演示文稿 ID。您可以从演示文稿网址中发现此 ID 的值。
PAGE_ID 和 PAGE_ID2 - 用于指明您需要提供 page 对象 ID。您可以使用从网址或使用 API 读取请求获取此值。

这些示例以 HTTP 请求的形式呈现，与语言无关。学习内容如何使用 Google API 实现不同语言的批量更新客户端库，请参阅以下指南：创建幻灯片和添加形状和文本。

复制幻灯片

以下 presentations.batchUpdate 代码示例展示了如何使用 DuplicateObjectRequest 方法复制幻灯片，并将其插入到演示文稿中原始幻灯片的后面。原始幻灯片由 PAGE_ID 指定。

通过该请求，您可以指定是应包含部分或全部页面元素 ID 副本（其中包含一些限制）。在本示例中，原始幻灯片包含一个表格元素（由 TABLE_ELEMENT_ID），该表将映射到新表（由 COPY_TABLE_ELEMENT_ID）（由 COPY_PAGE_ID）。副本上的所有其他元素都是随机提供的。

有关复制 PageElement, 包括文本框、图片、表格、基本形状、线条和嵌入视频，请参阅示例复制和粘贴元素。

以下是复制幻灯片的请求协议：

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "duplicateObject": {
        "objectId": PAGE_ID,
        "objectIds": {
          "PAGE_ID": "COPY_PAGE_ID",
          "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
        }
      }
    }
  ]
}

制作幻灯片

以下 presentations.batchUpdate 代码示例展示了如何使用 CreateSlideRequest 方法制作一张幻灯片，并将其作为第四张幻灯片插入（使用从 0 开始的 insertionIndex)。

新幻灯片已设为使用 PredefinedLayout 共 TITLE_AND_TWO_COLUMNS 个。您可以指定一个字符串，将其用作本张幻灯片为 PAGE_ID（包含一些限制），或者通过省略字段来允许 API 生成 PAGE_ID 。

以下是制作幻灯片的请求协议：

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createSlide": {
        "objectId": "PAGE_ID",
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

创建幻灯片和修改占位符

以下 presentations.batchUpdate 代码示例展示了如何使用 CreateSlideRequest 方法使用 PredefinedLayout （共 TITLE_AND_TWO_COLUMNS）。

您可以指定一个字符串，用作幻灯片的 PAGE_ID （与一些限制）。通过 placeholderIdMappings 使用 Type/ TITLE。TITLE_ID 引用幻灯片的占位符形状以便进行修改

以下是制作幻灯片和修改占位符的请求协议：

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createSlide": {
        "objectId": PAGE_ID,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        },
        "placeholderIdMappings": [
          {
            "layoutPlaceholder": {
              "type": "TITLE",
              "index": 0
            },
            "objectId": TITLE_ID,
           },
        ],
      }
    },
    {
      "insertText": {
        "objectId": TITLE_ID,
        "text": "This is my slide title",
      }
    },
  ]
}

将幻灯片移到新位置

以下 presentations.batchUpdate 代码示例展示了如何使用 UpdateSlidesPositionRequest 方法将两张指定的幻灯片移到呈现，保持它们的相对顺序。

指定的幻灯片 ID（PAGE_ID 和 PAGE_ID2）必须按现有演示文稿顺序提供，不能有重复。通过从零开始的 insertionIndex 表示幻灯片应插入的位置，订单上的其他实体该值必须介于 0 和演示文稿中的幻灯片数量（包括该数量）。

以下是将幻灯片移到新位置的请求协议：

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          PAGE_ID,
          PAGE_ID2
          ],
        "insertionIndex": 0
      }
    }
  ]
}

设置幻灯片背景图片

以下 presentations.batchUpdate 代码示例展示了如何使用 UpdatePagePropertiesRequest 方法，以便设置由 PAGE_ID。API 使用 IMAGE_URL。

字段掩码用于指定只有应更改幻灯片背景以保留其他属性。使用字段也可以提高性能。

此外，您还可以使用 UpdatePagePropertiesRequest 方法设置幻灯片背景色转换为纯色。

以下是设置幻灯片背景图片的请求协议：

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

生成缩略图

您可以在调用 presentations.pages.getThumbnail 方法，该方法会将页面的缩略图作为内容网址返回。图片网址的默认生命周期为 30 分钟。

您还可以使用mimeTypethumbnailSize ThumbnailProperties 字段指定为查询参数。

以下是使用 ThumbnailProperties 组：

 GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM

{
  "width": 800,
  "height": 450,
  "contentUrl": "CONTENT_URL"
}