如何在Tampermonkey JS脚本中使用GAPI调用Google Sheets API？

你注入的api.js不会立刻挂载完整的gapi对象，它的核心模块和Sheets服务都是异步加载的，必须等初始化流程走完才能调用相关接口。

1. 保留现有依赖配置 #

你原来的头部配置无需修改，继续保留：

// @require      https://apis.google.com/js/api.js

2. 新增gapi初始化逻辑 #

你需要先完成gapi加载+Sheets服务注册，再执行读写操作，完整实现代码如下：

// 初始化状态标记，避免重复加载
let gapiInitialized = false;
// 替换为你自己的Google Cloud API密钥，需提前开通Sheets API
const GOOGLE_API_KEY = "你的API密钥";

// 初始化gapi工具函数
function initGapi(onFinish) {
  if (gapiInitialized) {
    onFinish();
    return;
  }
  // 等待gapi基础模块加载完成
  gapi.load("client", async () => {
    // 加载Sheets v4服务
    await gapi.client.init({
      apiKey: GOOGLE_API_KEY,
      discoveryDocs: ["https://sheets.googleapis.com/$discovery/rest?version=v4"]
    });
    gapiInitialized = true;
    onFinish();
  });
}

3. 修改你的getValues函数 #

把原来的逻辑包在初始化完成的回调里，确保调用时gapi已经就绪：

function getValues(spreadsheetId, range, callback) {
  initGapi(() => {
    gapi.client.sheets.spreadsheets.values.get({
      spreadsheetId: spreadsheetId,
      range: range
    }).then((response) => {
      const result = response.result;
      const numRows = result.values ? result.values.length : 0;
      console.log(`${numRows} rows retrieved.`);
      callback(response);
    });
  });
}

注意事项 #

• 如果需要写入私有表格数据，除了API密钥外还需要额外添加OAuth2授权逻辑，获取用户的表格编辑权限
• 不要在脚本初始化阶段直接调用getValues，建议绑定到页面加载完成事件或者用户操作事件触发，避免加载时序问题

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