Python Google Sheets API更新无效果且无报错的解决方法

你的代码存在几个关键问题，导致更新操作无效果：

1. API请求未实际发送：Google Sheets API的update方法返回的是请求对象，必须调用.execute()才会真正向服务器发送更新请求。
2. values格式不符合要求：API要求values是二维数组（对应行和列结构），你直接传入字符串，无法被正确解析。
3. 行索引获取可能出错：使用values.index(available[choice])会返回第一个匹配元素的索引，若表格存在重复行，会更新错误的行。
4. 更新范围与目标不匹配：你注释中提到要将状态改为"Unavailable"，但当前代码的更新范围指向A列，且values内容不符合需求。

修复后的完整代码 #

import os
import random
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from google.auth.transport.requests import Request

# 请确保以下变量已正确定义
SCOPES = ["https://www.googleapis.com/auth/spreadsheets"]
SPREADSHEET_ID = "你的表格ID"
calamity_allowSheetUpdate = {"允许更新的UID列表"}

def getitem(ctxuid):
    creds = None
    if os.path.exists("token.json"):
        creds = Credentials.from_authorized_user_file("token.json", SCOPES)
    if not creds or not creds.valid:
        if creds and creds.expired and creds.refresh_token:
            creds.refresh(Request())
        else:
            flow = InstalledAppFlow.from_client_secrets_file(
                "credentials.json", SCOPES
            )
            creds = flow.run_local_server(port=0)
        # 仅在creds更新后写入token，避免覆盖有效凭证
        with open("token.json", "w") as token:
            token.write(creds.to_json())

    try:
        service = build("sheets", "v4", credentials=creds)
        sheet = service.spreadsheets()

        # 获取表格数据
        result = sheet.values().get(
            spreadsheetId=SPREADSHEET_ID, range="Sheet1!A2:C101"
        ).execute()
        values = result.get("values", [])
        available = []
        # 同时记录行索引和数据，避免重复行导致索引错误
        for idx, row in enumerate(values):
            # 增加列数判断，避免索引越界
            if len(row) >= 3 and row[2] == "Available":
                available.append( (idx, row) )
        
        if not available:
            return "没有可用项"
        
        # 随机选择可用项
        choice_idx, chosen_row = random.choice(available)
        # 计算实际行号（从A2开始，所以索引+2）
        actual_row = choice_idx + 2

        if ctxuid in calamity_allowSheetUpdate:
            # 准备更新数据：将C列状态改为Unavailable
            update_values = [
                [chosen_row[0], chosen_row[1], "Unavailable"]
                # 若仅需更新C列，可改为 [["Unavailable"]]，同时range设为f"Sheet1!C{actual_row}"
            ]
            cal_vals_rangeBody = {
                'majorDimension': "ROWS",
                'values': update_values
            }
            # 必须调用execute()发送更新请求
            sheet.values().update(
                spreadsheetId=SPREADSHEET_ID,
                range=f"Sheet1!A{actual_row}:C{actual_row}",
                valueInputOption="USER_ENTERED",
                body=cal_vals_rangeBody
            ).execute()

        return f"### The shaboingery gods have chosen...\n# {chosen_row[0]}\n## {chosen_row[1]}"
    except Exception as e:
        # 捕获异常便于排查问题
        return f"出错了: {str(e)}"

关键修改说明 #

• 添加.execute()：在update方法末尾加上.execute()，确保更新请求发送到Google服务器。
• 修正values格式：将values改为二维数组，匹配表格的行结构，让API能正确解析。
• 正确获取行索引：使用enumerate遍历行时同步记录原始索引，避免重复行导致的索引错误。
• 明确更新范围：若更新整行，范围设为A{row}:C{row}；若仅更新状态列，可将范围改为C{row}，同时values改为[["Unavailable"]]。
• 优化token写入逻辑：仅在凭证更新后写入token，避免覆盖有效凭证。
• 增加异常捕获：添加try-except块捕获错误，方便排查后续问题。

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