--- v19/services/audience_insights_service.proto 2025-08-05 14:37:32.000000000 +0000 +++ v20/services/audience_insights_service.proto 2025-08-05 14:37:48.000000000 +0000 @@ -218,6 +219,10 @@ // The name of the customer being planned for. This is a user-defined value. string customer_insights_group = 4; + + // Optional. Additional information on the application issuing the request. + google.ads.googleads.v20.common.AdditionalApplicationInfo + insights_application_info = 5 [(google.api.field_behavior) = OPTIONAL]; } // The response message for @@ -249,15 +254,19 @@ // Required. The audience dimensions for which composition insights should be // returned. Supported dimensions are KNOWLEDGE_GRAPH, GEO_TARGET_COUNTRY, - // SUB_COUNTRY_LOCATION, YOUTUBE_CHANNEL, YOUTUBE_DYNAMIC_LINEUP, + // SUB_COUNTRY_LOCATION, YOUTUBE_CHANNEL, YOUTUBE_LINEUP, // AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, PARENTAL_STATUS, // INCOME_RANGE, AGE_RANGE, and GENDER. - repeated google.ads.googleads.v19.enums.AudienceInsightsDimensionEnum + repeated google.ads.googleads.v20.enums.AudienceInsightsDimensionEnum .AudienceInsightsDimension dimensions = 4 [(google.api.field_behavior) = REQUIRED]; // The name of the customer being planned for. This is a user-defined value. string customer_insights_group = 5; + + // Optional. Additional information on the application issuing the request. + google.ads.googleads.v20.common.AdditionalApplicationInfo + insights_application_info = 7 [(google.api.field_behavior) = OPTIONAL]; } // Response message for @@ -279,6 +288,10 @@ // user-defined value. string customer_insights_group = 5 [(google.api.field_behavior) = OPTIONAL]; + // 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 audience to get suggestions for. oneof audience_input { // Provide a seed audience to get suggestions for. @@ -357,6 +370,10 @@ // The name of the customer being planned for. This is a user-defined value. string customer_insights_group = 4; + // Optional. Additional information on the application issuing the request. + google.ads.googleads.v20.common.AdditionalApplicationInfo + insights_application_info = 7 [(google.api.field_behavior) = OPTIONAL]; + // If SUB_COUNTRY_LOCATION attributes are one of the requested dimensions and // this field is present, then the SUB_COUNTRY_LOCATION attributes returned // will be located in these countries. If this field is absent, then location @@ -374,19 +391,23 @@ } // Response message for -// [AudienceInsightsService.ListAudienceInsightsAttributes][google.ads.googleads.v19.services.AudienceInsightsService.ListAudienceInsightsAttributes]. +// [AudienceInsightsService.ListAudienceInsightsAttributes][google.ads.googleads.v20.services.AudienceInsightsService.ListAudienceInsightsAttributes]. message ListAudienceInsightsAttributesResponse { // The attributes matching the search query. - repeated google.ads.googleads.v19.common.AudienceInsightsAttributeMetadata + repeated google.ads.googleads.v20.common.AudienceInsightsAttributeMetadata attributes = 2; } // Request message for -// [AudienceInsightsService.ListInsightsEligibleDates][google.ads.googleads.v19.services.AudienceInsightsService.ListInsightsEligibleDates]. -message ListInsightsEligibleDatesRequest {} +// [AudienceInsightsService.ListInsightsEligibleDates][google.ads.googleads.v20.services.AudienceInsightsService.ListInsightsEligibleDates]. +message ListInsightsEligibleDatesRequest { + // Optional. Additional information on the application issuing the request. + google.ads.googleads.v20.common.AdditionalApplicationInfo + insights_application_info = 1 [(google.api.field_behavior) = OPTIONAL]; +} // Response message for -// [AudienceInsightsService.ListInsightsEligibleDates][google.ads.googleads.v19.services.AudienceInsightsService.ListInsightsEligibleDates]. +// [AudienceInsightsService.ListInsightsEligibleDates][google.ads.googleads.v20.services.AudienceInsightsService.ListInsightsEligibleDates]. message ListInsightsEligibleDatesResponse { // The months for which AudienceInsights data is currently // available, each represented as a string in the form "YYYY-MM". @@ -419,12 +440,16 @@ // Required. The types of attributes of which to calculate the overlap with // the primary_attribute. The values must be a subset of // AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE and GENDER. - repeated google.ads.googleads.v19.enums.AudienceInsightsDimensionEnum + repeated google.ads.googleads.v20.enums.AudienceInsightsDimensionEnum .AudienceInsightsDimension dimensions = 4 [(google.api.field_behavior) = REQUIRED]; // The name of the customer being planned for. This is a user-defined value. string customer_insights_group = 5; + + // Optional. Additional information on the application issuing the request. + google.ads.googleads.v20.common.AdditionalApplicationInfo + insights_application_info = 7 [(google.api.field_behavior) = OPTIONAL]; } // Response message for @@ -477,6 +502,10 @@ // Optional. The name of the customer being planned for. This is a // user-defined value. string customer_insights_group = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Additional information on the application issuing the request. + google.ads.googleads.v20.common.AdditionalApplicationInfo + insights_application_info = 4 [(google.api.field_behavior) = OPTIONAL]; } // Response message for @@ -581,11 +610,10 @@ // Household income percentile ranges for the audience. If absent, the // audience does not restrict by household income range. - repeated google.ads.googleads.v19.common.IncomeRangeInfo income_ranges = 6; + repeated google.ads.googleads.v20.common.IncomeRangeInfo income_ranges = 6; - // Dynamic lineups representing the YouTube content viewed by the audience. - repeated google.ads.googleads.v19.common.AudienceInsightsDynamicLineup - dynamic_lineups = 9; + // Lineups representing the YouTube content viewed by the audience. + repeated google.ads.googleads.v20.common.AudienceInsightsLineup lineups = 10; // A combination of entity, category and user interest attributes defining the // audience. The combination has a logical AND-of-ORs structure: Attributes
/services/audience_insights_service.proto
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[],[],null,["# /services/audience_insights_service.proto\n\n```diff\n--- v19/services/audience_insights_service.proto 2025-08-05 14:37:32.000000000 +0000\n+++ v20/services/audience_insights_service.proto 2025-08-05 14:37:48.000000000 +0000\n@@ -218,6 +219,10 @@\n\n // The name of the customer being planned for. This is a user-defined value.\n string customer_insights_group = 4;\n+\n+ // Optional. Additional information on the application issuing the request.\n+ google.ads.googleads.v20.common.AdditionalApplicationInfo\n+ insights_application_info = 5 [(google.api.field_behavior) = OPTIONAL];\n }\n\n // The response message for\n@@ -249,15 +254,19 @@\n\n // Required. The audience dimensions for which composition insights should be\n // returned. Supported dimensions are KNOWLEDGE_GRAPH, GEO_TARGET_COUNTRY,\n- // SUB_COUNTRY_LOCATION, YOUTUBE_CHANNEL, YOUTUBE_DYNAMIC_LINEUP,\n+ // SUB_COUNTRY_LOCATION, YOUTUBE_CHANNEL, YOUTUBE_LINEUP,\n // AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, PARENTAL_STATUS,\n // INCOME_RANGE, AGE_RANGE, and GENDER.\n- repeated google.ads.googleads.v19.enums.AudienceInsightsDimensionEnum\n+ repeated google.ads.googleads.v20.enums.AudienceInsightsDimensionEnum\n .AudienceInsightsDimension dimensions = 4\n [(google.api.field_behavior) = REQUIRED];\n\n // The name of the customer being planned for. This is a user-defined value.\n string customer_insights_group = 5;\n+\n+ // Optional. Additional information on the application issuing the request.\n+ google.ads.googleads.v20.common.AdditionalApplicationInfo\n+ insights_application_info = 7 [(google.api.field_behavior) = OPTIONAL];\n }\n\n // Response message for\n@@ -279,6 +288,10 @@\n // user-defined value.\n string customer_insights_group = 5 [(google.api.field_behavior) = OPTIONAL];\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 audience to get suggestions for.\n oneof audience_input {\n // Provide a seed audience to get suggestions for.\n@@ -357,6 +370,10 @@\n // The name of the customer being planned for. This is a user-defined value.\n string customer_insights_group = 4;\n\n+ // Optional. Additional information on the application issuing the request.\n+ google.ads.googleads.v20.common.AdditionalApplicationInfo\n+ insights_application_info = 7 [(google.api.field_behavior) = OPTIONAL];\n+\n // If SUB_COUNTRY_LOCATION attributes are one of the requested dimensions and\n // this field is present, then the SUB_COUNTRY_LOCATION attributes returned\n // will be located in these countries. If this field is absent, then location\n@@ -374,19 +391,23 @@\n }\n\n // Response message for\n-// [AudienceInsightsService.ListAudienceInsightsAttributes][google.ads.googleads.v19.services.AudienceInsightsService.ListAudienceInsightsAttributes].\n+// [AudienceInsightsService.ListAudienceInsightsAttributes][google.ads.googleads.v20.services.AudienceInsightsService.ListAudienceInsightsAttributes].\n message ListAudienceInsightsAttributesResponse {\n // The attributes matching the search query.\n- repeated google.ads.googleads.v19.common.AudienceInsightsAttributeMetadata\n+ repeated google.ads.googleads.v20.common.AudienceInsightsAttributeMetadata\n attributes = 2;\n }\n\n // Request message for\n-// [AudienceInsightsService.ListInsightsEligibleDates][google.ads.googleads.v19.services.AudienceInsightsService.ListInsightsEligibleDates].\n-message ListInsightsEligibleDatesRequest {}\n+// [AudienceInsightsService.ListInsightsEligibleDates][google.ads.googleads.v20.services.AudienceInsightsService.ListInsightsEligibleDates].\n+message ListInsightsEligibleDatesRequest {\n+ // Optional. Additional information on the application issuing the request.\n+ google.ads.googleads.v20.common.AdditionalApplicationInfo\n+ insights_application_info = 1 [(google.api.field_behavior) = OPTIONAL];\n+}\n\n // Response message for\n-// [AudienceInsightsService.ListInsightsEligibleDates][google.ads.googleads.v19.services.AudienceInsightsService.ListInsightsEligibleDates].\n+// [AudienceInsightsService.ListInsightsEligibleDates][google.ads.googleads.v20.services.AudienceInsightsService.ListInsightsEligibleDates].\n message ListInsightsEligibleDatesResponse {\n // The months for which AudienceInsights data is currently\n // available, each represented as a string in the form \"YYYY-MM\".\n@@ -419,12 +440,16 @@\n // Required. The types of attributes of which to calculate the overlap with\n // the primary_attribute. The values must be a subset of\n // AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE and GENDER.\n- repeated google.ads.googleads.v19.enums.AudienceInsightsDimensionEnum\n+ repeated google.ads.googleads.v20.enums.AudienceInsightsDimensionEnum\n .AudienceInsightsDimension dimensions = 4\n [(google.api.field_behavior) = REQUIRED];\n\n // The name of the customer being planned for. This is a user-defined value.\n string customer_insights_group = 5;\n+\n+ // Optional. Additional information on the application issuing the request.\n+ google.ads.googleads.v20.common.AdditionalApplicationInfo\n+ insights_application_info = 7 [(google.api.field_behavior) = OPTIONAL];\n }\n\n // Response message for\n@@ -477,6 +502,10 @@\n // Optional. The name of the customer being planned for. This is a\n // user-defined value.\n string customer_insights_group = 3 [(google.api.field_behavior) = OPTIONAL];\n+\n+ // Optional. Additional information on the application issuing the request.\n+ google.ads.googleads.v20.common.AdditionalApplicationInfo\n+ insights_application_info = 4 [(google.api.field_behavior) = OPTIONAL];\n }\n\n // Response message for\n@@ -581,11 +610,10 @@\n\n // Household income percentile ranges for the audience. If absent, the\n // audience does not restrict by household income range.\n- repeated google.ads.googleads.v19.common.IncomeRangeInfo income_ranges = 6;\n+ repeated google.ads.googleads.v20.common.IncomeRangeInfo income_ranges = 6;\n\n- // Dynamic lineups representing the YouTube content viewed by the audience.\n- repeated google.ads.googleads.v19.common.AudienceInsightsDynamicLineup\n- dynamic_lineups = 9;\n+ // Lineups representing the YouTube content viewed by the audience.\n+ repeated google.ads.googleads.v20.common.AudienceInsightsLineup lineups = 10;\n\n // A combination of entity, category and user interest attributes defining the\n // audience. The combination has a logical AND-of-ORs structure: Attributes\n```"]]