使用Python调用Google Drive API v3转移文件所有权时遭遇pendingOwnerWriterRequired 403权限错误的求助

我之前帮别人排查过一模一样的问题，这个错误的核心逻辑其实很明确：目标用户必须先实实在在拥有文件的编辑权限，才能被设置为待转移的所有者。你说已经给了编辑权限但还是报错，大概率是Google Drive的权限同步有延迟，或者你的代码逻辑里没有等权限生效就立刻触发了所有权转移。

下面是几个经过验证的解决方案，按优先级排序：

1. 给权限变更加等待/校验逻辑 #

Google Drive的权限变更不是实时生效的，尤其是跨个人账号或者团队盘的场景，系统需要几秒到几十秒的同步时间。你可以在设置完编辑权限后，先循环检查目标用户的权限状态，确认已经是writer角色后，再执行所有权转移。

先加一个权限检查的辅助函数：

def check_target_has_writer_permission(drive_service, file_id, target_email):
    try:
        resp = drive_service.permissions().list(
            fileId=file_id,
            supportsAllDrives=True,
            fields="permissions(emailAddress,role)"
        ).execute()
        for perm in resp.get("permissions", []):
            if perm.get("emailAddress") == target_email and perm.get("role") == "writer":
                return True
        return False
    except HttpError as e:
        logging.error(f"检查文件 {file_id} 的权限失败: {str(e)}")
        return False

然后在你的代码流程里，设置完编辑权限后加入等待逻辑：

# 先给目标账号添加编辑权限（这里假设你已经有对应的add_permission函数）
add_writer_permission(service, file_id, args.target_owner_email, args.send_notification_email)

# 等待权限生效，最多等2分钟
wait_seconds = 0
max_wait = 120
while wait_seconds < max_wait:
    if check_target_has_writer_permission(service, file_id, args.target_owner_email):
        logging.info(f"文件 {file_id} 的编辑权限已生效，开始转移所有权")
        break
    time.sleep(10)
    wait_seconds += 10
    logging.info(f"等待权限生效中，已等待 {wait_seconds} 秒...")

if wait_seconds >= max_wait:
    logging.error(f"文件 {file_id} 的权限未在规定时间内生效，跳过所有权转移")
    continue

# 这里再执行你的所有权转移逻辑

2. 确认编辑权限的设置逻辑正确 #

检查你设置编辑权限的代码，确保这几个关键点：

• 角色是writer，而不是commenter或者reader
• 调用permissions().create时，明确设置了supportsAllDrives=True（如果文件在团队盘或者共享驱动器中）
• 没有错误地添加transferOwnership=True参数（这个参数只在转移所有权的请求中使用）

正确的编辑权限创建代码示例：

def add_writer_permission(drive_service, file_id, target_email, send_notifications):
    try:
        permission_body = {
            "type": "user",
            "role": "writer",
            "emailAddress": target_email
        }
        return drive_service.permissions().create(
            fileId=file_id,
            body=permission_body,
            supportsAllDrives=True,
            sendNotificationEmail=send_notifications
        ).execute()
    except HttpError as e:
        logging.error(f"给文件 {file_id} 添加编辑权限失败: {str(e)}")
        return None

3. 调整批量操作的节奏 #

如果是批量处理大量文件，不要同时给所有文件加权限然后立刻批量转移所有权。这样不仅容易触发Google的速率限制，还会加剧权限同步的延迟问题。建议：

• 单个文件串行处理：先处理完一个文件的权限设置+所有权转移，再处理下一个
• 在每个文件的处理流程之间添加随机间隔（比如3-8秒），避免被Google的API限流

4. 排查目标账号的状态 #

最后确认一下目标账号的状态：

• 目标账号没有屏蔽源账号的邮件（如果开启了通知邮件的话）
• 目标账号处于正常状态，没有被限制使用Google Drive
• 目标账号可以正常接收来自其他账号的共享邀请

按照上面的步骤调整后，应该就能解决这个403错误了。

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