Youtube Data API批量更新缩略图后触发403权限禁止问题

问题本质 #

你遇到的403 PERMISSION_DENIED错误并非真的权限失效，而是触发了YouTube Data API的每日配额限制。当单日API请求配额耗尽时，系统会返回这个易误导的错误提示，且配额会在UTC时间每日零点自动重置，这就是为什么24小时后功能恢复正常。

原因解析 #

YouTube Data API对每个授权账号（或关联的Google Cloud项目）设定了每日请求配额，thumbnails.set这类修改型接口每次调用会消耗比读接口更高的配额。你的批量更新操作在执行约100次后耗尽了当日配额，因此触发了限制。

解决办法 #

• 拆分批量任务：将100+次的更新操作拆分到多个自然日执行，每日执行量控制在配额剩余范围内，避免单日耗尽。
• 过滤无效请求：提前检查视频当前缩略图状态，跳过已符合目标的视频，减少不必要的API调用。
• 申请配额提升：如果业务需要更高的每日配额，可通过Google Cloud控制台提交配额提升申请，说明具体业务场景和需求。
• 添加智能重试逻辑：在代码中加入针对配额耗尽错误的重试机制，等待到配额重置后继续执行。修改后的示例代码：

import time
import os
from googleapiclient.errors import HttpError

def update_thumbnail_on_youtube(video, path):
    try:            
        request = youtube.thumbnails().set(videoId=video['id'], alt="media", media_body=MediaFileUpload(path))
        response = request.execute()
        print(response)
    except HttpError as e:
        if e.resp.status == 403 and "PERMISSION_DENIED" in str(e):
            # 计算距离次日UTC零点的等待时间
            now = time.time()
            seconds_until_midnight_utc = 86400 - (now % 86400)
            print(f"当日配额耗尽，等待{int(seconds_until_midnight_utc/3600)}小时后恢复执行")
            time.sleep(seconds_until_midnight_utc)
            # 配额重置后重试一次
            request = youtube.thumbnails().set(videoId=video['id'], alt="media", media_body=MediaFileUpload(path))
            response = request.execute()
            print(response)
        else:
            raise e
    except Exception as e:
        raise e
    finally:
        os.remove(path)

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