Python上传Google Drive图片插入Google Doc偶现访问禁止错误

• 首要原因：Google Drive权限设置存在传播延迟。你调用permissions().create()给文件设置公开可读权限后，该权限不会立即在Google全服务节点同步，此时立刻调用Docs API插入图片，Google Docs的后端服务访问图片链接时可能还未获取到最新的权限配置，就会返回访问禁止的报错，权限同步速度受节点负载影响，因此表现为偶发错误。
• 次要原因：你使用的webContentLink本身不是无验证的直链格式，部分场景下会触发Google的身份校验拦截，即使权限设置完成也可能出现访问失败。

1. 增加权限传播校验机制 #

在设置权限后新增重试校验逻辑，确认图片可公开访问后再返回链接给插入方法使用，示例修改后的上传代码如下：

import requests
from time import sleep

def upload_files(self, filename, filepath, folder_id):
    file_metadata = {
        "name": filename,
        "parents": [folder_id]
    }
    media = MediaFileUpload(filepath + filename, resumable=True)
    file = self.drive_service.files().create(body=file_metadata, media_body=media, fields='webContentLink, id, webViewLink').execute()
    file_id = file.get('id')
    self.drive_service.permissions().create(fileId=file_id, body={'type': 'anyone', 'role': 'reader'}).execute()
    
    # 新增权限校验逻辑，最多重试5次
    direct_link = f"https://drive.google.com/uc?export=view&id={file_id}"
    max_retry = 5
    retry_count = 0
    while retry_count < max_retry:
        resp = requests.head(direct_link, allow_redirects=True)
        if resp.status_code == 200:
            break
        retry_count += 1
        sleep(1)
    return direct_link

2. 替换为图片直链格式 #

不要使用接口返回的webContentLink，直接用文件ID拼接无验证的预览直链https://drive.google.com/uc?export=view&id=你的文件ID，该格式跳过Drive的文件预览页中间跳转，不会触发额外的身份校验，插入Docs的成功率更高。

3. 可选：增加插入失败重试逻辑 #

如果偶发错误仍然存在，可以在insert_image方法外层加重试逻辑，遇到400权限相关错误时等待1秒后重试2-3次，基本可以覆盖所有权限延迟场景。

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