--- v24/services/content_creator_insights_service.proto 2026-07-21 22:02:30.000000000 +0000 +++ v25/services/content_creator_insights_service.proto 2026-07-21 22:02:37.000000000 +0000 @@ -128,30 +128,15 @@ // Optional. Creator attributes that describe a collection of types of // content. This is used to search for creators whose content matches the // input creator attributes. Only Knowledge Graph Entities tagged with - // [CREATOR_ATTRIBUTE][google.ads.googleads.v24.enums.InsightsKnowledgeGraphEntityCapabilitiesEnum.InsightsKnowledgeGraphEntityCapabilities.CREATOR_ATTRIBUTE] + // [CREATOR_ATTRIBUTE][google.ads.googleads.v25.enums.InsightsKnowledgeGraphEntityCapabilitiesEnum.InsightsKnowledgeGraphEntityCapabilities.CREATOR_ATTRIBUTE] // are supported. Use - // [AudienceInsightsService.ListAudienceInsightsAttributes][google.ads.googleads.v24.services.AudienceInsightsService.ListAudienceInsightsAttributes] + // [AudienceInsightsService.ListAudienceInsightsAttributes][google.ads.googleads.v25.services.AudienceInsightsService.ListAudienceInsightsAttributes] // to get the list of supported entities. Other attributes including // location are not supported. - repeated google.ads.googleads.v24.common.AudienceInsightsAttribute + repeated google.ads.googleads.v25.common.AudienceInsightsAttribute creator_attributes = 2 [(google.api.field_behavior) = OPTIONAL]; } - // The brand used to search for top creators. - message SearchBrand { - // Optional. One or more Knowledge Graph Entities that represent the brand - // for which to find insights. - repeated google.ads.googleads.v24.common.AudienceInsightsAttribute - brand_entities = 1 [(google.api.field_behavior) = OPTIONAL]; - - // Optional. When true, we will expand the search to beyond just the - // entities specified in - // [brand_entities][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.SearchBrand.brand_entities] - // to other related knowledge graph entities similar to the brand. The - // default value is `false`. - bool include_related_topics = 2 [(google.api.field_behavior) = OPTIONAL]; - } - // A collection of YouTube Channels. message YouTubeChannels { // Optional. The YouTube Channel IDs to fetch creator insights for. @@ -193,21 +178,14 @@ oneof criteria { // The attributes used to identify top creators. Data fetched is based on // the list of countries or sub-country locations specified in - // [country_locations][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.country_locations] + // [country_locations][google.ads.googleads.v25.services.GenerateCreatorInsightsRequest.country_locations] // or - // [sub_country_locations][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.sub_country_locations]. + // [sub_country_locations][google.ads.googleads.v25.services.GenerateCreatorInsightsRequest.sub_country_locations]. SearchAttributes search_attributes = 3; - // A brand used to search for top creators. Data fetched is based on the - // list of countries specified in - // [country_locations][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.country_locations].This - // option is deprecated and will be removed in the V25 release. Use - // search_topics instead. - SearchBrand search_brand = 5; - // YouTube Channel IDs for Creator Insights. Data fetched for channels is // based on the list of countries specified in - // [country_locations][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.country_locations]. + // [country_locations][google.ads.googleads.v25.services.GenerateCreatorInsightsRequest.country_locations]. YouTubeChannels search_channels = 4; // Search for relevant creators who make content about the specified topics. @@ -382,11 +360,20 @@ string publish_date = 13; // The country with which the channel is associated. - google.ads.googleads.v24.common.LocationInfo country_location = 14; + google.ads.googleads.v25.common.LocationInfo country_location = 14; // The metrics for a YouTube Channel. YouTubeMetrics channel_metrics = 3; + // True if the creator has consented to share non-public data. + // If false, non-public data fields will not be populated. + // Non-public data includes `YouTubeMetrics.average_view_per_video`, + // `YouTubeMetrics.average_likes_per_video`, + // `YouTubeMetrics.average_comments_per_video`, + // `YouTubeMetrics.engagement_rate`, and + // `YouTubeChannelInsights.channel_audience_attributes`. + bool data_sharing_consent_given = 18; + // The types of audiences and demographics linked to the channel's main // audience. Audiences and demographics have a breakdown of subscriber share // across dimensions of the same value, such as Age Range, Gender, and User
/services/content_creator_insights_service.proto
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-07-22 UTC.