关于YouTube Analytics API中creatorContentType维度兼容问题的咨询

问题描述 #

调用https://youtubeanalytics.googleapis.com/v2/reports API获取YouTube视频指标时，当维度设置为video,day,creatorContentType，部分指标无法正常返回；一旦包含videosAddedToPlaylists等特定指标，就会触发400错误，这与频道报告文档描述不符，寻求澄清与解决办法。

请求详情 #

https://youtubeanalytics.googleapis.com/v2/reports?endDate=2025-10-20&ids=channel%3D%3DMINE&metrics=views,redViews,comments,likes,dislikes,videosAddedToPlaylists,videosRemovedFromPlaylists,shares,estimatedMinutesWatched,estimatedRedMinutesWatched,averageViewDuration,averageViewPercentage,annotationClickThroughRate,annotationCloseRate,annotationImpressions,annotationClickableImpressions,annotationClosableImpressions,annotationClicks,annotationCloses,cardClickRate,cardTeaserClickRate,cardImpressions,cardTeaserImpressions,cardClicks,cardTeaserClicks,subscribersGained,subscribersLost&startDate=2025-10-01&dimensions=video,day,creatorContentType

可用指标 #

views,redViews,comments,likes,dislikes,shares,estimatedMinutesWatched,estimatedRedMinutesWatched,averageViewDuration,averageViewPercentage,cardClickRate,cardTeaserClickRate,cardImpressions,cardTeaserImpressions,cardClicks,cardTeaserClicks,subscribersGained

不可用指标 #

videosAddedToPlaylists,videosRemovedFromPlaylists,annotationClickThroughRate,annotationCloseRate,annotationImpressions,annotationClickableImpressions,annotationClosableImpressions,annotationClicks,annotationCloses

错误信息 #

{
    "error": {
        "code": 400,
        "message": "The query is not supported. Check the documentation at https://developers.google.com/youtube/analytics/v2/available_reports for a list of supported queries.",
        "errors": [
            {
                "message": "The query is not supported. Check the documentation at https://developers.google.com/youtube/analytics/v2/available_reports for a list of supported queries.",
                "domain": "global",
                "reason": "badRequest"
            }
        ]
    }
}

问题原因 #

1. 播放列表指标的维度限制：videosAddedToPlaylists和videosRemovedFromPlaylists属于播放列表关联行为指标，这类指标仅支持与playlist、playlistItem或更宽泛的维度（如day、channel）组合，无法适配video,day,creatorContentType的细粒度拆分——API无法提供该维度组合下的播放列表操作数据。
2. Annotation指标的停用影响：YouTube已逐步淘汰Annotation功能，相关API指标的支持范围大幅收缩，仅能在无细分维度的频道级查询中使用，无法与video+day+creatorContentType组合兼容。

解决办法 #

1. 拆分查询请求：将兼容与不兼容的指标分开调用API：
   • 保留video,day,creatorContentType维度查询可用指标；
   • 查询播放列表相关指标时，改用video,day或仅day维度（若不需要视频级细分）；
   • Annotation相关指标建议仅使用channel+day维度查询，或直接放弃（因功能已停用，数据可能不再更新）。
2. 核对官方兼容性规则：参考官方文档中明确的指标-维度配对要求，避免使用不兼容的组合。

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