如何捕获Google Sheets数据更新并同步至Python？

方法一：Google Apps Script + Webhook（实时触发） #

这是实现实时同步的最优方案，核心逻辑是通过Google脚本监听表格编辑事件，触发时将更新数据推送到Python服务接口。

• 步骤1：编写Google Apps Script监听编辑事件
  在目标Google Sheets中，打开「扩展程序」→「Apps Script」，粘贴以下代码：

function onEdit(e) {
  // 提取编辑事件的关键信息
  const editRange = e.range;
  const targetSheet = editRange.getSheet();
  const updatedValue = e.value;
  const rowNum = editRange.getRow();
  const colNum = editRange.getColumn();

  // 构造待发送的更新数据结构
  const payload = {
    sheetName: targetSheet.getName(),
    row: rowNum,
    column: colNum,
    newValue: updatedValue,
    updateTime: new Date().toISOString()
  };

  // 发送请求到Python服务（替换为你的公网可访问接口地址）
  const requestOptions = {
    method: "POST",
    contentType: "application/json",
    payload: JSON.stringify(payload)
  };
  UrlFetchApp.fetch("http://your-python-server.com/sheets-webhook", requestOptions);
}

保存脚本后，只要表格被编辑，该函数会自动触发，将更新数据以JSON格式发送到你的Python服务。

• 步骤2：Python端搭建Webhook接收服务
  用Flask快速实现一个接收接口：

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/sheets-webhook', methods=['POST'])
def handle_sheets_update():
    update_data = request.get_json()
    # 在这里处理同步逻辑，比如写入数据库、执行业务计算等
    print("收到表格更新：", update_data)
    return jsonify({"status": "success"}), 200

if __name__ == '__main__':
    # 本地测试可使用ngrok将端口映射为公网地址，部署后直接用服务器域名
    app.run(host='0.0.0.0', port=5000)

方法二：Google Sheets API轮询（简单替代） #

如果不需要实时同步，可通过Python定期调用API对比数据差异，实现准实时同步：

import gspread
from oauth2client.service_account import ServiceAccountCredentials
import time

# 初始化Google Sheets连接
auth_scope = ["https://spreadsheets.google.com/feeds", "https://www.googleapis.com/auth/drive"]
auth_creds = ServiceAccountCredentials.from_json_keyfile_name('your-credential-file.json', auth_scope)
client = gspread.authorize(auth_creds)
target_sheet = client.open("你的表格名称").sheet1

# 缓存初始数据快照
last_snapshot = target_sheet.get_all_values()

while True:
    current_snapshot = target_sheet.get_all_values()
    if current_snapshot != last_snapshot:
        print("检测到数据更新，开始同步...")
        # 此处可添加差异对比逻辑，仅同步变化部分
        last_snapshot = current_snapshot
    time.sleep(60)  # 每分钟检查一次，可按需调整间隔

关于ApiHooks的说明 #

你提到的ApiHooks本质是指Webhook（HTTP回调机制），方法一就是基于Webhook的实现——通过Google Script触发HTTP请求，将更新数据主动推送到Python服务，没有专门针对Google Sheets的"ApiHooks"服务。

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