当使用Python的gspread_asyncio库结合Google服务账户（Service Account）创建Google Sheets电子表格时，一个常见的问题是，虽然服务账户成功创建了电子表格并返回了链接，但其他用户（包括服务账户所关联的Google Cloud项目拥有者）却无法打开或编辑该表格，提示“没有权限”。
这背后的原因是：
因此，要解决这个问题，我们需要在电子表格创建后，显式地为目标用户或群组授予相应的访问权限。
解决此问题的关键在于利用Google Drive API。Google Drive API提供了丰富的功能来管理Google Drive中的文件和文件夹，包括设置共享权限。由于Google Sheets本质上是存储在Google Drive中的一种文件类型，我们可以通过Drive API来修改其权限设置。
立即学习“Python免费学习笔记（深入）”；
具体步骤如下：
以下是整合了权限管理功能的Python代码示例，它在创建Google Sheets并上传数据后，立即为指定用户授予编辑权限。
除了gspread_asyncio、io、csv和google.oauth2.service_account外，我们还需要导入googleapiclient.discovery来构建Google Drive API客户端。
from gspread_asyncio import AsyncioGspreadClientManager import io import csv from google.oauth2 import service_account from gspread.exceptions import SpreadsheetNotFound from googleapiclient.discovery import build # 导入构建API客户端的模块
确保服务账户凭据拥有足够的权限来访问Google Sheets API和Google Drive API。这意味着在创建服务账户时，需要为其分配包含https://www.googleapis.com/auth/drive和https://www.googleapis.com/auth/spreadsheets（或更宽泛的https://www.googleapis.com/auth）的OAuth 2.0 Scope。
async def upload_file_to_gsheets(credentials_path, csv_string, spreadsheet_name, target_user_email):
try:
# 定义所需的API范围
scopes = [
'https://www.googleapis.com/auth/spreadsheets', # 用于gspread操作
'https://www.googleapis.com/auth/drive' # 用于Google Drive API操作，包括权限管理
]
credentials = service_account.Credentials.from_service_account_file(credentials_path, scopes=scopes)
# 初始化gspread_asyncio客户端
agcm = AsyncioGspreadClientManager(lambda: credentials)
gc_client = await agcm.authorize()
# 初始化Google Drive API客户端
drive_service = build('drive', 'v3', credentials=credentials)这部分与原始代码相同，用于处理电子表格的创建或查找。
try:
spreadsheet = await gc_client.open(spreadsheet_name)
except SpreadsheetNotFound:
spreadsheet = await gc_client.create(spreadsheet_name)
worksheet = await spreadsheet.get_worksheet(0)
# 读取CSV数据并更新工作表
csv_file = io.StringIO(csv_string)
reader = csv.reader(csv_file)
values_list = list(reader)
await worksheet.update('A1', values_list)这是解决问题的核心部分。我们定义一个权限对象，然后调用drive_service.permissions().create()方法。
# 定义要授予的权限
# 'type': 'user' 表示授予给特定用户
# 'role': 'writer' 表示授予编辑权限。注意：服务账户不能将自身设置为其他用户的'owner'。
# 'emailAddress': 替换为需要获得权限的用户的真实邮箱地址
user_permission = {
'type': 'user',
'role': 'writer',
'emailAddress': target_user_email # 替换为实际用户的邮箱地址
}
# 授予权限
# fileId: 电子表格的ID，可以通过spreadsheet.id获取
# body: 包含权限信息的字典
# fields: 指定返回的响应字段，这里只需要id
drive_service.permissions().create(
fileId=spreadsheet.id,
body=user_permission,
fields='id'
).execute() # 执行API请求
spreadsheet_url = spreadsheet.url
return spreadsheet_url
except Exception as error:
print(f"操作失败: {error}")
return None将以上所有部分整合到一个完整的异步函数中：
from gspread_asyncio import AsyncioGspreadClientManager
import io
import csv
from google.oauth2 import service_account
from gspread.exceptions import SpreadsheetNotFound
from googleapiclient.discovery import build # 导入构建API客户端的模块
async def upload_file_to_gsheets_with_permissions(credentials_path: str,
csv_string: str,
spreadsheet_name: str,
target_user_email: str) -> str:
"""
使用服务账户创建Google Sheets，上传CSV数据，并为指定用户授予编辑权限。
Args:
credentials_path (str): 服务账户JSON密钥文件的路径。
csv_string (str): 包含CSV数据内容的字符串。
spreadsheet_name (str): 要创建或更新的电子表格名称。
target_user_email (str): 需要授予编辑权限的用户的邮箱地址。
Returns:
str: 创建或更新的电子表格的URL，如果操作失败则返回None。
"""
try:
# 定义所需的API范围
scopes = [
'https://www.googleapis.com/auth/spreadsheets', # 用于gspread操作
'https://www.googleapis.com/auth/drive' # 用于Google Drive API操作，包括权限管理
]
credentials = service_account.Credentials.from_service_account_file(credentials_path, scopes=scopes)
# 1. 初始化gspread_asyncio客户端
agcm = AsyncioGspreadClientManager(lambda: credentials)
gc_client = await agcm.authorize()
# 2. 初始化Google Drive API客户端
drive_service = build('drive', 'v3', credentials=credentials)
# 3. 创建或打开电子表格
try:
spreadsheet = await gc_client.open(spreadsheet_name)
print(f"电子表格 '{spreadsheet_name}' 已存在，将进行更新。")
except SpreadsheetNotFound:
spreadsheet = await gc_client.create(spreadsheet_name)
print(f"电子表格 '{spreadsheet_name}' 已创建。")
# 获取第一个工作表并更新数据
worksheet = await spreadsheet.get_worksheet(0)
csv_file = io.StringIO(csv_string)
reader = csv.reader(csv_file)
values_list = list(reader)
await worksheet.update('A1', values_list)
print("数据已成功上传到电子表格。")
# 4. 授予权限
user_permission = {
'type': 'user',
'role': 'writer', # 'reader' for view-only, 'writer' for edit
'emailAddress': target_user_email
}
# 尝试授予权限，如果该用户已经有权限，可能会抛出错误，但通常不影响后续操作
try:
drive_service.permissions().create(
fileId=spreadsheet.id,
body=user_permission,
fields='id'
).execute()
print(f"已成功为用户 '{target_user_email}' 授予编辑权限。")
except Exception as perm_error:
print(f"授予权限失败或用户已有权限: {perm_error}")
spreadsheet_url = spreadsheet.url
print(f"电子表格URL: {spreadsheet_url}")
return spreadsheet_url
except Exception as error:
print(f"操作失败: {error}")
return None
# 示例用法 (需要运行在一个异步环境中，例如使用asyncio.run())
# import asyncio
# async def main():
# credentials_path = 'path/to/your/service_account_key.json' # 替换为你的服务账户密钥文件路径
# csv_data = "Header1,Header2\nValue1,Value2\nValue3,Value4"
# spreadsheet_name = "MyAutomatedSheet"
# target_email = "your_user_email@example.com" # 替换为你要共享的用户的邮箱
# url = await upload_file_to_gsheets_with_permissions(credentials_path, csv_data, spreadsheet_name, target_email)
# if url:
# print(f"电子表格已创建并共享: {url}")
# else:
# print("操作未能完成。")
# if __name__ == "__main__":
# asyncio.run(main())通过服务账户创建Google Sheets并自动解决权限问题，关键在于理解服务账户的默认行为以及如何利用Google Drive API来扩展其功能。通过在创建电子表格后立即编程授予指定用户权限，我们可以确保自动化流程生成的资源能够无缝地融入团队协作工作流中，提高效率并避免手动权限设置的繁琐。
以上就是如何使用Python服务账户解决Google Sheets权限问题的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
752
收藏
