/services/content_creator_insights_service.proto

--- v23/services/content_creator_insights_service.proto 2026-06-18 21:38:50.000000000 +0000
+++ v24/services/content_creator_insights_service.proto 2026-06-18 21:38:57.000000000 +0000
@@ -175,11 +176,19 @@

   // The sub-country geographic locations to search that apply to the criteria.
   // Only supported for
-  // [SearchAttributes][google.ads.googleads.v23.services.GenerateCreatorInsightsRequest.SearchAttributes]
+  // [SearchAttributes][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.SearchAttributes]
   // criteria.
-  repeated google.ads.googleads.v23.common.LocationInfo sub_country_locations =
+  repeated google.ads.googleads.v24.common.LocationInfo sub_country_locations =
       7;

+  // Optional. Optional features to include in the response. By default, only
+  // core insight data is returned. Including supplemental data here will
+  // populate additional fields in the response.
+  repeated
+      google.ads.googleads.v24.enums.ContentCreatorInsightsSupplementalDataEnum
+          .ContentCreatorInsightsSupplementalData supplemental_data = 10
+      [(google.api.field_behavior) = OPTIONAL];
+
   // A criteria used to search for creators and creator insights.
   oneof criteria {
     // The attributes used to identify top creators. Data fetched is based on
@@ -196,8 +207,14 @@

     // YouTube Channel IDs for Creator Insights. Data fetched for channels is
     // based on the list of countries specified in
-    // [country_locations][google.ads.googleads.v23.services.GenerateCreatorInsightsRequest.country_locations].
+    // [country_locations][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.country_locations].
     YouTubeChannels search_channels = 4;
+
+    // Search for relevant creators who make content about the specified topics.
+    // Data fetched is based on the country specified in
+    // [country_locations][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.country_locations].
+    // Note: This option allows searching for one country only.
+    SearchTopics search_topics = 9;
   }
 }

@@ -202,11 +219,24 @@
 }

 // Response message for
-// [ContentCreatorInsightsService.GenerateCreatorInsights][google.ads.googleads.v23.services.ContentCreatorInsightsService.GenerateCreatorInsights].
+// [ContentCreatorInsightsService.GenerateCreatorInsights][google.ads.googleads.v24.services.ContentCreatorInsightsService.GenerateCreatorInsights].
 message GenerateCreatorInsightsResponse {
   // A collection of YouTube Creators, each containing a collection of YouTube
   // Channels maintained by the YouTube Creator.
   repeated YouTubeCreatorInsights creator_insights = 1;
+
+  // Local creators for this topic who have consented to share their location
+  // data. Local creators refers to creators that are based in or post from the
+  // chosen country and are viewed in the chosen country.
+  // Only populated when all of the following are true:
+  //   - The creator request uses search_topics.
+  //   - The Knowledge Graph entity topic has the
+  //   [CREATOR_TOPIC_INSIGHTS][google.ads.googleads.v24.enums.InsightsKnowledgeGraphEntityCapabilitiesEnum.InsightsKnowledgeGraphEntityCapabilities.CREATOR_TOPIC_INSIGHTS]
+  //   capability.
+  //   - Supplemental data
+  //   [LOCAL_CREATOR_DATA][google.ads.googleads.v24.enums.ContentCreatorInsightsSupplementalDataEnum.ContentCreatorInsightsSupplementalData.LOCAL_CREATOR_DATA]
+  //   is requested.
+  repeated YouTubeCreatorInsights local_creator_insights = 2;
 }

 // Request message for
@@ -224,12 +254,29 @@
       insights_application_info = 6 [(google.api.field_behavior) = OPTIONAL];

   // Required. The country to find trends in.
-  google.ads.googleads.v23.common.LocationInfo country_location = 3
+  google.ads.googleads.v24.common.LocationInfo country_location = 3
       [(google.api.field_behavior) = REQUIRED];

+  // Optional. The sub-country geographic locations to search that apply to the
+  // criteria. Only supported for `search_audience` criteria.
+  repeated google.ads.googleads.v24.common.LocationInfo sub_country_locations =
+      8 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Optional features to include in the response. By default, only
+  // core insight data is returned. Including supplemental data here will
+  // populate additional fields in the response.
+  repeated
+      google.ads.googleads.v24.enums.ContentCreatorInsightsSupplementalDataEnum
+          .ContentCreatorInsightsSupplementalData supplemental_data = 7
+      [(google.api.field_behavior) = OPTIONAL];
+
   // The criteria used to search for trending content.
   oneof criteria {
-    // An audience to search for trending content in.
+    // An audience to search for trending content in. Data fetched is based on
+    // the country or sub-country locations specified in
+    // [country_location][google.ads.googleads.v24.services.GenerateTrendingInsightsRequest.country_location]
+    // or
+    // [sub_country_locations][google.ads.googleads.v24.services.GenerateTrendingInsightsRequest.sub_country_locations].
     SearchAudience search_audience = 4;

     // Content topics to return trend information for.
@@ -302,15 +349,8 @@
   // When true, this channel has published a live stream in the last 90 days.
   bool is_active_live_stream_creator = 16;

-  // 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;
-
   // Partnership opportunities available for this creator.
-  repeated google.ads.googleads.v23.enums.PartnershipOpportunityEnum
+  repeated google.ads.googleads.v24.enums.PartnershipOpportunityEnum
       .PartnershipOpportunity partnership_opportunities = 17;
 }

@@ -442,12 +484,25 @@

   // Related videos for this topic. Only populated for trends using
   // search_topics.
-  repeated google.ads.googleads.v23.common.AudienceInsightsAttributeMetadata
+  repeated google.ads.googleads.v24.common.AudienceInsightsAttributeMetadata
       related_videos = 4;

   // Related creators for this topic. Only populated for trends using
   // search_topics.
   repeated YouTubeCreatorInsights related_creators = 5;
+
+  // Related local creators for this topic who have consented to share their
+  // location data. Related local creators refers to creators that are based in
+  // or post from the chosen country and are viewed in the chosen country.
+  // Only populated when all of the following are true:
+  //   - The trend request uses search_topics.
+  //   - The Knowledge Graph entity topic has the
+  //   [CREATOR_TOPIC_INSIGHTS][google.ads.googleads.v24.enums.InsightsKnowledgeGraphEntityCapabilitiesEnum.InsightsKnowledgeGraphEntityCapabilities.CREATOR_TOPIC_INSIGHTS]
+  //   capability.
+  //   - Supplemental data
+  //   [LOCAL_CREATOR_DATA][google.ads.googleads.v24.enums.ContentCreatorInsightsSupplementalDataEnum.ContentCreatorInsightsSupplementalData.LOCAL_CREATOR_DATA]
+  //   is requested.
+  repeated YouTubeCreatorInsights related_local_creators = 8;
 }

 // Metrics associated with a trend insight.