如何在Electron+Node.js中使用Google Drive API v3重命名文件？

首先得明确，API v3和v2有个关键差异：文件标题字段从 title 改成了 name，而且Node.js/Electron环境下我们有更顺手的库可以用，不用像v2示例那样直接调用gapi客户端。下面给你两种实现方案，包括官方推荐的库和你提到的mfm-gdrive。

方案一：使用官方 googleapis 库（更稳定，官方维护） #

这是Google官方提供的Node.js客户端库，适配性最好，适合Electron桌面应用的用户授权场景。

步骤1：安装依赖 #

打开终端执行：

npm install googleapis

步骤2：配置认证 #

Electron应用通常用OAuth2让用户自己授权访问Drive，你需要先在Google Cloud控制台创建OAuth2客户端，拿到客户端ID、密钥和重定向URI。然后初始化客户端：

const { google } = require('googleapis');

// 替换成你自己的OAuth2信息
const oauth2Client = new google.auth.OAuth2(
  '你的客户端ID',
  '你的客户端密钥',
  '你的重定向URI'
);

// 这里需要处理用户授权流程（比如在Electron中打开授权页面获取token）
// 假设已经拿到了用户的access_token和refresh_token，直接设置
oauth2Client.setCredentials({
  access_token: '用户授权后的access_token',
  refresh_token: '用户授权后的refresh_token'
});

// 初始化Drive客户端
const drive = google.drive({ version: 'v3', auth: oauth2Client });

步骤3：实现重命名函数 #

这个函数和v2的示例逻辑对应，用async/await更符合Node.js的异步风格：

/**
 * 重命名Google Drive文件（API v3）
 * @param {string} fileId 要修改的文件ID
 * @param {string} newName 文件的新名称
 * @returns {Promise<Object>} 更新后的文件信息
 */
async function renameFile(fileId, newName) {
  try {
    const response = await drive.files.update({
      fileId: fileId,
      requestBody: {
        name: newName // 注意这里是name，不是v2的title
      },
      fields: 'name' // 可选：只返回name字段，减少响应数据量
    });

    console.log(`文件重命名成功！新名称：${response.data.name}`);
    return response.data;
  } catch (error) {
    console.error(`重命名失败：${error.message}`);
    throw error;
  }
}

方案二：使用 mfm-gdrive 库（封装更简洁） #

如果你已经在尝试mfm-gdrive，这个库封装了很多细节，用起来更轻便，适合快速开发。

步骤1：安装依赖 #

npm install mfm-gdrive

步骤2：初始化客户端 #

mfm-gdrive支持服务账号或OAuth2认证，这里以服务账号为例（适合后台操作，需要提前把文件共享给服务账号邮箱）：

const { GoogleDrive } = require('mfm-gdrive');

// 替换成你的服务账号密钥文件路径，或者直接传入密钥对象
const drive = new GoogleDrive({
  keyFile: './service-account-key.json'
});

步骤3：实现重命名函数 #

/**
 * 用mfm-gdrive重命名Google Drive文件
 * @param {string} fileId 要修改的文件ID
 * @param {string} newName 文件的新名称
 * @returns {Promise<Object>} 更新后的文件信息
 */
async function renameFileWithMfm(fileId, newName) {
  try {
    const updatedFile = await drive.updateFile(fileId, {
      name: newName
    });

    console.log(`文件重命名成功！新名称：${updatedFile.name}`);
    return updatedFile;
  } catch (error) {
    console.error(`重命名失败：${error.message}`);
    throw error;
  }
}

额外提示 #

• 如果你是Electron桌面应用，OAuth2授权流程可以通过打开一个子窗口加载Google的授权页面，获取授权码后再交换成token，这样用户就能授权访问自己的Drive文件。
• API v3中files.patch和files.update都能用来修改文件名，两者的区别是patch只更新指定字段，update会替换整个资源，但只传name字段时效果是一样的。
• 服务账号模式不需要用户手动授权，但需要确保目标文件已经共享给服务账号的邮箱地址。

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