如何降低YouTube Data API v3查询配额消耗？配额计算疑问

一、配额计算核心规则 #

YouTube Data API的配额并非按请求次数统计，而是按接口的"单位成本"累加计算，不同接口的资源消耗差异极大：

• 你当前使用的search.list接口，单请求配额成本为100单位——这是配额消耗过快的核心原因，因为该接口需要遍历YouTube全局内容索引，资源开销远高于其他接口
• 对比低成本接口：channels.list、playlistItems.list等接口单请求仅消耗1配额单位

你的场景中，161次search.list请求理论上会消耗16100配额，实际消耗6100可能是部分请求未返回完整结果、或存在中断，但核心问题仍在于search.list的高成本属性。

二、你的代码配额消耗分析 #

用search.list获取频道视频时：

• 按maxResults=50计算，获取3500个视频需要约70次请求，单次100单位的成本累加后就是7000配额，与你观测到的6100消耗基本吻合
• 多次运行会快速累积配额，小型频道两次运行触顶也符合search.list的高成本特性

三、低成本优化方案 #

核心思路是替换高成本的search.list，改用**"频道信息+播放列表遍历"的接口组合**，配额消耗可降低至原方案的1%左右：

1. 获取频道的上传播放列表ID #

先通过channels.list接口（1单位/请求）获取目标频道的专属上传播放列表ID：

def get_upload_playlist_id(api_key, channel_id):
    url = 'https://www.googleapis.com/youtube/v3/channels'
    response = requests.get(url, params={
        'key': api_key,
        'id': channel_id,
        'part': 'contentDetails'
    })
    data = response.json()
    return data['items'][0]['contentDetails']['relatedPlaylists']['uploads']

2. 遍历上传播放列表获取视频URL #

再用playlistItems.list接口（1单位/请求）遍历播放列表，直接获取所有上传视频：

def get_video_urls_from_playlist(api_key, playlist_id):
    base_url = 'https://www.googleapis.com/youtube/v3/playlistItems'
    video_urls = []
    next_page_token = ''
    
    while True:
        response = requests.get(base_url, params={
            'key': api_key,
            'playlistId': playlist_id,
            'part': 'contentDetails',
            'maxResults': 50,
            'pageToken': next_page_token
        })
        
        if response.status_code != 200:
            print(f'Error: {response.status_code} - {response.text}')
            break
        
        data = response.json()
        
        for item in data.get('items', []):
            video_id = item['contentDetails']['videoId']
            video_urls.append(f'https://www.youtube.com/watch?v={video_id}')
        
        next_page_token = data.get('nextPageToken', None)
        
        if not next_page_token:
            break
    
    return video_urls

组合调用示例 #

api_key = '你的API密钥'
channel_id = '目标频道ID'

playlist_id = get_upload_playlist_id(api_key, channel_id)
video_urls = get_video_urls_from_playlist(api_key, playlist_id)

优化后配额消耗 #

获取3500个视频仅需：

• 1次channels.list请求：1单位
• 70次playlistItems.list请求：70单位
• 总计71单位，远低于原方案的消耗

四、额外注意事项 #

• 配额按太平洋时间每日午夜重置
• 建议缓存已获取的播放列表ID或视频数据，避免重复请求浪费配额
• playlistItems.list返回的内容默认是频道公开上传的视频，无需额外过滤非视频内容

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