基本书写

借助 Google Sheets API,您可以在演示文稿页面上添加和修改元素。通过 本页中的示例展示了如何使用 presentations.batchUpdate 方法。

这些示例使用以下变量:

  • PRESENTATION_ID - 表示您在哪里提供 演示文稿 ID。您可以 从演示文稿网址中发现此 ID 的值。
  • PAGE_ID - 表示您提供 page 对象的位置 ID。您可以使用 从网址或使用 API 读取请求获取此值。
  • PAGE_ELEMENT_ID - 表示您提供网页的位置 元素对象 ID。您 您可以为您创建的元素指定此 ID(一些 限制) 也可以让幻灯片 API 自动创建一个元素 ID 可以通过 API 读取请求进行检索。

这些示例以 HTTP 请求的形式呈现,与语言无关。学习内容 如何使用 Google API 实现不同语言的批量更新 请参阅添加形状和 文本

在幻灯片中添加文本框

以下 presentations.batchUpdate 代码示例展示了如何使用 CreateShapeRequest 方法将新文本框(包含字符串“我添加的文本框”)添加到 PAGE_ID 指定的幻灯片。在 请求正文 - 用于创建文本框形状(具有给定大小和 位置),然后在其中插入文本。

第一个请求指定对象 ID 文本框。这样,第二个请求就可以在同一个 API 调用中使用此 ID,从而减少 开销。

以下是向幻灯片添加文本框的请求协议:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createShape": {
        "objectId": PAGE_ELEMENT_ID,
        "shapeType": "TEXT_BOX",
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 150,
              "unit": "PT"
            },
            "height": {
              "magnitude": 50,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "My Added Text Box",
        "insertionIndex": 0
      }
    }
  ]
}

在幻灯片中添加图片

以下 presentations.batchUpdate 代码示例展示了如何使用 CreateImageRequest 方法,用于向 PAGE_ID 指定的幻灯片添加图片。通过 API 使用 IMAGE_URL 检索图片。此请求还 缩放并定位幻灯片中的图片。

以下是将图片添加到幻灯片的请求协议:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 30,
              "unit": "PT"
            },
            "height": {
              "magnitude": 30,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    }
  ]
}

删除页面或页面元素

以下 presentations.batchUpdate 代码示例展示了如何使用 DeleteObjectRequest 用于删除 PAGE_ELEMENT_ID 指定的页面元素的方法 以及 PAGE_ID 使用两个单独的请求指定的幻灯片。

以下是删除页面或页面元素的请求协议:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      },
      "deleteObject": {
        "objectId":  PAGE_ID
      }
    }
  ]
}

编辑指定形状中的文本

以下 presentations.batchUpdate 代码示例展示了如何使用 DeleteTextRequest 方法替换由 PAGE_ELEMENT_ID。为此,请先使用 从零开始的 startIndex,然后在该位置插入新文本。在本课中, 原始文本字符串“My Shape Text: ????”将替换为“我的 “Shape Text: Trapezoid”(形状文字:梯形)。

此请求仅影响指定形状中的文本。替换所有位置的文字 使用 ReplaceAllTextRequest 方法。

以下是编辑指定形状中的文本的请求协议:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteText": {
        "objectId": PAGE_ELEMENT_ID,
        "textRange": {
          "type": "FROM_START_INDEX",
          "startIndex": 15
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "Trapezoid",
        "insertionIndex": 15
      }
    }
  ]
}

将形状标记替换为图片

标记是具有唯一字符串名称的文本框或形状,例如 “account-holder-name”。

以下 presentations.batchUpdate 代码示例展示了如何使用 CreateImageRequest 方法将形状标记的单个实例替换为图片,同时保持 图片的位置不变并对其进行缩放以适应代码的尺寸,同时保持图片的 宽高比。

此请求还可用于将一张图片替换为另一图片。请求 先添加新映像,然后删除标记。

CreateImageRequest 方法仅替换指定的形状。替换标记 在演示文稿的任何位置使用形状 ReplaceAllShapesWithImageRequest 方法。

该形状标记包含以下内容: PageElement 属性(可使用 presentations.pages.get 请求):

{
  "objectId": PAGE_ELEMENT_ID,
  "size": {
    "width": {
      "magnitude": 3000000,
      "unit": "EMU"
    },
    "height": {
      "magnitude": 3000000,
      "unit": "EMU"
    }
  },
  "transform": {
    "scaleX": 1.13,
    "scaleY": 0.62,
    "translateX": 4800000,
    "translateY":  450000,
    "unit": "EMU"
  },
  "shape": {
    "shapeType": "RECTANGLE"
  }
}

形状位于 PAGE_ID 指定的幻灯片上。要指定 替换该形状的图像时,该 API 会使用 IMAGE_URL。在限制图片宽高比的同时保持图片宽高比 代码的大小, CreateImageRequest 方法将图片尺寸设置为代码尺寸和缩放比例的乘积, 将图片缩放比例设为 1。如需了解详情,请参阅保留切面 宽高比

以下是将形状标记替换为图片的请求协议:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 3000000 * 1.13,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 3000000 * 0.62,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 4800000,
            "translateY": 450000,
            "unit": "PT"
          }
        }
      }
    },
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      }
    }
  ]
}