借助创作者数据分析功能，您可以发现并获取有关 YouTube 创作者的数据分析。对于想要寻找与目标受众群体相关的创作者的代理机构和广告客户来说，此功能非常实用。
该 API 具有四项主要功能：
- 创作者可发现性 ：查找给定主题、受众特征、受众群体或创作者属性的热门创作者。
- 创作者品牌数据分析 ：获取与特定品牌相关的创作者数据分析。
- 创作者数据分析 ：获取有关特定 YouTube 频道的数据分析，例如订阅人数、观看次数和受众群体特征。
- 趋势数据分析 ：获取有关特定趋势的数据分析，这些趋势基于特定受众群体或主题。
资格要求
ContentCreatorInsightsService.GenerateCreatorInsights
是 Google Ads API 的私有组件，以非独占、免版税的数据许可形式提供。已签署协议的合作伙伴可以使用标准
Google Ads 客户端库来探索 YouTube 创作者和内容。
如需符合资格，合作伙伴必须满足以下条件：
- 拥有将集成 Google Ads API 的规划工具或界面。
- 使用该 API 探索 YouTube 内容和创作者，以寻找潜在的广告机会。
- 完成初步过滤评估，以确保符合资格。
- 遵守数据使用要求，并愿意接受定期数据审核。
- 签署数据许可协议，以在法律上强制执行数据使用要求。
- 接受 Google Ads API 服务条款。
如需了解详情，请与您的 Google 代表联系。
生成创作者数据分析
如需生成创作者数据分析，请向
ContentCreatorInsightsService.GenerateCreatorInsights
方法发送请求。此方法每秒查询次数 (QPS) 上限为 5，并且需要三种类型的输入，具体取决于您是想要进行创作者可发现性分析、创作者品牌数据分析还是获取创作者数据分析。您必须提供要从中获取数据的国家/地区。
创作者可发现性 ：您可以提供受众群体属性列表，例如年龄、性别和用户兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。API 会返回一个创作者列表，其中创作者的受众群体与这些属性相匹配。您还可以提供创作者属性，以过滤出内容与您输入的创作者属性完全匹配的创作者。
您可以使用
AudienceInsightsService.ListAudienceInsightsAttributes检索可用的受众群体属性， 方法是提供您想要获取属性的维度，例如KNOWLEDGE_GRAPH（用于感兴趣的主题）。从 Google Ads API v23 开始，您可以使用
audience_combinations指定复杂的受众群体属性关系。借助此字段，您可以使用布尔逻辑 (AND/OR) 定义受众群体，而这是audience_attributes无法实现的。虽然
audience_attributes适合根据联合（与 OR 结合）属性列表进行定位（例如，对“体育”“旅游”或 ... 感兴趣的用户），但audience_combinations提供了更精细的控制。audience_combinations中的每个InsightsAudienceAttributeGroup都使用逻辑 OR 组合属性。然后，这些组会使用逻辑 AND 组合在一起。例如，如需定位对（“护肤”OR“护发”）AND“化妆品”感兴趣的受众群体，您需要在
audience_combinations中使用两个InsightsAudienceAttributeGroup项。“护肤”“护发”和“化妆品”是感兴趣的主题，由知识图谱实体表示（例如，化妆品的知识图谱实体为/m/014trl）。第一个组将包含“护肤”和“护发”的知识图谱实体属性，第二个组将包含“化妆品”的知识图谱实体属性。请注意，如果您在
audience_attributes中指定了知识图谱实体、产品和服务类别或用户兴趣，则无法使用audience_combinations。如果您使用audience_combinations，则必须在audience_combinations中指定这些属性，而不能在audience_attributes中指定；不过，您仍然可以将audience_attributes与audience_combinations结合使用，以用于其他属性类型（例如受众特征）。创作者品牌数据分析 ：提供品牌以搜索热门创作者。API 会返回有关匹配频道的数据分析。
创作者数据分析 ：提供 YouTube 频道 ID 列表。API 会返回有关这些特定频道的数据分析。
generateCreatorInsights 方法会返回一个 GenerateCreatorInsightsResponse 对象。此对象包含 YouTubeCreatorInsights 对象列表。每个 YouTubeCreatorInsights 对象都包含有关创作者的以下信息：
- 创作者姓名
- YouTube 频道
- 创作者指标总数
- YouTube 频道数据分析列表
YouTubeMetrics 对象包含以下指标：
- 订阅人数
- 观看次数
- 视频数
- 是否为活跃的 Shorts 创作者
- 合作伙伴机会（从 v23 开始）
如需确定创作者是否有资格参与原创品牌合作内容合作伙伴计划，
请检查
partnership_opportunities；
如果该列表包含 CREATOR_PARTNERSHIPS 值，则创作者符合资格。
YouTubeChannelInsights 对象包含有关 YouTube 频道的以下信息：
- 频道名称
- 频道 ID
- 频道网址
- 频道说明
- 频道指标
频道受众群体属性（例如年龄、性别和用户兴趣
细分）
热门视频
渠道类型
与频道内容关联的语言
相关性得分（仅适用于主题趋势搜索）
生成趋势数据分析
如需生成趋势数据分析，请向
ContentCreatorInsightsService.GenerateTrendingInsights
方法发送请求。此方法每秒查询次数 (QPS) 上限为 5，并且需要两种类型的输入，具体取决于您是想要获取受众群体趋势还是主题趋势。
您必须提供要从中获取趋势的特定国家/地区。
受众群体趋势 ：您可以提供受众群体属性列表，例如年龄、性别和用户兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。API 会返回这些受众群体的趋势数据分析列表，其中包括趋势值在比较期内的百分比变化等指标。
您可以使用
AudienceInsightsService.ListAudienceInsightsAttributes检索可用的受众群体属性， 方法是提供您想要获取属性的维度，例如KNOWLEDGE_GRAPH（用于感兴趣的主题）。从 Google Ads API v23 开始，您可以使用
audience_combinations指定复杂的受众群体属性关系。借助此字段，您可以使用布尔逻辑 (AND/OR) 定义受众群体，而这是audience_attributes无法实现的。虽然
audience_attributes适合根据联合（与 OR 结合）属性列表进行定位（例如，对“体育”“旅游”或 ... 感兴趣的用户），但audience_combinations提供了更精细的控制。audience_combinations中的每个InsightsAudienceAttributeGroup都使用逻辑 OR 组合属性。然后，这些组会使用逻辑 AND 组合在一起。例如，如需定位对（“护肤”OR“护发”）AND“化妆品”感兴趣的受众群体，您需要在
audience_combinations中使用两个InsightsAudienceAttributeGroup项。“护肤”“护发”和“化妆品”是感兴趣的主题，由知识图谱实体表示（例如，化妆品的知识图谱实体为/m/014trl）。第一个组将包含“护肤”和“护发”的知识图谱实体属性，第二个组将包含“化妆品”的知识图谱实体属性。请注意，如果您在
audience_attributes中指定了知识图谱实体、产品和服务类别或用户兴趣，则无法使用audience_combinations。如果您使用audience_combinations，则必须在audience_combinations中指定这些属性，而不能在audience_attributes中指定；不过，您仍然可以将audience_attributes与audience_combinations结合使用，以用于其他属性类型（例如受众特征）。主题趋势 ：提供内容主题列表。API 会返回这些主题的趋势数据分析列表，其中包括趋势值在比较期内的百分比变化等指标。