使用NodeJS调用Google Slides API重排幻灯片遇错误求助

错误原因解释 #

The slides should be in presentation order, with no duplicates 错误的核心逻辑：

• "presentation order"指当前演示文稿中幻灯片的现有排列顺序（即打开幻灯片时从上到下的顺序），不是你期望的目标排序。
• 调用updateSlidesPosition时，slideObjectIds数组必须严格遵循幻灯片当前的现有顺序，不能打乱；同时不能包含重复ID或不存在的ID。

你的代码直接生成了目标顺序的ID列表，但该列表不符合API对presentation order的要求，因此触发错误。另外，updateSlidesPosition本身是用来批量移动一组幻灯片并保持它们的相对顺序，无法直接用它一次性设置所有幻灯片的最终排序。

正确解决方案 #

要实现按数字后缀排序幻灯片，需分三步执行：获取当前幻灯片ID列表、排序得到目标顺序、构建合规的重排请求。

1. 获取当前幻灯片的ID列表（presentation order） #

先调用API获取当前演示文稿中所有幻灯片的ID，这就是API要求的"presentation order"：

const getCurrentSlideIds = async (slidesApi, fileID) => {
  const presentation = await slidesApi.presentations.get({
    presentationId: fileID,
    fields: 'slides/objectId' // 仅请求必要字段，提升接口效率
  });
  return presentation.data.slides.map(slide => slide.objectId);
};

2. 按数字后缀排序ID #

对获取到的ID按后缀数字从小到大排序：

const sortSlideIdsNumerically = (slideIds) => {
  return slideIds.sort((a, b) => {
    // 提取ID中的数字部分并转为整数
    const numA = parseInt(a.split('-')[2]);
    const numB = parseInt(b.split('-')[2]);
    return numA - numB;
  });
};

3. 构建重排请求并执行 #

通过逐个调整幻灯片位置实现最终排序（每次移动单张幻灯片，避免违反API的顺序规则）：

const reorderSlidesNumerically = async (slidesApi, fileID) => {
  // 获取当前幻灯片ID列表
  let currentSlideIds = await getCurrentSlideIds(slidesApi, fileID);
  // 生成目标排序后的ID列表
  const sortedIds = sortSlideIdsNumerically([...currentSlideIds]);

  // 构建批量更新请求
  const requests = [];
  sortedIds.forEach((targetSlideId, targetIndex) => {
    // 找到当前幻灯片的位置
    const currentIndex = currentSlideIds.indexOf(targetSlideId);
    // 位置不符时添加移动请求
    if (currentIndex !== targetIndex) {
      requests.push({
        updateSlidesPosition: {
          slideObjectIds: [targetSlideId],
          insertionIndex: targetIndex
        }
      });
      // 更新当前顺序缓存，避免后续索引计算出错
      currentSlideIds.splice(currentIndex, 1);
      currentSlideIds.splice(targetIndex, 0, targetSlideId);
    }
  });

  // 执行批量更新
  if (requests.length > 0) {
    await slidesApi.presentations.batchUpdate({
      presentationId: fileID,
      requestBody: { requests }
    });
  }
};

关键注意事项 #

• 每次移动幻灯片后必须更新当前ID列表缓存，否则后续索引计算会出现偏差。
• 仅对位置不符的幻灯片添加移动请求，减少不必要的API调用。
• 确保slideObjectIds仅包含存在的幻灯片ID，且无重复。

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