Stay organized with collections
Save and categorize content based on your preferences.
--- 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
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[],[],null,["# /services/content_creator_insights_service.proto\n\n```diff\n--- v19/services/content_creator_insights_service.proto 2025-08-05 14:37:32.000000000 +0000\n+++ v20/services/content_creator_insights_service.proto 2025-08-05 14:37:48.000000000 +0000\n@@ -131,10 +132,19 @@\n // user-defined value.\n string customer_insights_group = 2 [(google.api.field_behavior) = REQUIRED];\n\n+ // Optional. Additional information on the application issuing the request.\n+ google.ads.googleads.v20.common.AdditionalApplicationInfo\n+ insights_application_info = 8 [(google.api.field_behavior) = OPTIONAL];\n+\n // Required. The countries to search that apply to the criteria.\n- repeated google.ads.googleads.v19.common.LocationInfo country_locations = 6\n+ repeated google.ads.googleads.v20.common.LocationInfo country_locations = 6\n [(google.api.field_behavior) = REQUIRED];\n\n+ // The sub-country geographic locations to search that apply to the criteria.\n+ // Only supported for [SearchAttributes] criteria.\n+ repeated google.ads.googleads.v20.common.LocationInfo sub_country_locations =\n+ 7;\n+\n // A criteria used to search for creators and creator insights.\n oneof criteria {\n // The attributes used to identify top creators. Data fetched is based on\n@@ -168,8 +179,12 @@\n // user-defined value.\n string customer_insights_group = 2 [(google.api.field_behavior) = REQUIRED];\n\n+ // Optional. Additional information on the application issuing the request.\n+ google.ads.googleads.v20.common.AdditionalApplicationInfo\n+ insights_application_info = 6 [(google.api.field_behavior) = OPTIONAL];\n+\n // Required. The country to find trends in.\n- google.ads.googleads.v19.common.LocationInfo country_location = 3\n+ google.ads.googleads.v20.common.LocationInfo country_location = 3\n [(google.api.field_behavior) = REQUIRED];\n\n // The criteria used to search for trending content.\n@@ -208,8 +223,47 @@\n // The total number of videos.\n int64 video_count = 3;\n\n- // When true, this channel has published a shorts video in the last 90 days.\n+ // The total number of likes across all videos of this channel.\n+ int64 likes_count = 5;\n+\n+ // The total number of shares across all videos of this channel.\n+ int64 shares_count = 6;\n+\n+ // The total number of comments across all videos of this channel.\n+ int64 comments_count = 7;\n+\n+ // The lifetime engagement rate of this channel. The value is computed as the\n+ // total number of likes, shares, and comments across all videos divided by\n+ // the total number of videos.\n+ double engagement_rate = 8;\n+\n+ // The average number of views per video in the last 28 days.\n+ double average_views_per_video = 9;\n+\n+ // The average number of likes per video in the last 28 days.\n+ double average_likes_per_video = 10;\n+\n+ // The average number of shares per video in the last 28 days.\n+ double average_shares_per_video = 11;\n+\n+ // The average number of comments per video in the last 28 days.\n+ double average_comments_per_video = 12;\n+\n+ // The total number of views across all Shorts videos of this channel.\n+ int64 shorts_views_count = 13;\n+\n+ // The total number of Shorts videos.\n+ int64 shorts_video_count = 14;\n+\n+ // When true, this channel has published a Shorts video in the last 90 days.\n bool is_active_shorts_creator = 4;\n+\n+ // When true, this creator can be partnered with to create original branded\n+ // content using the Google Ads creator partnership platform, BrandConnect.\n+ //\n+ // See https://support.google.com/google-ads/answer/13828964 for more\n+ // information about BrandConnect.\n+ bool is_brand_connect_creator = 15;\n }\n\n // YouTube Channel insights, and its metadata (such as channel name and channel\n```"]]
