如何为YouTube Data API v3配置default/CLIENT_PROJECT-1d配额

切换配额模型的实操方法
default/CLIENT_PROJECT-1d 是谷歌云针对端用户授权场景推出的客户端维度日配额,和老的defaultPerDayPerProject项目级共享配额没有手动切换的开关,是根据请求的认证方式自动判定生效的,照着下面配置就能自动切过去:
- 先确认调用场景符合要求:只有通过OAuth 2.0 用户授权凭证发起的请求,才会走
default/CLIENT_PROJECT-1d配额计量;如果是用API密钥、服务账号发起的调用,永远只会走老的项目级defaultPerDayPerProject配额。 - 进入谷歌云控制台对应项目,按路径完成配置:
- 打开「API和服务」-「已启用的API和服务」列表,找到YouTube Data API v3进入详情页,切到「凭证」 tab,先创建对应业务类型的OAuth 2.0客户端ID(网页、安卓、iOS、桌面端类型都支持),不要只保留API密钥类型的凭证
- 调整业务侧调用逻辑:所有发给YouTube Data API v3的请求,只带OAuth授权拿到的
Authorization: Bearer <用户access_token>请求头,不要带key参数传API密钥——只要请求里带了API密钥,不管有没有同步带用户token,都会优先按项目级配额计量,切不到客户端维度的配额。 - 确认OAuth授权时申请的scope是YouTube相关的合法权限范围,比如只读权限
https://www.googleapis.com/auth/youtube.readonly、读写权限https://www.googleapis.com/auth/youtube,scope不匹配的请求会被判定为非合规用户授权请求,依旧走老配额。
- 生效验证:改完逻辑发几个测试请求,等10到15分钟刷新YouTube Data API v3的「配额」页面,就能看到计量项从原来的
defaultPerDayPerProject变成default/CLIENT_PROJECT-1d,这个配额是每个OAuth客户端ID每天独立计算1万单位额度,不会和同项目下其他客户端的额度共享。
踩坑提示:不要同时传API密钥和OAuth token,这种请求100%走老的项目级配额,是很多人卡很久切不过去的核心原因。
如果配置完1小时还没看到配额维度切换,直接在配额页选对应项点「联系支持」提工单,让后台帮你刷新下项目的配额计量规则就行,不需要额外申请配额。
内容的提问来源于stack exchange,提问作者Dimple Saini
相关产品推荐
相关产品推荐

