借助创作者数据分析功能，您可以发现并获取有关 YouTube 创作者的数据分析。对于想要寻找与目标受众群体相关的创作者的代理机构和广告客户来说，此功能非常实用。
该 API 具有以下四个主要功能：
- 创作者发现 ：根据给定的一组主题、受众特征、受众群体或创作者属性，查找相关创作者。
- 创作者主题数据分析 ：获取制作与指定主题相关内容的创作者的相关数据分析。
- 创作者数据分析 ：获取有关特定 YouTube 频道的数据分析，例如订阅人数、观看次数和受众群体特征。
- 趋势数据分析 ：根据特定受众群体或主题，获取有关特定趋势的数据分析。
当您使用基于主题的创作者发现功能或趋势数据分析功能时，可以通过请求补充数据来支持本地创作者发现（查找位于给定国家/地区或从该国家/地区发布内容且在该国家/地区被观看的创作者）。
资格要求
GenerateCreatorInsights 是 Google Ads API 的私有组件，以非独占、免版税的数据许可形式提供。已签署
协议的合作伙伴可以使用标准 Google Ads 客户端库 来探索
YouTube 创作者和内容。如需符合资格，合作伙伴必须满足以下条件：
- 拥有将集成 Google Ads API 的规划工具或界面。
- 使用该 API 探索 YouTube 内容和创作者，以寻找潜在的广告机会。
- 完成初步过滤评估，以确保符合资格。
- 遵守数据使用要求，并愿意接受定期数据审核。
- 签署数据许可协议，以在法律上强制执行数据使用要求。
- 接受 Google Ads API 服务条款。
如需了解详情，请与您的 Google 代表联系。
生成创作者数据分析
如需生成创作者数据分析，请向
GenerateCreatorInsights 方法发送请求。此方法的每秒查询次数 (QPS) 上限为 5 次。它会接受不同类型的输入，具体取决于您是要进行创作者发现、按主题搜索相关创作者，还是要获取创作者数据分析。您必须提供要从中获取数据的国家/地区。
创作者发现 ：您可以提供受众群体属性列表，例如年龄、性别和用户兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。该 API 会返回受众群体与这些属性匹配的创作者列表。您还可以提供创作者属性，以过滤出内容与您输入的创作者属性完全匹配的创作者。
您可以使用
ListAudienceInsightsAttributes检索可用的受众群体属性，方法是提供您想要获取属性的维度，例如KNOWLEDGE_GRAPH（用于感兴趣的主题）。从 Google Ads API v23 开始，您可以使用
audience_combinations指定复杂的受众群体属性关系。借助此字段，您可以使用audience_attributes无法实现的布尔逻辑（AND/OR）来定义受众群体。虽然
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结合使用，以用于其他属性类型（例如受众特征）。创作者主题数据分析 ：使用
search_topics字段提供内容主题列表。该 API 会返回制作与指定主题相关内容的创作者。获取的数据基于country_locations中指定的国家/地区。请注意，此选项仅允许搜索一个国家/地区。SearchTopics字段中支持的实体必须使用CONTENT_TRENDING_INSIGHTS或CREATOR_TOPIC_INSIGHTS功能进行标记。使用ListAudienceInsightsAttributes方法检索支持的实体功能。注意：
search_brand选项已从 v24.2 开始弃用，并在 v25 版本中 完全移除。用户应改为使用search_topics。创作者数据分析：使用
search_channels字段提供 YouTube 频道 ID 列表。该 API 会返回有关这些特定频道的数据分析。
补充数据和本地创作者
默认情况下，系统只会返回核心数据分析数据。您可以通过设置重复字段
supplemental_data，在响应中请求可选
功能和其他数据。
例如，您可以通过将 LOCAL_CREATOR_DATA 枚举值添加到 supplemental_data 字段来请求本地创作者数据。如果您使用 search_topics 搜索创作者（并且该主题是使用 CREATOR_TOPIC_INSIGHTS 功能标记的知识图谱实体），则 API 会在响应中填充 local_creator_insights 字段，其中包含已同意分享其位置数据的本地创作者。
请注意以下有关本地创作者发现的规范：
- 定义 ：“本地创作者”是指位于所选国家/地区或从该国家/地区发布内容且在该国家/地区被观看的创作者。
- 限制 ：当请求中设置了
sub_country_locations时，系统不支持本地创作者发现。 - 功能：您可以使用知识图谱
实体及其功能列表，使用
ListAudienceInsightsAttributes检索支持的知识图谱实体及其功能列表。
generateCreatorInsights 方法会返回 GenerateCreatorInsightsResponse 对象。此对象包含以下字段：
creator_insights：与您的核心条件匹配的YouTubeCreatorInsights对象列表。local_creator_insights：本地创作者的YouTubeCreatorInsights对象列表。仅当请求了LOCAL_CREATOR_DATA且使用的条件为search_topics时，此字段才会填充。
每个 YouTubeCreatorInsights 对象都包含以下有关创作者的信息：
- 创作者姓名
- YouTube 频道
- 创作者总指标
- YouTube 频道数据分析列表
[YouTubeMetrics][YouTubeMetrics] 对象包含以下指标：
- 订阅人数
- 观看次数
- 视频数
- 是否为活跃的 Shorts 创作者
- 合作机会（从 v23 开始）
如需确定创作者是否有资格参与原创品牌合作内容合作，
请检查 partnership_opportunities；如果该列表包含 CREATOR_PARTNERSHIPS 值，则表示创作者符合资格。
YouTubeChannelInsights 对象包含以下有关 YouTube 频道的信息：
- 频道名称
- 频道 ID
- 频道网址
- 频道说明
- 频道指标
- 频道受众群体属性（例如年龄、性别和用户兴趣细分）
- 热门视频
- 渠道类型
- 与频道内容关联的语言
- 相关性得分（仅适用于主题趋势搜索）
生成趋势数据分析
如需生成趋势数据分析，请向
GenerateTrendingInsights 方法发送请求。此方法的每秒查询次数 (QPS) 上限为 5 次。它会接受两种类型的输入，具体取决于您是要获取受众群体趋势还是主题趋势。您必须提供要从中获取趋势的具体国家/地区。
受众群体趋势 ：您可以提供受众群体属性列表，例如年龄、性别和用户兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。该 API 会返回这些受众群体的趋势数据分析列表，包括趋势值在比较期内的百分比变化等指标。
您可以使用
ListAudienceInsightsAttributes检索可用的受众群体属性，方法是提供您想要获取属性的维度，例如KNOWLEDGE_GRAPH（用于感兴趣的主题）。KNOWLEDGE_GRAPH属性将包含一个或多个InsightsKnowledgeGraphEntityCapabilities标记。趋势数据分析支持的属性将在其响应元数据中包含相关标记。请注意，有权访问
ContentCreatorInsightsService的开发者也将自动有权访问AudienceInsightsService.ListAudienceInsightsAttributes。AudienceInsightsService中的其他端点需要单独的许可清单流程。受众群体趋势 ：您可以提供受众群体属性列表，例如年龄、性别和用户兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。该 API 会返回这些受众群体的趋势数据分析列表，包括趋势值在比较期内的百分比变化等指标。
您可以使用
ListAudienceInsightsAttributes方法检索可用的受众群体属性， 方法是提供您想要获取属性的维度，例如KNOWLEDGE_GRAPH（用于感兴趣的主题）。从 Google Ads API v23 开始，您可以使用
audience_combinations指定复杂的受众群体属性关系。借助此字段，您可以使用audience_attributes无法实现的布尔逻辑（AND/OR）来定义受众群体。虽然
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 会返回这些主题的趋势数据分析列表，包括趋势值在比较期内的百分比变化等指标。
补充数据和本地创作者
与生成创作者数据分析类似，您可以通过将重复字段
supplemental_data设置为LOCAL_CREATOR_DATA，在
趋势数据分析中请求可选功能。
如果您的趋势请求使用 search_topics，则系统会在返回的
related_local_creators
对象中填充 TrendInsight 字段，其中包含已同意分享
其位置数据的相关本地创作者。本地创作者发现遵循相同的定义和限制（例如与 sub_country_locations 不兼容）。