apache-airflow-providers-google 8.12.0rc1__py3-none-any.whl → 9.0.0rc2__py3-none-any.whl

airflow/providers/google_vendor/googleads/v12/resources/types/recommendation.py

@@ -0,0 +1,941 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+import proto  # type: ignore
+
+from airflow.providers.google_vendor.googleads.v12.common.types import criteria
+from airflow.providers.google_vendor.googleads.v12.common.types import extensions
+from airflow.providers.google_vendor.googleads.v12.enums.types import keyword_match_type
+from airflow.providers.google_vendor.googleads.v12.enums.types import recommendation_type
+from airflow.providers.google_vendor.googleads.v12.enums.types import (
+    target_cpa_opt_in_recommendation_goal,
+)
+from airflow.providers.google_vendor.googleads.v12.resources.types import ad as gagr_ad
+
+
+__protobuf__ = proto.module(
+    package="airflow.providers.google_vendor.googleads.v12.resources",
+    marshal="google.ads.googleads.v12",
+    manifest={"Recommendation",},
+)
+
+
+class Recommendation(proto.Message):
+    r"""A recommendation.
+
+    This message has `oneof`_ fields (mutually exclusive fields).
+    For each oneof, at most one member field can be set at the same time.
+    Setting any member of the oneof automatically clears all other
+    members.
+
+    .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
+
+    Attributes:
+        resource_name (str):
+            Immutable. The resource name of the recommendation.
+
+            ``customers/{customer_id}/recommendations/{recommendation_id}``
+        type_ (google.ads.googleads.v12.enums.types.RecommendationTypeEnum.RecommendationType):
+            Output only. The type of recommendation.
+        impact (google.ads.googleads.v12.resources.types.Recommendation.RecommendationImpact):
+            Output only. The impact on account
+            performance as a result of applying the
+            recommendation.
+        campaign_budget (str):
+            Output only. The budget targeted by this recommendation.
+            This will be set only when the recommendation affects a
+            single campaign budget.
+
+            This field will be set for the following recommendation
+            types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET,
+            MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET
+
+            This field is a member of `oneof`_ ``_campaign_budget``.
+        campaign (str):
+            Output only. The campaign targeted by this recommendation.
+            This will be set only when the recommendation affects a
+            single campaign.
+
+            This field will be set for the following recommendation
+            types: CALL_EXTENSION, CALLOUT_EXTENSION,
+            ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD,
+            KEYWORD_MATCH_TYPE,
+            UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX,
+            MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN,
+            OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD,
+            RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN,
+            DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION,
+            TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD,
+            UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX ,
+            RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS
+
+            This field is a member of `oneof`_ ``_campaign``.
+        ad_group (str):
+            Output only. The ad group targeted by this recommendation.
+            This will be set only when the recommendation affects a
+            single ad group.
+
+            This field will be set for the following recommendation
+            types: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD,
+            RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD
+
+            This field is a member of `oneof`_ ``_ad_group``.
+        dismissed (bool):
+            Output only. Whether the recommendation is
+            dismissed or not.
+
+            This field is a member of `oneof`_ ``_dismissed``.
+        campaign_budget_recommendation (google.ads.googleads.v12.resources.types.Recommendation.CampaignBudgetRecommendation):
+            Output only. The campaign budget
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        forecasting_campaign_budget_recommendation (google.ads.googleads.v12.resources.types.Recommendation.CampaignBudgetRecommendation):
+            Output only. The forecasting campaign budget
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        keyword_recommendation (google.ads.googleads.v12.resources.types.Recommendation.KeywordRecommendation):
+            Output only. The keyword recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        text_ad_recommendation (google.ads.googleads.v12.resources.types.Recommendation.TextAdRecommendation):
+            Output only. Add expanded text ad
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        target_cpa_opt_in_recommendation (google.ads.googleads.v12.resources.types.Recommendation.TargetCpaOptInRecommendation):
+            Output only. The TargetCPA opt-in
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        maximize_conversions_opt_in_recommendation (google.ads.googleads.v12.resources.types.Recommendation.MaximizeConversionsOptInRecommendation):
+            Output only. The MaximizeConversions Opt-In
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        enhanced_cpc_opt_in_recommendation (google.ads.googleads.v12.resources.types.Recommendation.EnhancedCpcOptInRecommendation):
+            Output only. The Enhanced Cost-Per-Click
+            Opt-In recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        search_partners_opt_in_recommendation (google.ads.googleads.v12.resources.types.Recommendation.SearchPartnersOptInRecommendation):
+            Output only. The Search Partners Opt-In
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        maximize_clicks_opt_in_recommendation (google.ads.googleads.v12.resources.types.Recommendation.MaximizeClicksOptInRecommendation):
+            Output only. The MaximizeClicks Opt-In
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        optimize_ad_rotation_recommendation (google.ads.googleads.v12.resources.types.Recommendation.OptimizeAdRotationRecommendation):
+            Output only. The Optimize Ad Rotation
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        callout_extension_recommendation (google.ads.googleads.v12.resources.types.Recommendation.CalloutExtensionRecommendation):
+            Output only. The Callout extension
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        sitelink_extension_recommendation (google.ads.googleads.v12.resources.types.Recommendation.SitelinkExtensionRecommendation):
+            Output only. The Sitelink extension
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        call_extension_recommendation (google.ads.googleads.v12.resources.types.Recommendation.CallExtensionRecommendation):
+            Output only. The Call extension
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        keyword_match_type_recommendation (google.ads.googleads.v12.resources.types.Recommendation.KeywordMatchTypeRecommendation):
+            Output only. The keyword match type
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        move_unused_budget_recommendation (google.ads.googleads.v12.resources.types.Recommendation.MoveUnusedBudgetRecommendation):
+            Output only. The move unused budget
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        target_roas_opt_in_recommendation (google.ads.googleads.v12.resources.types.Recommendation.TargetRoasOptInRecommendation):
+            Output only. The Target ROAS opt-in
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        responsive_search_ad_recommendation (google.ads.googleads.v12.resources.types.Recommendation.ResponsiveSearchAdRecommendation):
+            Output only. The add responsive search ad
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        marginal_roi_campaign_budget_recommendation (google.ads.googleads.v12.resources.types.Recommendation.CampaignBudgetRecommendation):
+            Output only. The marginal ROI campaign budget
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        use_broad_match_keyword_recommendation (google.ads.googleads.v12.resources.types.Recommendation.UseBroadMatchKeywordRecommendation):
+            Output only. The use broad match keyword
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        responsive_search_ad_asset_recommendation (google.ads.googleads.v12.resources.types.Recommendation.ResponsiveSearchAdAssetRecommendation):
+            Output only. The responsive search ad asset
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        upgrade_smart_shopping_campaign_to_performance_max_recommendation (google.ads.googleads.v12.resources.types.Recommendation.UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation):
+            Output only. The upgrade a Smart Shopping
+            campaign to a Performance Max campaign
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        responsive_search_ad_improve_ad_strength_recommendation (google.ads.googleads.v12.resources.types.Recommendation.ResponsiveSearchAdImproveAdStrengthRecommendation):
+            Output only. The responsive search ad improve
+            ad strength recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        display_expansion_opt_in_recommendation (google.ads.googleads.v12.resources.types.Recommendation.DisplayExpansionOptInRecommendation):
+            Output only. The Display Expansion opt-in
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        upgrade_local_campaign_to_performance_max_recommendation (google.ads.googleads.v12.resources.types.Recommendation.UpgradeLocalCampaignToPerformanceMaxRecommendation):
+            Output only. The upgrade a Local campaign to
+            a Performance Max campaign recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        raise_target_cpa_bid_too_low_recommendation (google.ads.googleads.v12.resources.types.Recommendation.RaiseTargetCpaBidTooLowRecommendation):
+            Output only. The raise target CPA bid too low
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+        forecasting_set_target_roas_recommendation (google.ads.googleads.v12.resources.types.Recommendation.ForecastingSetTargetRoasRecommendation):
+            Output only. The forecasting set target ROAS
+            recommendation.
+
+            This field is a member of `oneof`_ ``recommendation``.
+    """
+
+    class RecommendationImpact(proto.Message):
+        r"""The impact of making the change as described in the
+        recommendation. Some types of recommendations may not have
+        impact information.
+
+        Attributes:
+            base_metrics (google.ads.googleads.v12.resources.types.Recommendation.RecommendationMetrics):
+                Output only. Base metrics at the time the
+                recommendation was generated.
+            potential_metrics (google.ads.googleads.v12.resources.types.Recommendation.RecommendationMetrics):
+                Output only. Estimated metrics if the
+                recommendation is applied.
+        """
+
+        base_metrics = proto.Field(
+            proto.MESSAGE,
+            number=1,
+            message="Recommendation.RecommendationMetrics",
+        )
+        potential_metrics = proto.Field(
+            proto.MESSAGE,
+            number=2,
+            message="Recommendation.RecommendationMetrics",
+        )
+
+    class RecommendationMetrics(proto.Message):
+        r"""Weekly account performance metrics. For some recommendation
+        types, these are averaged over the past 90-day period and hence
+        can be fractional.
+
+        Attributes:
+            impressions (float):
+                Output only. Number of ad impressions.
+
+                This field is a member of `oneof`_ ``_impressions``.
+            clicks (float):
+                Output only. Number of ad clicks.
+
+                This field is a member of `oneof`_ ``_clicks``.
+            cost_micros (int):
+                Output only. Cost (in micros) for
+                advertising, in the local currency for the
+                account.
+
+                This field is a member of `oneof`_ ``_cost_micros``.
+            conversions (float):
+                Output only. Number of conversions.
+
+                This field is a member of `oneof`_ ``_conversions``.
+            video_views (float):
+                Output only. Number of video views for a
+                video ad campaign.
+
+                This field is a member of `oneof`_ ``_video_views``.
+        """
+
+        impressions = proto.Field(proto.DOUBLE, number=6, optional=True,)
+        clicks = proto.Field(proto.DOUBLE, number=7, optional=True,)
+        cost_micros = proto.Field(proto.INT64, number=8, optional=True,)
+        conversions = proto.Field(proto.DOUBLE, number=9, optional=True,)
+        video_views = proto.Field(proto.DOUBLE, number=10, optional=True,)
+
+    class CampaignBudgetRecommendation(proto.Message):
+        r"""The budget recommendation for budget constrained campaigns.
+
+        Attributes:
+            current_budget_amount_micros (int):
+                Output only. The current budget amount in
+                micros.
+
+                This field is a member of `oneof`_ ``_current_budget_amount_micros``.
+            recommended_budget_amount_micros (int):
+                Output only. The recommended budget amount in
+                micros.
+
+                This field is a member of `oneof`_ ``_recommended_budget_amount_micros``.
+            budget_options (Sequence[google.ads.googleads.v12.resources.types.Recommendation.CampaignBudgetRecommendation.CampaignBudgetRecommendationOption]):
+                Output only. The budget amounts and
+                associated impact estimates for some values of
+                possible budget amounts.
+        """
+
+        class CampaignBudgetRecommendationOption(proto.Message):
+            r"""The impact estimates for a given budget amount.
+
+            Attributes:
+                budget_amount_micros (int):
+                    Output only. The budget amount for this
+                    option.
+
+                    This field is a member of `oneof`_ ``_budget_amount_micros``.
+                impact (google.ads.googleads.v12.resources.types.Recommendation.RecommendationImpact):
+                    Output only. The impact estimate if budget is
+                    changed to amount specified in this option.
+            """
+
+            budget_amount_micros = proto.Field(
+                proto.INT64, number=3, optional=True,
+            )
+            impact = proto.Field(
+                proto.MESSAGE,
+                number=2,
+                message="Recommendation.RecommendationImpact",
+            )
+
+        current_budget_amount_micros = proto.Field(
+            proto.INT64, number=7, optional=True,
+        )
+        recommended_budget_amount_micros = proto.Field(
+            proto.INT64, number=8, optional=True,
+        )
+        budget_options = proto.RepeatedField(
+            proto.MESSAGE,
+            number=3,
+            message="Recommendation.CampaignBudgetRecommendation.CampaignBudgetRecommendationOption",
+        )
+
+    class KeywordRecommendation(proto.Message):
+        r"""The keyword recommendation.
+
+        Attributes:
+            keyword (google.ads.googleads.v12.common.types.KeywordInfo):
+                Output only. The recommended keyword.
+            recommended_cpc_bid_micros (int):
+                Output only. The recommended CPC
+                (cost-per-click) bid.
+
+                This field is a member of `oneof`_ ``_recommended_cpc_bid_micros``.
+        """
+
+        keyword = proto.Field(
+            proto.MESSAGE, number=1, message=criteria.KeywordInfo,
+        )
+        recommended_cpc_bid_micros = proto.Field(
+            proto.INT64, number=3, optional=True,
+        )
+
+    class TextAdRecommendation(proto.Message):
+        r"""The text ad recommendation.
+
+        Attributes:
+            ad (google.ads.googleads.v12.resources.types.Ad):
+                Output only. Recommended ad.
+            creation_date (str):
+                Output only. Creation date of the recommended
+                ad. YYYY-MM-DD format, for example, 2018-04-17.
+
+                This field is a member of `oneof`_ ``_creation_date``.
+            auto_apply_date (str):
+                Output only. Date, if present, is the
+                earliest when the recommendation will be auto
+                applied. YYYY-MM-DD format, for example,
+                2018-04-17.
+
+                This field is a member of `oneof`_ ``_auto_apply_date``.
+        """
+
+        ad = proto.Field(proto.MESSAGE, number=1, message=gagr_ad.Ad,)
+        creation_date = proto.Field(proto.STRING, number=4, optional=True,)
+        auto_apply_date = proto.Field(proto.STRING, number=5, optional=True,)
+
+    class TargetCpaOptInRecommendation(proto.Message):
+        r"""The Target CPA opt-in recommendation.
+
+        Attributes:
+            options (Sequence[google.ads.googleads.v12.resources.types.Recommendation.TargetCpaOptInRecommendation.TargetCpaOptInRecommendationOption]):
+                Output only. The available goals and
+                corresponding options for Target CPA strategy.
+            recommended_target_cpa_micros (int):
+                Output only. The recommended average CPA
+                target. See required budget amount and impact of
+                using this recommendation in options list.
+
+                This field is a member of `oneof`_ ``_recommended_target_cpa_micros``.
+        """
+
+        class TargetCpaOptInRecommendationOption(proto.Message):
+            r"""The Target CPA opt-in option with impact estimate.
+
+            Attributes:
+                goal (google.ads.googleads.v12.enums.types.TargetCpaOptInRecommendationGoalEnum.TargetCpaOptInRecommendationGoal):
+                    Output only. The goal achieved by this
+                    option.
+                target_cpa_micros (int):
+                    Output only. Average CPA target.
+
+                    This field is a member of `oneof`_ ``_target_cpa_micros``.
+                required_campaign_budget_amount_micros (int):
+                    Output only. The minimum campaign budget, in
+                    local currency for the account, required to
+                    achieve the target CPA. Amount is specified in
+                    micros, where one million is equivalent to one
+                    currency unit.
+
+                    This field is a member of `oneof`_ ``_required_campaign_budget_amount_micros``.
+                impact (google.ads.googleads.v12.resources.types.Recommendation.RecommendationImpact):
+                    Output only. The impact estimate if this
+                    option is selected.
+            """
+
+            goal = proto.Field(
+                proto.ENUM,
+                number=1,
+                enum=target_cpa_opt_in_recommendation_goal.TargetCpaOptInRecommendationGoalEnum.TargetCpaOptInRecommendationGoal,
+            )
+            target_cpa_micros = proto.Field(
+                proto.INT64, number=5, optional=True,
+            )
+            required_campaign_budget_amount_micros = proto.Field(
+                proto.INT64, number=6, optional=True,
+            )
+            impact = proto.Field(
+                proto.MESSAGE,
+                number=4,
+                message="Recommendation.RecommendationImpact",
+            )
+
+        options = proto.RepeatedField(
+            proto.MESSAGE,
+            number=1,
+            message="Recommendation.TargetCpaOptInRecommendation.TargetCpaOptInRecommendationOption",
+        )
+        recommended_target_cpa_micros = proto.Field(
+            proto.INT64, number=3, optional=True,
+        )
+
+    class MaximizeConversionsOptInRecommendation(proto.Message):
+        r"""The Maximize Conversions Opt-In recommendation.
+
+        Attributes:
+            recommended_budget_amount_micros (int):
+                Output only. The recommended new budget
+                amount.
+
+                This field is a member of `oneof`_ ``_recommended_budget_amount_micros``.
+        """
+
+        recommended_budget_amount_micros = proto.Field(
+            proto.INT64, number=2, optional=True,
+        )
+
+    class EnhancedCpcOptInRecommendation(proto.Message):
+        r"""The Enhanced Cost-Per-Click Opt-In recommendation.
+        """
+
+    class SearchPartnersOptInRecommendation(proto.Message):
+        r"""The Search Partners Opt-In recommendation.
+        """
+
+    class MaximizeClicksOptInRecommendation(proto.Message):
+        r"""The Maximize Clicks opt-in recommendation.
+
+        Attributes:
+            recommended_budget_amount_micros (int):
+                Output only. The recommended new budget
+                amount. Only set if the current budget is too
+                high.
+
+                This field is a member of `oneof`_ ``_recommended_budget_amount_micros``.
+        """
+
+        recommended_budget_amount_micros = proto.Field(
+            proto.INT64, number=2, optional=True,
+        )
+
+    class OptimizeAdRotationRecommendation(proto.Message):
+        r"""The Optimize Ad Rotation recommendation.
+        """
+
+    class CalloutExtensionRecommendation(proto.Message):
+        r"""The Callout extension recommendation.
+
+        Attributes:
+            recommended_extensions (Sequence[google.ads.googleads.v12.common.types.CalloutFeedItem]):
+                Output only. Callout extensions recommended
+                to be added.
+        """
+
+        recommended_extensions = proto.RepeatedField(
+            proto.MESSAGE, number=1, message=extensions.CalloutFeedItem,
+        )
+
+    class SitelinkExtensionRecommendation(proto.Message):
+        r"""The Sitelink extension recommendation.
+
+        Attributes:
+            recommended_extensions (Sequence[google.ads.googleads.v12.common.types.SitelinkFeedItem]):
+                Output only. Sitelink extensions recommended
+                to be added.
+        """
+
+        recommended_extensions = proto.RepeatedField(
+            proto.MESSAGE, number=1, message=extensions.SitelinkFeedItem,
+        )
+
+    class CallExtensionRecommendation(proto.Message):
+        r"""The Call extension recommendation.
+
+        Attributes:
+            recommended_extensions (Sequence[google.ads.googleads.v12.common.types.CallFeedItem]):
+                Output only. Call extensions recommended to
+                be added.
+        """
+
+        recommended_extensions = proto.RepeatedField(
+            proto.MESSAGE, number=1, message=extensions.CallFeedItem,
+        )
+
+    class KeywordMatchTypeRecommendation(proto.Message):
+        r"""The keyword match type recommendation.
+
+        Attributes:
+            keyword (google.ads.googleads.v12.common.types.KeywordInfo):
+                Output only. The existing keyword where the
+                match type should be more broad.
+            recommended_match_type (google.ads.googleads.v12.enums.types.KeywordMatchTypeEnum.KeywordMatchType):
+                Output only. The recommended new match type.
+        """
+
+        keyword = proto.Field(
+            proto.MESSAGE, number=1, message=criteria.KeywordInfo,
+        )
+        recommended_match_type = proto.Field(
+            proto.ENUM,
+            number=2,
+            enum=keyword_match_type.KeywordMatchTypeEnum.KeywordMatchType,
+        )
+
+    class MoveUnusedBudgetRecommendation(proto.Message):
+        r"""The move unused budget recommendation.
+
+        Attributes:
+            excess_campaign_budget (str):
+                Output only. The excess budget's resource_name.
+
+                This field is a member of `oneof`_ ``_excess_campaign_budget``.
+            budget_recommendation (google.ads.googleads.v12.resources.types.Recommendation.CampaignBudgetRecommendation):
+                Output only. The recommendation for the
+                constrained budget to increase.
+        """
+
+        excess_campaign_budget = proto.Field(
+            proto.STRING, number=3, optional=True,
+        )
+        budget_recommendation = proto.Field(
+            proto.MESSAGE,
+            number=2,
+            message="Recommendation.CampaignBudgetRecommendation",
+        )
+
+    class TargetRoasOptInRecommendation(proto.Message):
+        r"""The Target ROAS opt-in recommendation.
+
+        Attributes:
+            recommended_target_roas (float):
+                Output only. The recommended target ROAS
+                (revenue per unit of spend). The value is
+                between 0.01 and 1000.0, inclusive.
+
+                This field is a member of `oneof`_ ``_recommended_target_roas``.
+            required_campaign_budget_amount_micros (int):
+                Output only. The minimum campaign budget, in
+                local currency for the account, required to
+                achieve the target ROAS. Amount is specified in
+                micros, where one million is equivalent to one
+                currency unit.
+
+                This field is a member of `oneof`_ ``_required_campaign_budget_amount_micros``.
+        """
+
+        recommended_target_roas = proto.Field(
+            proto.DOUBLE, number=1, optional=True,
+        )
+        required_campaign_budget_amount_micros = proto.Field(
+            proto.INT64, number=2, optional=True,
+        )
+
+    class ResponsiveSearchAdAssetRecommendation(proto.Message):
+        r"""The add responsive search ad asset recommendation.
+
+        Attributes:
+            current_ad (google.ads.googleads.v12.resources.types.Ad):
+                Output only. The current ad to be updated.
+            recommended_assets (google.ads.googleads.v12.resources.types.Ad):
+                Output only. The recommended assets. This is
+                populated only with the new headlines and/or
+                descriptions, and is otherwise empty.
+        """
+
+        current_ad = proto.Field(proto.MESSAGE, number=1, message=gagr_ad.Ad,)
+        recommended_assets = proto.Field(
+            proto.MESSAGE, number=2, message=gagr_ad.Ad,
+        )
+
+    class ResponsiveSearchAdImproveAdStrengthRecommendation(proto.Message):
+        r"""The responsive search ad improve ad strength recommendation.
+
+        Attributes:
+            current_ad (google.ads.googleads.v12.resources.types.Ad):
+                Output only. The current ad to be updated.
+            recommended_ad (google.ads.googleads.v12.resources.types.Ad):
+                Output only. The updated ad.
+        """
+
+        current_ad = proto.Field(proto.MESSAGE, number=1, message=gagr_ad.Ad,)
+        recommended_ad = proto.Field(
+            proto.MESSAGE, number=2, message=gagr_ad.Ad,
+        )
+
+    class ResponsiveSearchAdRecommendation(proto.Message):
+        r"""The add responsive search ad recommendation.
+
+        Attributes:
+            ad (google.ads.googleads.v12.resources.types.Ad):
+                Output only. Recommended ad.
+        """
+
+        ad = proto.Field(proto.MESSAGE, number=1, message=gagr_ad.Ad,)
+
+    class UseBroadMatchKeywordRecommendation(proto.Message):
+        r"""The use broad match keyword recommendation.
+
+        Attributes:
+            keyword (Sequence[google.ads.googleads.v12.common.types.KeywordInfo]):
+                Output only. Sample of keywords to be
+                expanded to Broad Match.
+            suggested_keywords_count (int):
+                Output only. Total number of keywords to be
+                expanded to Broad Match in the campaign.
+            campaign_keywords_count (int):
+                Output only. Total number of keywords in the
+                campaign.
+            campaign_uses_shared_budget (bool):
+                Output only. Whether the associated campaign
+                uses a shared budget.
+            required_campaign_budget_amount_micros (int):
+                Output only. The budget recommended to avoid
+                becoming budget constrained after applying the
+                recommendation.
+        """
+
+        keyword = proto.RepeatedField(
+            proto.MESSAGE, number=1, message=criteria.KeywordInfo,
+        )
+        suggested_keywords_count = proto.Field(proto.INT64, number=2,)
+        campaign_keywords_count = proto.Field(proto.INT64, number=3,)
+        campaign_uses_shared_budget = proto.Field(proto.BOOL, number=4,)
+        required_campaign_budget_amount_micros = proto.Field(
+            proto.INT64, number=5,
+        )
+
+    class UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation(
+        proto.Message
+    ):
+        r"""The upgrade a Smart Shopping campaign to a Performance Max
+        campaign recommendation.
+
+        Attributes:
+            merchant_id (int):
+                Output only. ID of Merchant Center account.
+            sales_country_code (str):
+                Output only. Country whose products from
+                merchant's inventory should be included.
+        """
+
+        merchant_id = proto.Field(proto.INT64, number=1,)
+        sales_country_code = proto.Field(proto.STRING, number=2,)
+
+    class RaiseTargetCpaBidTooLowRecommendation(proto.Message):
+        r"""The raise target CPA bid too low recommendation.
+
+        Attributes:
+            recommended_target_multiplier (float):
+                Output only. A number greater than 1.0
+                indicating the factor by which we recommend the
+                target CPA should be increased.
+
+                This field is a member of `oneof`_ ``_recommended_target_multiplier``.
+            average_target_cpa_micros (int):
+                Output only. The current average target CPA
+                of the campaign, in micros of customer local
+                currency.
+
+                This field is a member of `oneof`_ ``_average_target_cpa_micros``.
+        """
+
+        recommended_target_multiplier = proto.Field(
+            proto.DOUBLE, number=1, optional=True,
+        )
+        average_target_cpa_micros = proto.Field(
+            proto.INT64, number=2, optional=True,
+        )
+
+    class DisplayExpansionOptInRecommendation(proto.Message):
+        r"""The Display Expansion opt-in recommendation.
+        """
+
+    class UpgradeLocalCampaignToPerformanceMaxRecommendation(proto.Message):
+        r"""The Upgrade Local campaign to Performance Max campaign
+        recommendation.
+
+        """
+
+    class ForecastingSetTargetRoasRecommendation(proto.Message):
+        r"""The forecasting set target ROAS recommendation.
+
+        Attributes:
+            recommended_target_roas (float):
+                Output only. The recommended target ROAS
+                (revenue per unit of spend). The value is
+                between 0.01 and 1000.0, inclusive.
+            campaign_budget (google.ads.googleads.v12.resources.types.Recommendation.CampaignBudget):
+                Output only. The campaign budget.
+        """
+
+        recommended_target_roas = proto.Field(proto.DOUBLE, number=1,)
+        campaign_budget = proto.Field(
+            proto.MESSAGE, number=2, message="Recommendation.CampaignBudget",
+        )
+
+    class CampaignBudget(proto.Message):
+        r"""A campaign budget shared amongst various budget
+        recommendation types.
+
+        Attributes:
+            current_amount_micros (int):
+                Output only. Current budget amount.
+            recommended_new_amount_micros (int):
+                Output only. Recommended budget amount.
+            new_start_date (str):
+                Output only. The date when the new budget would start being
+                used. This field will be set for the following
+                recommendation types: FORECASTING_SET_TARGET_ROAS.
+                YYYY-MM-DD format, for example, 2018-04-17.
+        """
+
+        current_amount_micros = proto.Field(proto.INT64, number=1,)
+        recommended_new_amount_micros = proto.Field(proto.INT64, number=2,)
+        new_start_date = proto.Field(proto.STRING, number=3,)
+
+    resource_name = proto.Field(proto.STRING, number=1,)
+    type_ = proto.Field(
+        proto.ENUM,
+        number=2,
+        enum=recommendation_type.RecommendationTypeEnum.RecommendationType,
+    )
+    impact = proto.Field(proto.MESSAGE, number=3, message=RecommendationImpact,)
+    campaign_budget = proto.Field(proto.STRING, number=24, optional=True,)
+    campaign = proto.Field(proto.STRING, number=25, optional=True,)
+    ad_group = proto.Field(proto.STRING, number=26, optional=True,)
+    dismissed = proto.Field(proto.BOOL, number=27, optional=True,)
+    campaign_budget_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=4,
+        oneof="recommendation",
+        message=CampaignBudgetRecommendation,
+    )
+    forecasting_campaign_budget_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=22,
+        oneof="recommendation",
+        message=CampaignBudgetRecommendation,
+    )
+    keyword_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=8,
+        oneof="recommendation",
+        message=KeywordRecommendation,
+    )
+    text_ad_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=9,
+        oneof="recommendation",
+        message=TextAdRecommendation,
+    )
+    target_cpa_opt_in_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=10,
+        oneof="recommendation",
+        message=TargetCpaOptInRecommendation,
+    )
+    maximize_conversions_opt_in_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=11,
+        oneof="recommendation",
+        message=MaximizeConversionsOptInRecommendation,
+    )
+    enhanced_cpc_opt_in_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=12,
+        oneof="recommendation",
+        message=EnhancedCpcOptInRecommendation,
+    )
+    search_partners_opt_in_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=14,
+        oneof="recommendation",
+        message=SearchPartnersOptInRecommendation,
+    )
+    maximize_clicks_opt_in_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=15,
+        oneof="recommendation",
+        message=MaximizeClicksOptInRecommendation,
+    )
+    optimize_ad_rotation_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=16,
+        oneof="recommendation",
+        message=OptimizeAdRotationRecommendation,
+    )
+    callout_extension_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=17,
+        oneof="recommendation",
+        message=CalloutExtensionRecommendation,
+    )
+    sitelink_extension_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=18,
+        oneof="recommendation",
+        message=SitelinkExtensionRecommendation,
+    )
+    call_extension_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=19,
+        oneof="recommendation",
+        message=CallExtensionRecommendation,
+    )
+    keyword_match_type_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=20,
+        oneof="recommendation",
+        message=KeywordMatchTypeRecommendation,
+    )
+    move_unused_budget_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=21,
+        oneof="recommendation",
+        message=MoveUnusedBudgetRecommendation,
+    )
+    target_roas_opt_in_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=23,
+        oneof="recommendation",
+        message=TargetRoasOptInRecommendation,
+    )
+    responsive_search_ad_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=28,
+        oneof="recommendation",
+        message=ResponsiveSearchAdRecommendation,
+    )
+    marginal_roi_campaign_budget_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=29,
+        oneof="recommendation",
+        message=CampaignBudgetRecommendation,
+    )
+    use_broad_match_keyword_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=30,
+        oneof="recommendation",
+        message=UseBroadMatchKeywordRecommendation,
+    )
+    responsive_search_ad_asset_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=31,
+        oneof="recommendation",
+        message=ResponsiveSearchAdAssetRecommendation,
+    )
+    upgrade_smart_shopping_campaign_to_performance_max_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=32,
+        oneof="recommendation",
+        message=UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation,
+    )
+    responsive_search_ad_improve_ad_strength_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=33,
+        oneof="recommendation",
+        message=ResponsiveSearchAdImproveAdStrengthRecommendation,
+    )
+    display_expansion_opt_in_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=34,
+        oneof="recommendation",
+        message=DisplayExpansionOptInRecommendation,
+    )
+    upgrade_local_campaign_to_performance_max_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=35,
+        oneof="recommendation",
+        message=UpgradeLocalCampaignToPerformanceMaxRecommendation,
+    )
+    raise_target_cpa_bid_too_low_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=36,
+        oneof="recommendation",
+        message=RaiseTargetCpaBidTooLowRecommendation,
+    )
+    forecasting_set_target_roas_recommendation = proto.Field(
+        proto.MESSAGE,
+        number=37,
+        oneof="recommendation",
+        message=ForecastingSetTargetRoasRecommendation,
+    )
+
+
+__all__ = tuple(sorted(__protobuf__.manifest))