--- v23/services/content_creator_insights_service.proto 2026-06-18 21:38:50.000000000 +0000 +++ v24/services/content_creator_insights_service.proto 2026-06-18 21:38:57.000000000 +0000 @@ -175,11 +176,19 @@ // The sub-country geographic locations to search that apply to the criteria. // Only supported for - // [SearchAttributes][google.ads.googleads.v23.services.GenerateCreatorInsightsRequest.SearchAttributes] + // [SearchAttributes][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.SearchAttributes] // criteria. - repeated google.ads.googleads.v23.common.LocationInfo sub_country_locations = + repeated google.ads.googleads.v24.common.LocationInfo sub_country_locations = 7; + // Optional. Optional features to include in the response. By default, only + // core insight data is returned. Including supplemental data here will + // populate additional fields in the response. + repeated + google.ads.googleads.v24.enums.ContentCreatorInsightsSupplementalDataEnum + .ContentCreatorInsightsSupplementalData supplemental_data = 10 + [(google.api.field_behavior) = OPTIONAL]; + // A criteria used to search for creators and creator insights. oneof criteria { // The attributes used to identify top creators. Data fetched is based on @@ -196,8 +207,14 @@ // YouTube Channel IDs for Creator Insights. Data fetched for channels is // based on the list of countries specified in - // [country_locations][google.ads.googleads.v23.services.GenerateCreatorInsightsRequest.country_locations]. + // [country_locations][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.country_locations]. YouTubeChannels search_channels = 4; + + // Search for relevant creators who make content about the specified topics. + // Data fetched is based on the country specified in + // [country_locations][google.ads.googleads.v24.services.GenerateCreatorInsightsRequest.country_locations]. + // Note: This option allows searching for one country only. + SearchTopics search_topics = 9; } } @@ -202,11 +219,24 @@ } // Response message for -// [ContentCreatorInsightsService.GenerateCreatorInsights][google.ads.googleads.v23.services.ContentCreatorInsightsService.GenerateCreatorInsights]. +// [ContentCreatorInsightsService.GenerateCreatorInsights][google.ads.googleads.v24.services.ContentCreatorInsightsService.GenerateCreatorInsights]. message GenerateCreatorInsightsResponse { // A collection of YouTube Creators, each containing a collection of YouTube // Channels maintained by the YouTube Creator. repeated YouTubeCreatorInsights creator_insights = 1; + + // Local creators for this topic who have consented to share their location + // data. Local creators refers to creators that are based in or post from the + // chosen country and are viewed in the chosen country. + // Only populated when all of the following are true: + // - The creator request uses search_topics. + // - The Knowledge Graph entity topic has the + // [CREATOR_TOPIC_INSIGHTS][google.ads.googleads.v24.enums.InsightsKnowledgeGraphEntityCapabilitiesEnum.InsightsKnowledgeGraphEntityCapabilities.CREATOR_TOPIC_INSIGHTS] + // capability. + // - Supplemental data + // [LOCAL_CREATOR_DATA][google.ads.googleads.v24.enums.ContentCreatorInsightsSupplementalDataEnum.ContentCreatorInsightsSupplementalData.LOCAL_CREATOR_DATA] + // is requested. + repeated YouTubeCreatorInsights local_creator_insights = 2; } // Request message for @@ -224,12 +254,29 @@ insights_application_info = 6 [(google.api.field_behavior) = OPTIONAL]; // Required. The country to find trends in. - google.ads.googleads.v23.common.LocationInfo country_location = 3 + google.ads.googleads.v24.common.LocationInfo country_location = 3 [(google.api.field_behavior) = REQUIRED]; + // Optional. The sub-country geographic locations to search that apply to the + // criteria. Only supported for `search_audience` criteria. + repeated google.ads.googleads.v24.common.LocationInfo sub_country_locations = + 8 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Optional features to include in the response. By default, only + // core insight data is returned. Including supplemental data here will + // populate additional fields in the response. + repeated + google.ads.googleads.v24.enums.ContentCreatorInsightsSupplementalDataEnum + .ContentCreatorInsightsSupplementalData supplemental_data = 7 + [(google.api.field_behavior) = OPTIONAL]; + // The criteria used to search for trending content. oneof criteria { - // An audience to search for trending content in. + // An audience to search for trending content in. Data fetched is based on + // the country or sub-country locations specified in + // [country_location][google.ads.googleads.v24.services.GenerateTrendingInsightsRequest.country_location] + // or + // [sub_country_locations][google.ads.googleads.v24.services.GenerateTrendingInsightsRequest.sub_country_locations]. SearchAudience search_audience = 4; // Content topics to return trend information for. @@ -302,15 +349,8 @@ // When true, this channel has published a live stream in the last 90 days. bool is_active_live_stream_creator = 16; - // 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; - // Partnership opportunities available for this creator. - repeated google.ads.googleads.v23.enums.PartnershipOpportunityEnum + repeated google.ads.googleads.v24.enums.PartnershipOpportunityEnum .PartnershipOpportunity partnership_opportunities = 17; } @@ -442,12 +484,25 @@ // Related videos for this topic. Only populated for trends using // search_topics. - repeated google.ads.googleads.v23.common.AudienceInsightsAttributeMetadata + repeated google.ads.googleads.v24.common.AudienceInsightsAttributeMetadata related_videos = 4; // Related creators for this topic. Only populated for trends using // search_topics. repeated YouTubeCreatorInsights related_creators = 5; + + // Related local creators for this topic who have consented to share their + // location data. Related local creators refers to creators that are based in + // or post from the chosen country and are viewed in the chosen country. + // Only populated when all of the following are true: + // - The trend request uses search_topics. + // - The Knowledge Graph entity topic has the + // [CREATOR_TOPIC_INSIGHTS][google.ads.googleads.v24.enums.InsightsKnowledgeGraphEntityCapabilitiesEnum.InsightsKnowledgeGraphEntityCapabilities.CREATOR_TOPIC_INSIGHTS] + // capability. + // - Supplemental data + // [LOCAL_CREATOR_DATA][google.ads.googleads.v24.enums.ContentCreatorInsightsSupplementalDataEnum.ContentCreatorInsightsSupplementalData.LOCAL_CREATOR_DATA] + // is requested. + repeated YouTubeCreatorInsights related_local_creators = 8; } // Metrics associated with a trend insight.
/services/content_creator_insights_service.proto
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-06-19 UTC.