如何通过Google Slides API删除文本框替换后的剩余文本

问题背景 #

我正在通过API基于Google Calendar事件自动生成重复的Google Slides演示文稿，已经实现了文本替换功能，但想删除最后一次文本替换后剩下的所有文本。之前试过把剩余文本替换成空白，结果触发了API配额限制，想知道能不能直接删除这些剩余文本。

当前使用的文本替换函数代码：

def text_replace(old: str, new: str, presentation_id: str, pages: list = []):
    slides_service = build('slides', 'v1', credentials=creds)

    slides_service.presentations().batchUpdate(
        body={
            "requests": [
                {
                    "replaceAllText": {
                        "containsText": {
                            "text": '{{' + old + '}}'
                        },
                        "replaceText": new,
                        "pageObjectIds": pages,
                    }
                }
            ]
        },
        presentationId=presentation_id
    ).execute()

目标幻灯片仅包含一个文本框，需要删除该文本框内指定的剩余文本。

解决方案 #

可以直接使用Google Slides API的deleteText请求删除指定范围的文本，这种方式比替换空白更高效，能避免触发配额限制。

1. 核心删除函数 #

以下是直接删除文本的函数实现，需要指定文本框的objectId以及要删除的文本起始、结束索引：

def delete_remaining_text(presentation_id: str, text_box_object_id: str, start_index: int, end_index: int):
    slides_service = build('slides', 'v1', credentials=creds)
    
    requests = [
        {
            "deleteText": {
                "objectId": text_box_object_id,
                "textRange": {
                    "startIndex": start_index,
                    "endIndex": end_index
                }
            }
        }
    ]
    
    slides_service.presentations().batchUpdate(
        presentationId=presentation_id,
        body={"requests": requests}
    ).execute()

2. 获取文本框的objectId #

如果不知道目标文本框的objectId，可以调用API获取幻灯片详情，从中提取文本框ID：

def get_text_box_object_id(presentation_id: str, page_id: str):
    slides_service = build('slides', 'v1', credentials=creds)
    presentation = slides_service.presentations().get(presentationId=presentation_id).execute()
    
    for page in presentation['slides']:
        if page['objectId'] == page_id:
            for element in page['pageElements']:
                if 'shape' in element and 'text' in element['shape']:
                    return element['objectId']
    return None

3. 执行流程示例 #

在完成最后一次文本替换后，按以下步骤删除剩余文本：

• 调用get_text_box_object_id获取目标文本框的ID
• 获取文本框当前的文本内容，计算替换后剩余文本的起始索引（比如替换后的文本长度）和结束索引（文本总长度）
• 调用delete_remaining_text完成删除

关键说明 #

• deleteText请求仅需一次API调用即可删除指定范围文本，远低于多次替换空白的配额消耗
• 若要删除文本框内所有未替换的剩余内容，可将startIndex设为最后一次替换后文本的长度，endIndex设为文本框的总文本长度
• 可以将删除逻辑整合到现有生成流程中，在文本替换完成后立即执行

内容的提问来源于stack exchange，提问作者HonoraryPants