如何基于Google Sheets API v4开发支持账号认证与表格管理的应用？

1. Google账号身份认证 #

核心采用OAuth 2.0授权流程，这是访问用户私有Google资源的标准方式：

• 登录Google Cloud控制台，创建新项目，启用Google Sheets API和Google Drive API（列表格依赖Drive API）
• 进入「API和服务」→「凭据」，创建OAuth 2.0客户端ID，配置授权回调地址（根据应用类型：Web/桌面/移动端）
• 选择对应语言的Google客户端库（如Python的google-auth/google-auth-oauthlib，前端的gapi.auth2）实现授权流程，需请求以下核心权限范围：
  • https://www.googleapis.com/auth/spreadsheets：读写表格数据
  • https://www.googleapis.com/auth/drive.readonly：获取用户所有表格列表（若需创建/删除表格，改用https://www.googleapis.com/auth/drive）
• 授权完成后，会获取访问令牌和刷新令牌，用于后续API请求的身份验证

示例代码（Python） #

from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# 定义权限范围
SCOPES = ["https://www.googleapis.com/auth/spreadsheets", "https://www.googleapis.com/auth/drive.readonly"]

def authenticate():
    flow = InstalledAppFlow.from_client_secrets_file("credentials.json", SCOPES)
    creds = flow.run_local_server(port=0)
    # 保存凭据以便下次使用
    with open("token.json", "w") as token:
        token.write(creds.to_json())
    return creds

# 初始化API服务
creds = authenticate()
sheets_service = build("sheets", "v4", credentials=creds)
drive_service = build("drive", "v3", credentials=creds)

2. 获取用户关联的Google表格列表 #

通过Drive API的files.list方法筛选所有表格类型的文件：

• 调用时指定q参数过滤MIME类型为表格的文件：mimeType='application/vnd.google-apps.spreadsheet'
• 通过fields参数指定返回字段（避免冗余数据），例如files(id,name,createdTime,modifiedTime)

示例代码（Python） #

def list_spreadsheets():
    results = drive_service.files().list(
        q="mimeType='application/vnd.google-apps.spreadsheet'",
        fields="files(id,name,createdTime,modifiedTime)"
    ).execute()
    items = results.get("files", [])
    return items

# 调用示例
spreadsheets = list_spreadsheets()
for sheet in spreadsheets:
    print(f"名称: {sheet['name']}, ID: {sheet['id']}, 最后修改时间: {sheet['modifiedTime']}")

3. 表格编辑、更新与创建 #

创建新表格并录入数据 #

• 用Sheets API的spreadsheets.create创建空白表格，可指定标题
• 用spreadsheets.values.update或spreadsheets.values.append写入数据，需指定表格ID、数据范围（如'A1'）和值输入选项（USER_ENTERED会自动解析格式，如日期、公式）

编辑更新已有表格 #

• 用spreadsheets.values.get读取指定范围的数据
• 用spreadsheets.values.update修改指定范围内容；若需批量操作（如修改格式、插入行），使用spreadsheets.batchUpdate

示例代码（Python） #

# 创建新表格
def create_spreadsheet(title):
    spreadsheet = sheets_service.spreadsheets().create(body={"properties": {"title": title}}).execute()
    return spreadsheet["spreadsheetId"]

# 向表格写入数据
def write_data(spreadsheet_id, range_name, values):
    body = {"values": values}
    result = sheets_service.spreadsheets().values().update(
        spreadsheetId=spreadsheet_id, range=range_name,
        valueInputOption="USER_ENTERED", body=body
    ).execute()
    return result

# 更新已有表格数据
def update_data(spreadsheet_id, range_name, values):
    return write_data(spreadsheet_id, range_name, values)

# 调用示例
new_sheet_id = create_spreadsheet("我的新表格")
write_data(new_sheet_id, "A1:C2", [["姓名", "年龄", "邮箱"], ["张三", 25, "zhangsan@example.com"]])

关键注意事项 #

• 确保OAuth授权流程中向用户清晰说明权限用途，避免被Google拦截
• 处理令牌过期：使用刷新令牌自动获取新的访问令牌
• 对于大规模数据操作，优先使用批量接口（batchUpdate）以减少API请求次数

内容的提问来源于stack exchange，提问作者Md. Shishir Ahmed