使用Docs REST API替换Google Docs图片时的占位框适配问题

imageReplaceMethod枚举值说明 #

Google Docs API的replaceImage请求中，imageReplaceMethod有三个可选值，对应不同的图片适配逻辑：

• CENTER_CROP：将新图片居中裁剪，强制填充原占位框的宽高比例，会裁剪掉超出部分（也就是你当前遇到的竖图被上下裁剪的情况）
• FIT：保持新图片的原始宽高比例，缩放至完全适配原占位框的尺寸（不会裁剪图片，若比例不一致，会在占位框内留空白边），这正是你需要的适配原占位框且不裁剪的选项
• INHERIT_SIZE_FROM_IMAGE：直接使用新图片的原始尺寸替换，会改变原占位框的大小

修改后的代码 #

将imageReplaceMethod改为FIT，同时优化inlineObjects的遍历逻辑（避免无效循环）：

let requests = [];

// Get the Uri of the image file
let url = "https://www.googleapis.com/drive/v3/files/<id of file>?supportsAllDrives=true&fields=webContentLink";
let response = getGoogleAPI(url);
let logoUri = JSON.parse(response).webContentLink;

// Get the id of the image in the Docs file to be replaced
url = "https://docs.googleapis.com/v1/documents/<id of file>?fields=inlineObjects";
response = getGoogleAPI(url);

let inlineObjects = JSON.parse(response.getContentText()); 

// 遍历所有inline图片对象，仅处理图片类型的元素
for (const inlineObjId in inlineObjects.inlineObjects) {
  const inlineObj = inlineObjects.inlineObjects[inlineObjId];
  // 确认是图片元素，避免处理其他类型的inline对象
  if (inlineObj.inlineObjectElement?.imageProperties) {
    requests.push({
      "replaceImage": {
        "imageObjectId": inlineObjId,
        "uri": logoUri,
        "imageReplaceMethod": "FIT" // 替换为FIT实现适配原占位框
      }
    });
  }
}

// Replace the image
url = "https://docs.googleapis.com/v1/documents/<id of file>:batchUpdate";
payload = {
  "requests" : requests
}

response = postGoogleAPI(url, payload);

补充说明 #

• 如果你希望新图片完全填充原占位框且不保持比例（拉伸图片），Docs API目前没有直接支持这个逻辑，只能通过先替换图片，再单独发送updateImageProperties请求调整宽高比例来实现，但会导致图片变形。
• 确保你使用的webContentLink是有效的可公开访问链接（或有足够权限的链接），否则替换会失败。

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