Stay organized with collections
Save and categorize content based on your preferences.
--- 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
[[["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/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```"]]
