/services/audience_insights_service.proto

--- v23/services/audience_insights_service.proto    2026-06-18 21:38:50.000000000 +0000
+++ v24/services/audience_insights_service.proto    2026-06-18 21:38:57.000000000 +0000
@@ -415,7 +416,48 @@
   // only available for the AGE_RANGE, GENDER, AFFINITY_USER_INTEREST and
   // IN_MARKET_USER_INTEREST dimensions, and may not be available for every
   // attribute of those dimensions in every market.
-  google.ads.googleads.v23.common.LocationInfo youtube_reach_location = 6;
+  google.ads.googleads.v24.common.LocationInfo youtube_reach_location = 6;
+
+  // Optional. Additional search options for Knowledge Graph Entities.
+  KnowledgeGraphEntitySearchOptions knowledge_graph_entity_search_options = 8
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Search options for Knowledge Graph Entities.
+message KnowledgeGraphEntitySearchOptions {
+  // Filter options for Knowledge Graph Entities.
+  message SearchFilter {
+    // Optional. A list of entity capability filters supported for
+    // [ContentCreatorInsightsService][google.ads.googleads.v24.services.ContentCreatorInsightsService].
+    // If set, returns entities relevant to the `query_text` and supported for
+    // any of the specified capabilities.
+    //
+    // For example, entity_capability_filters[0] and
+    // entity_capability_filters[1] are combined with OR so that entities
+    // supported for either capability are returned.
+    repeated google.ads.googleads.v24.enums
+        .InsightsKnowledgeGraphEntityCapabilitiesEnum
+        .InsightsKnowledgeGraphEntityCapabilities entity_capability_filters = 1
+        [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Optional. When true, retrieves all available Knowledge Graph Entities
+  // tagged with
+  // [CREATOR_ATTRIBUTE][google.ads.googleads.v24.enums.InsightsKnowledgeGraphEntityCapabilitiesEnum.InsightsKnowledgeGraphEntityCapabilities.CREATOR_ATTRIBUTE].
+  // KNOWLEDGE_GRAPH must be included in
+  // `ListAudienceInsightsAttributesRequest.dimensions` and the `query_text`
+  // must be empty.
+  //
+  // This option cannot be used with
+  // [search_filter][google.ads.googleads.v24.services.KnowledgeGraphEntitySearchOptions.search_filter].
+  // `search_filter` respects the `query_text` when retrieving relevant entities
+  // while this option returns all creator attributes available to use as an
+  // input.
+  bool get_all_creator_attributes = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Filter options for narrowing down the scope of Knowledge Graph
+  // Entities to retrieve.
+  SearchFilter search_filter = 2 [(google.api.field_behavior) = OPTIONAL];
 }

 // Response message for
@@ -665,32 +707,28 @@

   // Household income percentile ranges for the audience.  If absent, the
   // audience does not restrict by household income range.
-  repeated google.ads.googleads.v23.common.IncomeRangeInfo income_ranges = 6;
+  repeated google.ads.googleads.v24.common.IncomeRangeInfo income_ranges = 6;

   // Lineups representing the YouTube content viewed by the audience.
-  repeated google.ads.googleads.v23.common.AudienceInsightsLineup lineups = 10;
+  repeated google.ads.googleads.v24.common.AudienceInsightsLineup lineups = 10;

   // User list to be targeted by the audience.
-  google.ads.googleads.v23.common.UserListInfo user_list = 11;
+  google.ads.googleads.v24.common.UserListInfo user_list = 11;

-  // A combination of entity, category and user interest attributes defining the
-  // audience. The combination has a logical AND-of-ORs structure: Attributes
-  // within each InsightsAudienceAttributeGroup are combined with OR, and
-  // the combinations themselves are combined together with AND.  For example,
-  // the expression (Entity OR Affinity) AND (In-Market OR Category) can be
-  // formed using two InsightsAudienceAttributeGroups with two Attributes
-  // each.
-  repeated InsightsAudienceAttributeGroup topic_audience_combinations = 8;
-}
-
-// A list of AudienceInsightsAttributes.
-message InsightsAudienceAttributeGroup {
-  // Required. A collection of audience attributes to be combined with logical
-  // OR. Attributes need not all be the same dimension.  Only Knowledge Graph
-  // entities, Product & Service Categories, and Affinity and In-Market
-  // audiences are supported in this context.
-  repeated google.ads.googleads.v23.common.AudienceInsightsAttribute
-      attributes = 2 [(google.api.field_behavior) = REQUIRED];
+  // A list of audience attribute groups consisting of one or more Knowledge
+  // Graph entities, Product & Service Categories and user interests that
+  // describe an audience. The groups have a logical AND-of-ORs structure:
+  //
+  // 1. Attributes within each InsightsAudienceAttributeGroup are combined with
+  // OR.
+  //
+  // 2. The groups themselves are combined together with AND.
+  //
+  // For example, an audience (Interest A OR Interest B) AND (Entity C) is
+  // represented using two groups. The first group contains the two interests
+  // and the second group contains the entity.
+  repeated google.ads.googleads.v24.common.InsightsAudienceAttributeGroup
+      topic_audience_combinations = 12;
 }

 // A collection of related attributes of the same type in an audience