使用Google Apps Script获取Dropbox文件链接异常：返回文件夹链接

你的脚本返回文件夹链接而非文件链接的核心原因是：调用Dropbox API的sharing/list_shared_links接口时，默认会返回包含目标文件的所有父文件夹的共享链接，而不仅仅是文件自身的。当父文件夹已经有公开共享链接时，API就会优先返回这个文件夹链接，而非文件专属链接。

从你提供的响应也能看到，返回的links数组里的.tag是folder，说明拿到的是文件夹的共享链接。

修改getFileUrl函数，通过两个关键调整解决问题：

1. 调用list_shared_links时添加direct_only: true参数，强制API只返回直接针对目标文件的共享链接，排除父文件夹的链接。
2. 过滤返回的链接结果，只保留.tag为file的有效文件链接，避免意外拿到文件夹链接。

修改后的完整getFileUrl函数如下：

function getFileUrl(accessToken, fileId) {
  const url1 = "https://api.dropboxapi.com/2/sharing/list_shared_links";
  const res1 = UrlFetchApp.fetch(url1, {
    method: "post",
    headers: { authorization: "Bearer " + accessToken },
    contentType: "application/json",
    // 添加direct_only: true，仅获取文件自身的共享链接
    payload: JSON.stringify({ path: fileId, direct_only: true })
  });
  const obj1 = JSON.parse(res1.getContentText());
  
  // 过滤出仅文件类型的链接，避免返回文件夹链接
  const fileLinks = obj1.links.filter(link => link['.tag'] === 'file');
  if (fileLinks.length > 0) {
    return fileLinks[0].url;
  }

  // 创建文件专属的公开共享链接
  const url2 = "https://api.dropboxapi.com/2/sharing/create_shared_link_with_settings";
  const res2 = UrlFetchApp.fetch(url2, {
    method: "post",
    headers: { authorization: "Bearer " + accessToken },
    contentType: "application/json",
    payload: JSON.stringify({ 
      path: fileId, 
      settings: { 
        access: "viewer", 
        allow_download: true, 
        audience: "public", 
        requested_visibility: "public" 
      } 
    })
  });
  const obj2 = JSON.parse(res2.getContentText());
  
  // 确保返回的是文件链接（防御性判断）
  if (obj2['.tag'] === 'file') {
    return obj2.url;
  } else {
    throw new Error("创建的共享链接不是文件链接");
  }
}

• direct_only: true参数：这是Dropbox API的官方参数，指定后list_shared_links只会返回直接绑定到目标文件/文件夹的共享链接，不会返回父目录的共享链接，从根源上避免拿到文件夹链接。
• 链接类型过滤：通过filter(link => link['.tag'] === 'file')过滤结果，确保即使API返回异常结果，也不会返回文件夹链接。
• 创建链接后的验证：添加obj2['.tag'] === 'file'的判断，确保创建的是文件专属链接，避免意外错误。

• 不要硬编码accessToken在脚本里，建议通过Google Apps Script的**脚本属性（Script Properties）**存储，提高安全性。
• 如果文件数量较多，建议添加错误捕获机制，避免单个文件的API调用失败导致整个脚本终止。

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