/common/audience_insights_attribute.proto

--- v20/common/audience_insights_attribute.proto    2025-08-05 14:39:39.000000000 +0000
+++ v21/common/audience_insights_attribute.proto    2025-08-05 14:39:46.000000000 +0000
@@ -86,6 +87,9 @@

     // Special metadata for a Knowledge Graph Entity.
     KnowledgeGraphAttributeMetadata knowledge_graph_attribute_metadata = 12;
+
+    // Special metadata for a User List.
+    UserListAttributeMetadata user_list_attribute_metadata = 15;
   }
 }

@@ -131,6 +136,9 @@

     // A device type. (Mobile, Desktop, Tablet)
     DeviceInfo device = 12;
+
+    // A User List.
+    UserListInfo user_list = 14;
   }
 }

@@ -178,6 +186,15 @@

   // The URL of the video, prefixed by "https://www.youtube.com/".
   string video_url = 2;
+
+  // The total number of views.
+  int64 views_count = 3;
+
+  // The total number of likes.
+  int64 likes_count = 4;
+
+  // The total number of comments.
+  int64 comments_count = 5;
 }

 // Metadata associated with a Lineup attribute.
@@ -227,7 +244,24 @@
 // Metadata associated with a Knowledge Graph Entity attribute.
 message KnowledgeGraphAttributeMetadata {
   // The capabilities of the entity used in [ContentCreatorInsightsService][].
-  repeated google.ads.googleads.v20.enums
+  repeated google.ads.googleads.v21.enums
       .InsightsKnowledgeGraphEntityCapabilitiesEnum
       .InsightsKnowledgeGraphEntityCapabilities entity_capabilities = 1;
+
+  // A list of CATEGORY attributes related to this entity.
+  repeated AudienceInsightsAttributeMetadata related_categories = 2;
+}
+
+// Metadata associated with a User List attribute.
+message UserListAttributeMetadata {
+  // The user list type.
+  google.ads.googleads.v21.enums.UserListTypeEnum.UserListType user_list_type =
+      1;
+}
+
+// A group of audience attributes with metadata, returned in response to a
+// search.
+message AudienceInsightsAttributeMetadataGroup {
+  // Attributes with metadata returned in response to a search.
+  repeated AudienceInsightsAttributeMetadata attributes = 1;
 }