我来帮你一步步排查这个问题，结合你描述的场景，核心矛盾是API返回正确响应但日历没出现在CalendarList里，且accessRole为reader，下面是具体的分析和解决思路：

1. 先明确CalendarList.insert的核心逻辑 #

首先要理清：CalendarList是当前身份（这里是你的服务账户）专属的日历列表，和用户个人的Google日历列表完全独立。调用calendarList.insert并不是“接受共享请求”——接受共享的操作是用户在自己的日历设置里完成的（把服务账户邮箱添加为共享成员并授予权限），这个API只是把已经共享给服务账户的日历，添加到服务账户自己的CalendarList中方便后续调用。

2. 排查权限相关的两个关键节点 #

（1）服务账户的API授权Scope是否足够 #

你使用的oauth2client身份验证中，必须确保请求的Scope包含修改CalendarList的权限。如果只请求了calendar.readonly，即使能读取日历数据，也没有权限修改自己的CalendarList（包括插入操作）。

正确的Scope应该包含https://www.googleapis.com/auth/calendar（读写权限），示例代码如下：

from oauth2client.service_account import ServiceAccountCredentials
from googleapiclient.discovery import build

# 必须包含calendar权限，而不仅仅是readonly
SCOPES = ['https://www.googleapis.com/auth/calendar']
credentials = ServiceAccountCredentials.from_json_keyfile_name('你的服务账户密钥文件.json', SCOPES)
service = build('calendar', 'v3', credentials=credentials)

（2）用户授予服务账户的共享权限是否达标 #

虽然reader理论上足够将日历添加到CalendarList，但有些场景下（比如非G Suite服务账户访问个人用户的共享日历），可能需要更高的权限（比如writer）才能完成插入操作。你可以让用户临时将共享权限提升为writer，测试是否能成功插入，以此排除权限等级的问题。

3. 验证插入后的实际状态 #

API返回成功响应但日历没出现在列表里，可能是你用错了身份去查询列表？请务必用同一个服务账户的credentials调用calendarList.list来验证：

# 插入日历
insert_response = service.calendarList().insert(body={'id': '用户提供的共享日历ID'}).execute()
print("插入响应:", insert_response)

# 立即查询CalendarList，确认是否存在
list_response = service.calendarList().list().execute()
print("当前CalendarList中的日历:", [item['id'] for item in list_response.get('items', [])])

注意：非G Suite服务账户的CalendarList是独立的，你在自己的Google日历网页端看不到这个列表，只能通过API查询。

4. 非G Suite服务账户的特殊限制 #

因为你的服务账户不属于G Suite，还有两个需要注意的点：

• 用户必须直接将服务账户的邮箱添加为共享成员，不能使用“所有人可查看”这类泛权限设置，否则服务账户可能无法识别到共享日历。
• 服务账户无法接收共享请求通知，所以用户必须主动完成共享授权，不能发送“请求访问”的邀请，服务账户没有界面去接受邀请。

5. 排查响应中的accessRole是否准确 #

如果调用calendars.get返回的accessRole确实是reader，可以先调用calendarList.get（传入共享日历ID）看看是否已经存在于列表中——有时候API返回的插入响应可能是缓存，实际已经存在但你没注意到。

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