使用Google API Python SDK迁移谷歌日历事件失败求助

问题根源分析 #

你遇到的两个错误本质都是权限问题：

• "You need to have reader access to this calendar"：当前操作的账号没有源日历（email_from）的读取权限。
• "Forbidden"：你尝试给源日历添加ACL规则，但操作账号没有源日历的管理权限，无法修改其访问控制列表。

不管用普通凭据还是服务账号，核心前提是：操作身份必须拥有源日历的至少编辑权限（因为move操作相当于从源日历删除事件并在目标日历创建，需要源日历的修改权限）。

正确实现步骤 #

一、先确保权限到位 #

1. 普通凭据方式：
   打开谷歌日历，找到源日历（email_from对应的日历），给你用来授权的普通账号共享编辑权限（不是只读）。
2. 服务账号方式：
   • 必须在Google Workspace后台给服务账号配置域范围委派，授予https://www.googleapis.com/auth/calendar权限。
   • 用来委派的用户（delegated_user）必须是拥有源日历编辑权限的账号（比如源日历所有者，或已被共享编辑权限的用户）。
   • 无需单独给服务账号邮箱共享日历权限，因为是通过委派用户身份操作的。

二、修正后的迁移代码 #

移除无效的ACL操作，加入分页处理（谷歌日历API默认只返回250个事件，需处理分页获取所有事件）：

def merge_calendar(email_from, email_to, service):
    # 分页获取所有事件
    off_board_user_events = []
    page_token = None
    while True:
        calendar_events = service.events().list(
            calendarId=email_from,
            pageToken=page_token
        ).execute()
        off_board_user_events.extend(calendar_events.get('items', []))
        page_token = calendar_events.get('nextPageToken')
        if not page_token:
            break

    # 迁移每个事件
    for event in off_board_user_events:
        try:
            # 移动事件：从源日历转移到目标日历
            updated_event = service.events().move(
                calendarId=email_from,
                eventId=event['id'],
                destination=email_to
            ).execute()
            print(f'事件已迁移: {updated_event["updated"]}')
        except Exception as e:
            print(f'迁移事件 {event.get("summary", "无标题")} 失败: {str(e)}')

    print('所有事件迁移完成。')

三、凭据配置注意事项 #

• 普通凭据：确保授权流程中请求的SCOPES包含'https://www.googleapis.com/auth/calendar'，且授权时同意了该权限范围。如果之前的token.json权限不足，删除文件重新授权。
• 服务账号：确保service.json路径正确，delegated_user是域内有权限的用户邮箱，且域委派已正确配置（需Google Workspace管理员操作）。

额外说明 #

• 如果不需要删除源日历的事件，可改用copy方法替代move，此时操作账号只需源日历的只读权限：

  updated_event = service.events().copy(
      calendarId=email_from,
      eventId=event['id'],
      body={'calendarId': email_to}
  ).execute()
  

• 重复事件的迁移：move操作默认会移动整个事件系列，若需迁移单个实例，需指定recurrenceId和originalStartTime参数。

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