借助创作者数据分析功能，您可以发现并获取有关 YouTube 创作者的数据分析。对于想要寻找与目标受众群体相关的创作者的代理机构和广告客户来说，此功能非常实用。
该 API 具有四项主要功能：
- 创作者曝光度 ：查找给定主题、受众特征、受众群体或创作者属性的热门创作者。
- 创作者品牌数据分析 ：获取与特定品牌相关的创作者数据分析。
- 创作者数据分析 ：获取有关特定 YouTube 频道的数据分析，例如订阅人数、观看次数和受众群体受众特征。
- 趋势数据分析 ：根据特定受众群体或主题获取有关特定趋势的数据分析。
资格要求
ContentCreatorInsightsService.GenerateCreatorInsights
是 Google Ads API 的私有组件，以非独占、免版税的数据许可形式提供。已签署协议的合作伙伴可以使用标准 Google Ads 客户端库 来探索 YouTube 创作者和内容。如需符合资格，合作伙伴必须满足以下条件：
- 拥有将集成该 API 的规划工具或用户界面。
- 使用该 API 探索 YouTube 内容和创作者，以寻找潜在的广告机会。
- 完成初步过滤评估，以确保符合资格。
- 遵守数据使用要求，并愿意接受定期数据审核。
- 签署数据许可协议，以在法律上强制执行数据使用要求。
- 接受 Google Ads API 服务条款。
如需了解详情，请与您的 Google 代表联系。
生成创作者数据分析
如需生成创作者数据分析，请向
ContentCreatorInsightsService.GenerateCreatorInsights
方法发送请求。此方法每秒查询次数 (QPS) 上限为 5，并且根据您是要进行创作者曝光度、创作者品牌数据分析还是获取创作者数据分析，需要三种类型的输入。您必须提供要从中获取数据的国家/地区。
- 创作者曝光度 ：您可以提供受众群体属性列表，例如年龄、性别和兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。API 会返回一个创作者列表，其中创作者的受众群体与这些属性相匹配。您还可以提供创作者属性，以过滤出内容与您输入的创作者属性完全匹配的创作者。
- 创作者品牌数据分析 ：提供品牌以搜索热门创作者。API 会返回有关匹配频道的数据分析。
- 创作者数据分析 ：提供 YouTube 频道 ID 列表。API 会返回有关这些特定频道的数据分析。
generateCreatorInsights 方法会返回一个 GenerateCreatorInsightsResponse 对象。此对象包含 YouTubeCreatorInsights 对象列表。每个 YouTubeCreatorInsights 对象都包含有关创作者的以下信息：
- 创作者姓名
- YouTube 频道
- 创作者指标总数
- YouTube 频道数据分析列表
YouTubeMetrics 对象包含以下指标：
- 订阅人数
- 观看次数
- 视频数
- 是否为活跃的 Shorts 创作者
- 合作机会（从 v23_2 开始）
YouTubeChannelInsights 对象包含有关 YouTube 频道的以下信息：
- 频道名称
- 频道 ID
- 频道网址
- 频道说明
- 频道指标
- 频道受众群体属性（例如年龄、性别和用户兴趣细分）
- 热门视频
- 渠道类型
- 与频道内容关联的语言
- 相关性得分（仅适用于主题趋势搜索）
生成趋势数据分析
如需生成趋势数据分析，请向
ContentCreatorInsightsService.GenerateTrendingInsights
方法发送请求。此方法每秒查询次数 (QPS) 上限为 5，并且根据您是要获取受众群体趋势还是主题趋势，需要两种类型的输入。
您必须提供要从中获取趋势的特定国家/地区。
- 受众群体趋势 ：您可以提供受众群体属性列表，例如年龄、性别和兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。API 会返回这些受众群体的时下热门数据分析列表，包括趋势值在比较期内的百分比变化等指标。
- 主题趋势 ：提供内容主题列表。API 会返回这些主题的趋势数据分析列表，包括趋势值在比较期内的百分比变化等指标。