如何通过Python获取Google Docs中图片ID以替换模板图片？

当你调用documents().get()接口后，返回的文档对象里的positionedObjects字段才是核心——positionedObjectIds只是所有定位对象的ID列表，具体的图片信息需要从positionedObjects中提取：

• 筛选图片类定位对象：遍历document['positionedObjects']中的每个条目，判断对象是否包含imageProperties字段，这是图片类定位对象的专属标识。
• 精准匹配目标图片：提前给模板里的目标图片设置唯一的替代文本（Alt Text），之后通过imageProperties.altText来匹配你要替换的模板图片；也可以通过图片的尺寸、位置辅助判断，但替代文本是最可靠的批量识别方式。
• 提取图片ID：匹配到目标图片后，该条目的键值就是你需要的imageObjectId。

代码示例 #

document = docs_service.documents().get(documentId=document_id).execute()

# 替换为你模板图片的专属替代文本
target_alt_text = "月度报告封面图"
image_object_id = None

# 遍历定位对象，找到目标图片ID
for obj_id, obj_details in document['positionedObjects'].items():
    if 'imageProperties' in obj_details:
        img_props = obj_details['imageProperties']
        if img_props.get('altText') == target_alt_text:
            image_object_id = obj_id
            break

# 生成并执行替换请求
if image_object_id:
    requests = [
        {
            "replaceImage": {
                "imageObjectId": image_object_id,
                "uri": f"https://drive.google.com/uc?id={image_id}", # 建议用直接下载链接，而非view链接
                "imageReplaceMethod": "CENTER_CROP",
            }
        }
    ]
    docs_service.documents().batchUpdate(documentId=document_id, body={'requests': requests}).execute()

注意事项 #

• 确保模板图片的替代文本唯一，避免批量替换时匹配错误；
• replaceImage接口要求uri是可公开访问的图片链接，Google Drive文件建议用https://drive.google.com/uc?id={image_id}格式，否则可能无法正常加载图片。

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