--- 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
/services/content_creator_insights_service.proto
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-21 UTC.
[null,null,["Последнее обновление: 2025-08-21 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```"]]