借助创作者数据分析功能，您可以发现并获取有关 YouTube 创作者的数据分析。对于希望寻找与目标受众群体相关的创作者的代理机构和广告客户来说，此功能非常有用。
该 API 具有四项主要功能：
- 创作者可发现性：查找与指定主题、人口统计特征、受众群体或创作者属性相关的创作者。
- 创作者主题数据分析：获取有关制作指定主题内容的创作者的相关数据分析。
- 创作者数据分析：获取有关特定 YouTube 频道的数据分析，例如订阅人数、观看次数和观众群特征。
- 热门数据洞见：根据特定受众群体或主题，获取有关特定趋势的数据洞见。
使用基于主题的创作者发现功能或热门趋势分析功能时，可以通过请求补充数据来支持本地创作者发现（查找位于或发布内容时位于指定国家/地区且在该国家/地区被观看的创作者）。您还可以通过请求补充数据，获取基于主题的趋势分析的品牌情感分析。
资格要求
GenerateCreatorInsights 是 Google Ads API 的私有组件，以非独占、免版税的数据许可提供。已签约的合作伙伴可以使用标准 Google Ads 客户端库来探索 YouTube 创作者和内容。如要符合条件，合作伙伴必须满足以下条件：
- 拥有可集成 Google Ads API 的规划工具或用户界面。
- 使用该 API 探索 YouTube 内容和创作者，寻找潜在的广告机会。
- 完成初步筛选评估，确保符合条件。
- 遵循数据使用要求，并愿意接受定期数据审核。
- 签署数据许可协议，以从法律上强制执行数据使用要求。
- 接受 Google Ads API 服务条款。
如需了解详情，请与您的 Google 代表联系。
生成创作者数据分析
如需生成创作者数据分析，请向 GenerateCreatorInsights 方法发送请求。此方法的限制为每秒查询次数 (QPS)。它需要不同类型的输入，具体取决于您是想提高创作者的可发现性、按主题搜索相关创作者，还是获取创作者数据分析。您必须提供要从中获取数据的国家/地区位置。
创作者可发现性：您可以提供受众群体属性列表，例如年龄、性别和用户兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。该 API 会返回受众群体符合这些属性的创作者列表。您还可以提供创作者属性，以过滤出内容与您输入的创作者属性完全匹配的创作者。
您可以通过提供要获取属性的维度（例如
KNOWLEDGE_GRAPH表示兴趣主题），使用ListAudienceInsightsAttributes检索可用的受众群体属性。自 Google Ads API v23 起，您可以使用
audience_combinations指定复杂的受众群体属性关系。借助此字段，您可以定义使用布尔逻辑（AND/OR）的受众群体，而audience_attributes无法实现这一点。虽然
audience_attributes适合根据一组并集（通过 OR 组合）属性（例如，对“体育”“旅游”或其他内容感兴趣的用户）进行定位，但audience_combinations可提供更精细的控制。audience_combinations中的每个InsightsAudienceAttributeGroup都通过逻辑 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，在响应中请求可选功能和额外数据。
例如，您可以通过向 supplemental_data 字段添加 LOCAL_CREATOR_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 对象包含以下指标：
- 订阅人数
- 观看次数
- 视频数
- 是活跃的短视频创作者
- 合作伙伴机会（从 v23 开始）
如需确定创作者是否符合原创品牌植入内容合作条件，请检查 partnership_opportunities；如果该列表包含 CREATOR_PARTNERSHIPS 值，则表示创作者符合条件。
YouTubeChannelInsights 对象包含有关 YouTube 频道的以下信息：
- 频道名称
- 频道 ID
- 频道网址
- 频道说明
- 频道指标
- 频道受众群体属性（例如年龄、性别和用户兴趣细分）
- 热门视频
- 渠道类型
- 与频道内容相关联的语言
- 相关性得分（仅适用于主题趋势搜索）
- 创作者是否已同意分享非公开指标
生成热门趋势分析
如需生成热门趋势分析，请向 GenerateTrendingInsights 方法发送请求。此方法的限制为每秒查询次数 (QPS)。它需要两种类型的输入，具体取决于您是想了解受众群体趋势还是主题趋势。您必须提供要获取趋势的具体国家/地区位置。
受众群体趋势：您可以提供受众群体属性列表，例如年龄、性别和用户兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。该 API 会返回这些受众群体的热门数据洞见列表，其中包括趋势值的百分比变化（与比较期相比）等指标。
您可以通过提供要获取属性的维度（例如
KNOWLEDGE_GRAPH表示兴趣主题），使用ListAudienceInsightsAttributes检索可用的受众群体属性。自 Google Ads API v23 起，您可以使用
audience_combinations指定复杂的受众群体属性关系。借助此字段，您可以使用布尔逻辑运算符（和/或）定义受众群体，而这是audience_attributes无法实现的。虽然
audience_attributes适合根据一组并集（通过 OR 组合）属性（例如，对“体育”“旅游”或其他内容感兴趣的用户）进行定位，但audience_combinations可提供更精细的控制。audience_combinations中的每个InsightsAudienceAttributeGroup都通过逻辑 OR 组合属性。然后，这些组通过逻辑 AND 进行组合。例如，若要定位对“护肤”或“护发”感兴趣且还对“化妆品”感兴趣的受众群体，您需要在
audience_combinations中使用两个InsightsAudienceAttributeGroup项。“护肤”“护发”和“化妆品”是兴趣主题，由知识图谱实体表示（例如，/m/014trl表示化妆品）。第一个组将包含“护肤”和“护发”的知识图谱实体属性，第二个组将包含“化妆品”的知识图谱实体属性。请注意，如果您在
audience_attributes中指定了知识图谱实体、产品和服务类别或用户兴趣，则无法使用audience_combinations。如果您使用audience_combinations，则必须在audience_combinations中指定这些属性，而不能在audience_attributes中指定；不过，您仍然可以将audience_attributes与audience_combinations结合使用，用于其他属性类型（例如人口统计信息）。KNOWLEDGE_GRAPH属性将包含一个或多个InsightsKnowledgeGraphEntityCapabilities标记。支持“热门分析洞见”的属性将在其响应元数据中包含相关标记。请注意，有权访问
ContentCreatorInsightsService的开发者也会自动获得AudienceInsightsService.ListAudienceInsightsAttributes的访问权限。AudienceInsightsService中的其他端点需要单独的许可名单流程。如需查看有关
ListAudienceInsightsAttributes的其他文档，请参阅受众群体分析指南。主题趋势：提供内容主题列表。该 API 会返回这些主题的热门数据洞见列表，其中包括趋势值的百分比变化等指标（与比较期相比）。您还可以通过请求补充数据来获取品牌主题的品牌情感分析洞见。
补充数据、本地创作者和品牌评价
与生成创作者数据分析类似，您可以通过将重复字段 supplemental_data 设置为 LOCAL_CREATOR_DATA 或 BRAND_SENTIMENT_DATA，在热门趋势数据分析中请求可选功能。
如果您的热门趋势请求使用 search_topics，将 supplemental_data 设置为 LOCAL_CREATOR_DATA 会在返回的 TrendInsight 对象中填充 related_local_creators 字段，其中包含已同意分享其位置数据的相关本地创作者（针对所请求的主题）。本地创作者发现功能受相同的定义和限制条件（例如与 sub_country_locations 不兼容）约束。
如果您的热门趋势请求使用 search_topics，将 supplemental_data 设置为 BRAND_SENTIMENT_DATA 将会在返回的 TrendInsight 对象中填充 brand_sentiment_insights 字段，前提是所请求的知识图谱实体主题具有 BRAND 功能。品牌主题是具有 BRAND 功能的实体。您可以使用 ListAudienceInsightsAttributes 方法检索受支持的实体功能。
衡量品牌情绪涉及使用 AI 模型（由 Gemini 提供支持）分析与品牌相关的 YouTube 视频内容，并将情绪归类为正面、负面或中性。系统只会分析视频内容本身， 不会分析用户评论。
热门分析元数据
GenerateTrendingInsights 方法会返回一个 TrendInsight 对象列表，每个对象包含：
trend_attribute：趋势的主要AudienceInsightsAttributeMetadata。trend_metrics：趋势的指标，例如比较期内的百分比变化。trend_data_points：趋势的历史数据点。仅针对使用search_topics的趋势进行填充。related_videos：与趋势主题相关的热门视频的AudienceInsightsAttributeMetadata对象列表。仅针对使用search_topics的趋势进行填充。对于这些属性，系统会填充嵌套的YouTubeVideoAttributeMetadata，其中包含视频级元数据（例如视频网址、缩略图网址以及观看次数或赞数）和频道级元数据（例如频道 ID、名称和网址）。brand_sentiment_insights：趋势的BrandSentimentInsight对象列表。仅当趋势请求使用search_topics、知识图谱实体主题具有BRAND功能，并且在supplemental_data中请求了BRAND_SENTIMENT_DATA时填充。每个BrandSentimentInsight对象都包含：month：品牌情感所代表的月份，采用YYYY-MM格式。has_insufficient_data：是否有足够的数据来计算品牌情感。sentiment_distributions：正面、负面和中性情绪之间的分布，计算方式为与品牌对应的视频的观看次数占每种情绪的比例。sentiment_summaries：AI 生成的与品牌相关的内容的正面和负面评价摘要，以及每种情感的示例视频。系统仅针对正面和负面情绪生成摘要，不会针对中性情绪生成摘要。