如何通过Google Apps Script在Google Slides中无损调整图片裁剪尺寸？

我之前也踩过这个坑！确实在Google Apps Script的SlidesApp服务里，图片的裁剪属性（cropProperties）大多是只读状态，直接修改图片的宽高还容易因为强制拉伸导致失真。下面分享几个经过验证的无损调整方案：

方案一：使用Slides API的BatchUpdate修改（最可靠） #

Slides API的权限比原生SlidesApp更灵活，能直接修改裁剪属性和尺寸，而且可以保证无损。步骤如下：

1. 先在Google Apps Script编辑器里启用Slides API：点击「资源」→「高级Google服务」，找到Slides API并开启。
2. 编写BatchUpdate请求，同时调整裁剪范围和尺寸（保持原图比例）：

function adjustImageCropAndSize() {
  const presentationId = "你的演示文稿ID";
  const pageObjectId = "包含图片的页面ID";
  const imageObjectId = "目标图片的ID";
  
  // 定义裁剪参数：这里以裁剪顶部10%、左侧5%为例
  const cropRequests = [{
    updateImageProperties: {
      objectId: imageObjectId,
      imageProperties: {
        cropProperties: {
          leftOffset: 0.05,
          topOffset: 0.1,
          rightOffset: 0,
          bottomOffset: 0
        },
        // 设置尺寸：按原图比例调整，这里设置宽度为800px，高度自动计算
        size: {
          width: { magnitude: 800, unit: "PT" },
          height: { magnitude: "AUTO", unit: "PT" }
        }
      },
      fields: "cropProperties,size"
    }
  }];
  
  // 发送请求
  Slides.Presentations.batchUpdate({ requests: cropRequests }, presentationId);
}

这个方法的核心是通过updateImageProperties请求，同时修改裁剪偏移量和尺寸，size里设置height: "AUTO"可以保持原图比例，避免失真。

方案二：先导出图片处理后替换（适合复杂调整） #

如果需要更精细的尺寸调整，可以先把Slides里的图片导出到Google Drive，调整尺寸后再替换回原位置，同时设置裁剪：

function replaceImageWithCroppedVersion() {
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  const image = slide.getImages()[0];
  
  // 导出图片为Blob
  const imageBlob = image.getBlob();
  
  // 调整图片尺寸（保持比例，设置宽度为800px）
  const resizedBlob = imageBlob.getAs('image/png').setWidth(800);
  
  // 删除原图片，插入新图片到相同位置
  const newImage = slide.insertImage(resizedBlob, image.getLeft(), image.getTop());
  
  // 模拟裁剪效果：通过缩放和微调位置实现
  newImage.setScaleX(0.9); // 缩小宽度模拟左侧裁剪
  newImage.setScaleY(0.8); // 缩小高度模拟顶部裁剪
  newImage.setTop(newImage.getTop() + 20); // 微调位置匹配裁剪区域
}

这种方法适合需要对图片进行额外处理（比如滤镜、格式转换）的场景，替换后的图片不会失真，因为是基于原图调整后重新插入的。

关键注意点 #

• 避免直接修改image.setWidth()或image.setHeight()：这会强制拉伸图片，导致失真，一定要结合比例设置（比如先获取原图宽高比，再计算对应尺寸）。
• SlidesApp的局限性：原生服务里很多裁剪属性是只读的，这时候一定要切换到Slides API来操作，功能更完整。

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