能否实现仅对幻灯片指定单页替换文本，而非全幻灯片批量替换

核心问题 #

日常演示文稿文本替换操作中，常用的replaceAllText接口为全局生效机制，会遍历演示文稿的所有幻灯片，只要匹配到目标占位文本就执行替换，完全无法适配“同个占位符在多页存在、仅修改指定单页的对应内容、不改动其他页相同文本”的场景。

实现逻辑 #

核心思路：利用文本替换接口自带的作用域限定能力，将替换操作的生效范围完全锁定在目标幻灯片内部，从机制上避免对其他页内容的误修改
具体操作步骤：

• 第一步：定位目标幻灯片的唯一标识
  从演示文稿的幻灯片列表中，找到需要操作的指定幻灯片（对应场景中的第3张），获取该幻灯片自身的objectId。
• 第二步：构造带范围限定的替换请求
  区别于之前使用的无范围参数的全局replaceAllText，改用支持作用域控制的replaceText请求类型，将第一步拿到的目标幻灯片objectId传入接口的objectIds参数。
  接口会自动将替换操作的生效范围限定在传入ID对应的元素内部，由于传入的ID属于目标幻灯片，操作过程中根本不会遍历其他幻灯片的内容，从根源上杜绝跨页误替换的问题。

参考代码 #

PRODUCT_NAME = "实际替换后的产品名称"
# 从演示文稿结构中获取的第3张幻灯片对应的objectId
TARGET_SLIDE_OBJECT_ID = "slide_3_unique_identifier"

requests = [{
    "replaceText": {
        "containsText": {
            "text": "{{PRODUCT_NAME}}",
            "matchCase": True
        },
        "replaceText": PRODUCT_NAME,
        # 关键参数：指定替换仅在该ID对应的元素范围内生效
        "objectIds": [TARGET_SLIDE_OBJECT_ID]
    }
}]

注意事项 #

• 如果待替换的文本位于幻灯片内嵌套的组元素中，不需要单独收集组内子形状的ID，只要传入目标幻灯片的顶层ID，接口会自动递归匹配该幻灯片下所有层级的文本内容。
• 作用域限定后的replaceText的文本匹配规则、大小写匹配逻辑都和全局replaceAllText完全一致，仅缩小了生效范围，不需要额外开发匹配逻辑。
• 当存在其他幻灯片包含相同占位文本的情况，由于这些元素不在传入的objectIds范围内，完全不会被替换，保障了单页操作的精准性。

内容的提问来源于stack exchange，提问作者F-Developer