使用YouTube Analytics API调用videoThumbnailImpressions指标遇400错误求助

问题场景 #

调用YouTube Analytics API提取自身账号的videoThumbnailImpressions（视频缩略图曝光量）时，返回400错误。原调用代码如下：

def get_pages_performance(credentials):
    youtube_analytics = build('youtubeAnalytics', 'v2', credentials=credentials)
    
    request = youtube_analytics.reports().query(
        endDate="2025-12-31",
        ids="channel==MINE",
        metrics="videoThumbnailImpressions",
        startDate="2025-12-01"
    )
    response = request.execute()
    print(response)

错误信息 #

{
  "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"
      }
    ]
  }
}

问题原因 #

尽管videoThumbnailImpressions属于官方文档中的触达指标（Reach Metrics），但YouTube Analytics API的查询要求指标必须与指定维度匹配，单独请求该指标而不添加对应维度时，API会判定查询不合法。

解决方案 #

修改查询参数，添加符合规则的维度（如按日期维度day或按视频维度video），同时确保日期范围为已有数据的时段（示例中2025年为未来日期，建议替换为过去的有效日期）。

修改后的代码示例：

def get_pages_performance(credentials):
    youtube_analytics = build('youtubeAnalytics', 'v2', credentials=credentials)
    
    request = youtube_analytics.reports().query(
        endDate="2024-06-30",
        ids="channel==MINE",
        metrics="videoThumbnailImpressions",
        startDate="2024-06-01",
        dimensions="day"  # 添加日期维度
    )
    response = request.execute()
    print(response)

说明：可根据需求选择其他支持的维度，只要确保维度与videoThumbnailImpressions指标兼容即可。

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