/services/content_creator_insights_service.proto

  • Several new fields are added to the YouTubeChannelInfo message, including various engagement metrics like likes, shares, and comments counts, as well as average engagement rates and views for both overall and Shorts videos.

  • A new boolean field is_brand_connect_creator is introduced in YouTubeChannelInfo to indicate if a creator can be partnered with through the Google Ads BrandConnect platform.

  • The SearchContentCreatorsRequest and ListTrendingSearchTermsRequest messages now include an optional insights_application_info field for providing additional application details.

  • The SearchContentCreatorsRequest message now supports specifying sub_country_locations in addition to country_locations.

 
--- v19/services/content_creator_insights_service.proto 2025-08-05 14:37:32.000000000 +0000
+++ v20/services/content_creator_insights_service.proto 2025-08-05 14:37:48.000000000 +0000
@@ -131,10 +132,19 @@
   // user-defined value.
   string customer_insights_group = 2 [(google.api.field_behavior) = REQUIRED];

+  // Optional. Additional information on the application issuing the request.
+  google.ads.googleads.v20.common.AdditionalApplicationInfo
+      insights_application_info = 8 [(google.api.field_behavior) = OPTIONAL];
+
   // Required. The countries to search that apply to the criteria.
-  repeated google.ads.googleads.v19.common.LocationInfo country_locations = 6
+  repeated google.ads.googleads.v20.common.LocationInfo country_locations = 6
       [(google.api.field_behavior) = REQUIRED];

+  // The sub-country geographic locations to search that apply to the criteria.
+  // Only supported for [SearchAttributes] criteria.
+  repeated google.ads.googleads.v20.common.LocationInfo sub_country_locations =
+      7;
+
   // A criteria used to search for creators and creator insights.
   oneof criteria {
     // The attributes used to identify top creators. Data fetched is based on
@@ -168,8 +179,12 @@
   // user-defined value.
   string customer_insights_group = 2 [(google.api.field_behavior) = REQUIRED];

+  // Optional. Additional information on the application issuing the request.
+  google.ads.googleads.v20.common.AdditionalApplicationInfo
+      insights_application_info = 6 [(google.api.field_behavior) = OPTIONAL];
+
   // Required. The country to find trends in.
-  google.ads.googleads.v19.common.LocationInfo country_location = 3
+  google.ads.googleads.v20.common.LocationInfo country_location = 3
       [(google.api.field_behavior) = REQUIRED];

   // The criteria used to search for trending content.
@@ -208,8 +223,47 @@
   // The total number of videos.
   int64 video_count = 3;

-  // When true, this channel has published a shorts video in the last 90 days.
+  // The total number of likes across all videos of this channel.
+  int64 likes_count = 5;
+
+  // The total number of shares across all videos of this channel.
+  int64 shares_count = 6;
+
+  // The total number of comments across all videos of this channel.
+  int64 comments_count = 7;
+
+  // The lifetime engagement rate of this channel. The value is computed as the
+  // total number of likes, shares, and comments across all videos divided by
+  // the total number of videos.
+  double engagement_rate = 8;
+
+  // The average number of views per video in the last 28 days.
+  double average_views_per_video = 9;
+
+  // The average number of likes per video in the last 28 days.
+  double average_likes_per_video = 10;
+
+  // The average number of shares per video in the last 28 days.
+  double average_shares_per_video = 11;
+
+  // The average number of comments per video in the last 28 days.
+  double average_comments_per_video = 12;
+
+  // The total number of views across all Shorts videos of this channel.
+  int64 shorts_views_count = 13;
+
+  // The total number of Shorts videos.
+  int64 shorts_video_count = 14;
+
+  // When true, this channel has published a Shorts video in the last 90 days.
   bool is_active_shorts_creator = 4;
+
+  // When true, this creator can be partnered with to create original branded
+  // content using the Google Ads creator partnership platform, BrandConnect.
+  //
+  // See https://support.google.com/google-ads/answer/13828964 for more
+  // information about BrandConnect.
+  bool is_brand_connect_creator = 15;
 }

 // YouTube Channel insights, and its metadata (such as channel name and channel