/common/audience_insights_attribute.proto

--- v18/common/audience_insights_attribute.proto    2025-02-24 15:48:54.000000000 +0000
+++ v19/common/audience_insights_attribute.proto    2025-02-24 15:48:59.000000000 +0000
@@ -62,16 +63,29 @@
   // 1. This field is not populated in every response.
   double subscriber_share = 9;

+  // The share of viewers within this attribute, between and including 0 and
+  // 1. This field is not populated in every response.
+  double viewer_share = 13;
+
   // Metadata specific to the dimension of this attribute.
   oneof dimension_metadata {
     // Special metadata for a YouTube channel.
     YouTubeChannelAttributeMetadata youtube_channel_metadata = 5;

+    // Special metadata for a YouTube video.
+    YouTubeVideoAttributeMetadata youtube_video_metadata = 10;
+
     // Special metadata for a YouTube Dynamic Lineup.
     DynamicLineupAttributeMetadata dynamic_attribute_metadata = 6;

     // Special metadata for a Location.
     LocationAttributeMetadata location_attribute_metadata = 7;
+
+    // Special metadata for a User Interest.
+    UserInterestAttributeMetadata user_interest_attribute_metadata = 11;
+
+    // Special metadata for a Knowledge Graph Entity.
+    KnowledgeGraphAttributeMetadata knowledge_graph_attribute_metadata = 12;
   }
 }

@@ -111,6 +125,21 @@

     // A YouTube channel.
     YouTubeChannelInfo youtube_channel = 10;
+
+    // A YouTube video.
+    YouTubeVideoInfo youtube_video = 11;
+  }
+}
+
+// An entity or category representing a topic that defines an audience.
+message AudienceInsightsTopic {
+  // An entity or category attribute.
+  oneof topic {
+    // A Knowledge Graph entity
+    AudienceInsightsEntity entity = 1;
+
+    // A Product & Service category
+    AudienceInsightsCategory category = 2;
   }
 }

@@ -139,6 +168,15 @@
   int64 subscriber_count = 1;
 }

+// Metadata for a YouTube video attribute.
+message YouTubeVideoAttributeMetadata {
+  // The URL of the video thumbnail, prefixed by "https://img.youtube.com/".
+  string thumbnail_url = 1;
+
+  // The URL of the video, prefixed by "https://www.youtube.com/".
+  string video_url = 2;
+}
+
 // Metadata associated with a Dynamic Lineup attribute.
 message DynamicLineupAttributeMetadata {
   // A YouTube channel returned as an example of the content in a lineup.
@@ -175,3 +213,18 @@
   // in.
   LocationInfo country_location = 1;
 }
+
+// Metadata associated with a User Interest attribute.
+message UserInterestAttributeMetadata {
+  // English language text description of the user interest category (200
+  // characters max).
+  string user_interest_description = 1;
+}
+
+// Metadata associated with a Knowledge Graph Entity attribute.
+message KnowledgeGraphAttributeMetadata {
+  // The capabilities of the entity used in [ContentCreatorInsightsService][].
+  repeated google.ads.googleads.v19.enums
+      .InsightsKnowledgeGraphEntityCapabilitiesEnum
+      .InsightsKnowledgeGraphEntityCapabilities entity_capabilities = 1;
+}