--- v17/services/google_ads_service.proto 2024-10-17 03:48:53.000000000 +0000 +++ v18/services/google_ads_service.proto 2024-10-17 03:48:59.000000000 +0000 @@ -482,16 +485,9 @@ // If true, the request is validated but not executed. bool validate_only = 5; - // If true, the total number of results that match the query ignoring the - // LIMIT clause will be included in the response. - // Default is false. - bool return_total_results_count = 7; - - // Determines whether a summary row will be returned. By default, summary row - // is not returned. If requested, the summary row will be sent in a response - // by itself after all other query results are returned. - google.ads.googleads.v17.enums.SummaryRowSettingEnum.SummaryRowSetting - summary_row_setting = 8; + // Settings that allow users to specify request count, summary row, and + // results behavior. + SearchSettings search_settings = 10; } // Response message for @@ -1003,26 +1002,30 @@ keyword_theme_constant = 163; // The label referenced in the query. - google.ads.googleads.v17.resources.Label label = 52; + google.ads.googleads.v18.resources.Label label = 52; // The landing page view referenced in the query. - google.ads.googleads.v17.resources.LandingPageView landing_page_view = 126; + google.ads.googleads.v18.resources.LandingPageView landing_page_view = 126; // The language constant referenced in the query. - google.ads.googleads.v17.resources.LanguageConstant language_constant = 55; + google.ads.googleads.v18.resources.LanguageConstant language_constant = 55; // The location view referenced in the query. - google.ads.googleads.v17.resources.LocationView location_view = 123; + google.ads.googleads.v18.resources.LocationView location_view = 123; // The managed placement view referenced in the query. - google.ads.googleads.v17.resources.ManagedPlacementView + google.ads.googleads.v18.resources.ManagedPlacementView managed_placement_view = 53; + // The content criterion view referenced in the query. + google.ads.googleads.v18.resources.ContentCriterionView + content_criterion_view = 232; + // The media file referenced in the query. - google.ads.googleads.v17.resources.MediaFile media_file = 90; + google.ads.googleads.v18.resources.MediaFile media_file = 90; // The local services employee referenced in the query. - google.ads.googleads.v17.resources.LocalServicesEmployee + google.ads.googleads.v18.resources.LocalServicesEmployee local_services_employee = 223; // The local services verification artifact referenced in the query. @@ -1063,14 +1066,18 @@ 202; // The parental status view referenced in the query. - google.ads.googleads.v17.resources.ParentalStatusView parental_status_view = + google.ads.googleads.v18.resources.ParentalStatusView parental_status_view = 45; // The per store view referenced in the query. - google.ads.googleads.v17.resources.PerStoreView per_store_view = 198; + google.ads.googleads.v18.resources.PerStoreView per_store_view = 198; + + // The performance max placement view referenced in the query. + google.ads.googleads.v18.resources.PerformanceMaxPlacementView + performance_max_placement_view = 233; // The product category referenced in the query. - google.ads.googleads.v17.resources.ProductCategoryConstant + google.ads.googleads.v18.resources.ProductCategoryConstant product_category_constant = 208; // The product group view referenced in the query. @@ -1712,3 +1719,21 @@ MutateUserListResult user_list_result = 16; } } + +// Indicates search settings in request parameter. +message SearchSettings { + // If true, results will be excluded from the response. Otherwise, results + // will be returned. + // Default is false. + bool omit_results = 1; + + // If true, summary row will be included in the response and sent in a + // response by itself after all other query results are returned. + // Default is false. + bool return_summary_row = 2; + + // If true, the total number of results that match the query ignoring the + // LIMIT clause will be included in the response. + // Default is false. + bool return_total_results_count = 3; +}
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 2024-10-17 UTC.
[null,null,["Last updated 2024-10-17 UTC."],[[["Google Ads API v18 introduces `SearchSettings` to manage result behavior, including options to omit results, return a summary row, and return the total results count."],["The `return_total_results_count`, `return_summary_row`, and `validate_only` fields previously in `SearchGoogleAdsRequest` are now part of the nested `SearchSettings` message."],["Resource references in `GoogleAdsField` have been updated from v17 to v18, aligning with the latest API version."],["New resource views, such as `ContentCriterionView` and `PerformanceMaxPlacementView`, are now supported in `GoogleAdsField`."]]],[]]