Google Drive Sheets (谷歌驱动器表格)是一款功能强大的电子表格系统，不仅可以方便地对数据进行管理和分析，还可以进行协作与共享。而 google-drive-sheets 是一款 npm 包，可以用于在前端 JavaScript 中使用 Google Drive Sheets 的 API。在本篇文章中，我们将详细介绍如何使用这个 npm 包，并提供示例代码。
1. 安装
首先需要安装 npm 包：
npm install google-drive-sheets
2. 认证
使用 google-drive-sheets 前，需要先进行认证。这里我们使用 Google API 来完成认证。
2.1 创建 Google Cloud 项目
在 Google Cloud Console 中创建一个新的项目：
- 点击“Select a project” (选择项目)
- 点击“New Project” (新建项目)
- 输入项目名称，点击“Create” (创建)
2.2 启用 Google Sheets API
在谷歌云平台中，左边导航栏中可以找到“API 和服务”(APIs & Services)：
- 找到“Dashboard”页面，点击“+ ENABLE APIS AND SERVICES”按钮。
- 搜索“Google Sheets API”并点击“ENABLE”。
2.3 创建凭证
接下来创建凭证：
- 打开“Credentials” 页面：
- 在 API 和服务首页，点击“Credentials”菜单，然后再点击“Create credentials”按钮。
- 选择“Service account key”选项。
- 为服务帐户输入名称，选择“JSON”作为密钥类型，并点击“Create”按钮。
- 下载 JSON 凭证文件。
2.4 使用凭密文件进行身份验证
在项目中，需要将凭证文件的内容载入到代码中。Google API 提供了 google-auth-library 包，我们可以使用它的 auth.fromJSON 方法来进行身份验证：
-- -------------------- ---- ------- ----- -------- - ---------------------- ----- -- - -------------- ----- ----------- - -------------------------------------------------------- ----- ---- - --- ------------------------ ------------ ------- ----------------------------------------- ------------------------------------------------ --- ----- ------ - ----------------------- ----- ------- -- - ------ ------ --- ----
这里，我们还需要指定好我们希望 API 可以访问的范围，这些范围用“scope”来表示，可以通过 scopes 属性指定。
3. 操作 Google Sheets
3.1 获取电子表格
要获取电子表格，我们需要知道电子表格的 ID：
- 在 Google Sheets 中打开表格。
- 从 URL 中获取 ID。
现在我们可以使用该 ID 来获取该表格，如果该表格是公开的，则可以直接访问：
sheets.spreadsheets.values.get({
spreadsheetId: 'SPREADSHEET_ID',
range: 'SHEET1!A1:B2',
}, (err, res) => {
if (err) return console.error(err);
console.log(res.data.values);
});这里，我们使用 sheets.spreadsheets.values.get 方法获取指定表格的单元格数据。需要传递这些参数:
spreadsheetId：电子表格 ID。range：要读取的电子表格范围。
3.2 写入电子表格
写入电子表格需要使用 sheets.spreadsheets.values.update 方法：
-- -------------------- ---- ------- ----- ------ - - ------ ------ ------ ------ -- ----------------------------------- -------------- ----------------- ------ --------------- ----------------- --------------- --------- - ------ -- -- ----- --------- -- - -- ----- ------ ------------------- --------------------------- ---
这里，我们使用 sheets.spreadsheets.values.update 方法，将数据写入特定的电子表格和特定的范围中。重要参数：
spreadsheetId：电子表格 ID。range：要写入的电子表格范围。valueInputOption：指定输入数据格式。在此示例中，我们使用了“USER_ENTERED”格式，可以将数据视为 人类输入。resource：包含要写入电子表格的数据。在本例中，我们将“values”属性设置为刚刚创建的二维数组。
4. 结论
到这里，本文介绍了如何在前端应用程序中使用 google-drive-sheets。虽然我们只介绍了其中的一部分 API，但是掌握这些知识已经足够了。希望这篇文章能够对你有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/google-drive-sheets