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

airflow/providers/google_vendor/googleads/v12/common/types/ad_type_infos.py

@@ -0,0 +1,1249 @@
+# -*- 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 ad_asset
+from airflow.providers.google_vendor.googleads.v12.enums.types import call_conversion_reporting_state
+from airflow.providers.google_vendor.googleads.v12.enums.types import display_ad_format_setting
+from airflow.providers.google_vendor.googleads.v12.enums.types import (
+    display_upload_product_type as gage_display_upload_product_type,
+)
+from airflow.providers.google_vendor.googleads.v12.enums.types import legacy_app_install_ad_app_store
+from airflow.providers.google_vendor.googleads.v12.enums.types import mime_type as gage_mime_type
+from airflow.providers.google_vendor.googleads.v12.enums.types import video_thumbnail
+
+
+__protobuf__ = proto.module(
+    package="airflow.providers.google_vendor.googleads.v12.common",
+    marshal="google.ads.googleads.v12",
+    manifest={
+        "TextAdInfo",
+        "ExpandedTextAdInfo",
+        "ExpandedDynamicSearchAdInfo",
+        "HotelAdInfo",
+        "ShoppingSmartAdInfo",
+        "ShoppingProductAdInfo",
+        "ShoppingComparisonListingAdInfo",
+        "ImageAdInfo",
+        "VideoBumperInStreamAdInfo",
+        "VideoNonSkippableInStreamAdInfo",
+        "VideoTrueViewInStreamAdInfo",
+        "VideoOutstreamAdInfo",
+        "InFeedVideoAdInfo",
+        "VideoAdInfo",
+        "VideoResponsiveAdInfo",
+        "ResponsiveSearchAdInfo",
+        "LegacyResponsiveDisplayAdInfo",
+        "AppAdInfo",
+        "AppEngagementAdInfo",
+        "AppPreRegistrationAdInfo",
+        "LegacyAppInstallAdInfo",
+        "ResponsiveDisplayAdInfo",
+        "LocalAdInfo",
+        "DisplayUploadAdInfo",
+        "ResponsiveDisplayAdControlSpec",
+        "SmartCampaignAdInfo",
+        "CallAdInfo",
+        "DiscoveryMultiAssetAdInfo",
+        "DiscoveryCarouselAdInfo",
+    },
+)
+
+
+class TextAdInfo(proto.Message):
+    r"""A text ad.
+
+    Attributes:
+        headline (str):
+            The headline of the ad.
+
+            This field is a member of `oneof`_ ``_headline``.
+        description1 (str):
+            The first line of the ad's description.
+
+            This field is a member of `oneof`_ ``_description1``.
+        description2 (str):
+            The second line of the ad's description.
+
+            This field is a member of `oneof`_ ``_description2``.
+    """
+
+    headline = proto.Field(proto.STRING, number=4, optional=True,)
+    description1 = proto.Field(proto.STRING, number=5, optional=True,)
+    description2 = proto.Field(proto.STRING, number=6, optional=True,)
+
+
+class ExpandedTextAdInfo(proto.Message):
+    r"""An expanded text ad.
+
+    Attributes:
+        headline_part1 (str):
+            The first part of the ad's headline.
+
+            This field is a member of `oneof`_ ``_headline_part1``.
+        headline_part2 (str):
+            The second part of the ad's headline.
+
+            This field is a member of `oneof`_ ``_headline_part2``.
+        headline_part3 (str):
+            The third part of the ad's headline.
+
+            This field is a member of `oneof`_ ``_headline_part3``.
+        description (str):
+            The description of the ad.
+
+            This field is a member of `oneof`_ ``_description``.
+        description2 (str):
+            The second description of the ad.
+
+            This field is a member of `oneof`_ ``_description2``.
+        path1 (str):
+            The text that can appear alongside the ad's
+            displayed URL.
+
+            This field is a member of `oneof`_ ``_path1``.
+        path2 (str):
+            Additional text that can appear alongside the
+            ad's displayed URL.
+
+            This field is a member of `oneof`_ ``_path2``.
+    """
+
+    headline_part1 = proto.Field(proto.STRING, number=8, optional=True,)
+    headline_part2 = proto.Field(proto.STRING, number=9, optional=True,)
+    headline_part3 = proto.Field(proto.STRING, number=10, optional=True,)
+    description = proto.Field(proto.STRING, number=11, optional=True,)
+    description2 = proto.Field(proto.STRING, number=12, optional=True,)
+    path1 = proto.Field(proto.STRING, number=13, optional=True,)
+    path2 = proto.Field(proto.STRING, number=14, optional=True,)
+
+
+class ExpandedDynamicSearchAdInfo(proto.Message):
+    r"""An expanded dynamic search ad.
+
+    Attributes:
+        description (str):
+            The description of the ad.
+
+            This field is a member of `oneof`_ ``_description``.
+        description2 (str):
+            The second description of the ad.
+
+            This field is a member of `oneof`_ ``_description2``.
+    """
+
+    description = proto.Field(proto.STRING, number=3, optional=True,)
+    description2 = proto.Field(proto.STRING, number=4, optional=True,)
+
+
+class HotelAdInfo(proto.Message):
+    r"""A hotel ad.
+    """
+
+
+class ShoppingSmartAdInfo(proto.Message):
+    r"""A Smart Shopping ad.
+    """
+
+
+class ShoppingProductAdInfo(proto.Message):
+    r"""A standard Shopping ad.
+    """
+
+
+class ShoppingComparisonListingAdInfo(proto.Message):
+    r"""A Shopping Comparison Listing ad.
+
+    Attributes:
+        headline (str):
+            Headline of the ad. This field is required.
+            Allowed length is between 25 and 45 characters.
+
+            This field is a member of `oneof`_ ``_headline``.
+    """
+
+    headline = proto.Field(proto.STRING, number=2, optional=True,)
+
+
+class ImageAdInfo(proto.Message):
+    r"""An image ad.
+
+    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:
+        pixel_width (int):
+            Width in pixels of the full size image.
+
+            This field is a member of `oneof`_ ``_pixel_width``.
+        pixel_height (int):
+            Height in pixels of the full size image.
+
+            This field is a member of `oneof`_ ``_pixel_height``.
+        image_url (str):
+            URL of the full size image.
+
+            This field is a member of `oneof`_ ``_image_url``.
+        preview_pixel_width (int):
+            Width in pixels of the preview size image.
+
+            This field is a member of `oneof`_ ``_preview_pixel_width``.
+        preview_pixel_height (int):
+            Height in pixels of the preview size image.
+
+            This field is a member of `oneof`_ ``_preview_pixel_height``.
+        preview_image_url (str):
+            URL of the preview size image.
+
+            This field is a member of `oneof`_ ``_preview_image_url``.
+        mime_type (google.ads.googleads.v12.enums.types.MimeTypeEnum.MimeType):
+            The mime type of the image.
+        name (str):
+            The name of the image. If the image was
+            created from a MediaFile, this is the
+            MediaFile's name. If the image was created from
+            bytes, this is empty.
+
+            This field is a member of `oneof`_ ``_name``.
+        media_file (str):
+            The MediaFile resource to use for the image.
+
+            This field is a member of `oneof`_ ``image``.
+        data (bytes):
+            Raw image data as bytes.
+
+            This field is a member of `oneof`_ ``image``.
+        ad_id_to_copy_image_from (int):
+            An ad ID to copy the image from.
+
+            This field is a member of `oneof`_ ``image``.
+    """
+
+    pixel_width = proto.Field(proto.INT64, number=15, optional=True,)
+    pixel_height = proto.Field(proto.INT64, number=16, optional=True,)
+    image_url = proto.Field(proto.STRING, number=17, optional=True,)
+    preview_pixel_width = proto.Field(proto.INT64, number=18, optional=True,)
+    preview_pixel_height = proto.Field(proto.INT64, number=19, optional=True,)
+    preview_image_url = proto.Field(proto.STRING, number=20, optional=True,)
+    mime_type = proto.Field(
+        proto.ENUM, number=10, enum=gage_mime_type.MimeTypeEnum.MimeType,
+    )
+    name = proto.Field(proto.STRING, number=21, optional=True,)
+    media_file = proto.Field(proto.STRING, number=12, oneof="image",)
+    data = proto.Field(proto.BYTES, number=13, oneof="image",)
+    ad_id_to_copy_image_from = proto.Field(
+        proto.INT64, number=14, oneof="image",
+    )
+
+
+class VideoBumperInStreamAdInfo(proto.Message):
+    r"""Representation of video bumper in-stream ad format (very
+    short in-stream non-skippable video ad).
+
+    Attributes:
+        companion_banner (google.ads.googleads.v12.common.types.AdImageAsset):
+            The image assets of the companion banner used
+            with the ad.
+    """
+
+    companion_banner = proto.Field(
+        proto.MESSAGE, number=3, message=ad_asset.AdImageAsset,
+    )
+
+
+class VideoNonSkippableInStreamAdInfo(proto.Message):
+    r"""Representation of video non-skippable in-stream ad format (15
+    second in-stream non-skippable video ad).
+
+    Attributes:
+        companion_banner (google.ads.googleads.v12.common.types.AdImageAsset):
+            The image assets of the companion banner used
+            with the ad.
+        action_button_label (str):
+            Label on the "Call To Action" button taking
+            the user to the video ad's final URL.
+        action_headline (str):
+            Additional text displayed with the "Call To
+            Action" button to give context and encourage
+            clicking on the button.
+    """
+
+    companion_banner = proto.Field(
+        proto.MESSAGE, number=5, message=ad_asset.AdImageAsset,
+    )
+    action_button_label = proto.Field(proto.STRING, number=3,)
+    action_headline = proto.Field(proto.STRING, number=4,)
+
+
+class VideoTrueViewInStreamAdInfo(proto.Message):
+    r"""Representation of video TrueView in-stream ad format (ad
+    shown during video playback, often at beginning, which displays
+    a skip button a few seconds into the video).
+
+    Attributes:
+        action_button_label (str):
+            Label on the CTA (call-to-action) button
+            taking the user to the video ad's final URL.
+            Required for TrueView for action campaigns,
+            optional otherwise.
+        action_headline (str):
+            Additional text displayed with the CTA
+            (call-to-action) button to give context and
+            encourage clicking on the button.
+        companion_banner (google.ads.googleads.v12.common.types.AdImageAsset):
+            The image assets of the companion banner used
+            with the ad.
+    """
+
+    action_button_label = proto.Field(proto.STRING, number=4,)
+    action_headline = proto.Field(proto.STRING, number=5,)
+    companion_banner = proto.Field(
+        proto.MESSAGE, number=7, message=ad_asset.AdImageAsset,
+    )
+
+
+class VideoOutstreamAdInfo(proto.Message):
+    r"""Representation of video out-stream ad format (ad shown
+    alongside a feed with automatic playback, without sound).
+
+    Attributes:
+        headline (str):
+            The headline of the ad.
+        description (str):
+            The description line.
+    """
+
+    headline = proto.Field(proto.STRING, number=3,)
+    description = proto.Field(proto.STRING, number=4,)
+
+
+class InFeedVideoAdInfo(proto.Message):
+    r"""Representation of In-feed video ad format.
+
+    Attributes:
+        headline (str):
+            The headline of the ad.
+        description1 (str):
+            First text line for the ad.
+        description2 (str):
+            Second text line for the ad.
+        thumbnail (google.ads.googleads.v12.enums.types.VideoThumbnailEnum.VideoThumbnail):
+            Video thumbnail image to use.
+    """
+
+    headline = proto.Field(proto.STRING, number=1,)
+    description1 = proto.Field(proto.STRING, number=2,)
+    description2 = proto.Field(proto.STRING, number=3,)
+    thumbnail = proto.Field(
+        proto.ENUM,
+        number=4,
+        enum=video_thumbnail.VideoThumbnailEnum.VideoThumbnail,
+    )
+
+
+class VideoAdInfo(proto.Message):
+    r"""A video ad.
+
+    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:
+        video (google.ads.googleads.v12.common.types.AdVideoAsset):
+            The YouTube video assets used for the ad.
+        in_stream (google.ads.googleads.v12.common.types.VideoTrueViewInStreamAdInfo):
+            Video TrueView in-stream ad format.
+
+            This field is a member of `oneof`_ ``format``.
+        bumper (google.ads.googleads.v12.common.types.VideoBumperInStreamAdInfo):
+            Video bumper in-stream ad format.
+
+            This field is a member of `oneof`_ ``format``.
+        out_stream (google.ads.googleads.v12.common.types.VideoOutstreamAdInfo):
+            Video out-stream ad format.
+
+            This field is a member of `oneof`_ ``format``.
+        non_skippable (google.ads.googleads.v12.common.types.VideoNonSkippableInStreamAdInfo):
+            Video non-skippable in-stream ad format.
+
+            This field is a member of `oneof`_ ``format``.
+        in_feed (google.ads.googleads.v12.common.types.InFeedVideoAdInfo):
+            In-feed video ad format.
+
+            This field is a member of `oneof`_ ``format``.
+    """
+
+    video = proto.Field(proto.MESSAGE, number=8, message=ad_asset.AdVideoAsset,)
+    in_stream = proto.Field(
+        proto.MESSAGE,
+        number=2,
+        oneof="format",
+        message="VideoTrueViewInStreamAdInfo",
+    )
+    bumper = proto.Field(
+        proto.MESSAGE,
+        number=3,
+        oneof="format",
+        message="VideoBumperInStreamAdInfo",
+    )
+    out_stream = proto.Field(
+        proto.MESSAGE, number=4, oneof="format", message="VideoOutstreamAdInfo",
+    )
+    non_skippable = proto.Field(
+        proto.MESSAGE,
+        number=5,
+        oneof="format",
+        message="VideoNonSkippableInStreamAdInfo",
+    )
+    in_feed = proto.Field(
+        proto.MESSAGE, number=9, oneof="format", message="InFeedVideoAdInfo",
+    )
+
+
+class VideoResponsiveAdInfo(proto.Message):
+    r"""A video responsive ad.
+
+    Attributes:
+        headlines (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets used for the short
+            headline, for example, the "Call To Action"
+            banner. Currently, only a single value for the
+            short headline is supported.
+        long_headlines (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets used for the long
+            headline. Currently, only a single value for the
+            long headline is supported.
+        descriptions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets used for the description.
+            Currently, only a single value for the
+            description is supported.
+        call_to_actions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets used for the button, for
+            example, the "Call To Action" button. Currently,
+            only a single value for the button is supported.
+        videos (Sequence[google.ads.googleads.v12.common.types.AdVideoAsset]):
+            List of YouTube video assets used for the ad.
+            Currently, only a single value for the YouTube
+            video asset is supported.
+        companion_banners (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            List of image assets used for the companion
+            banner. Currently, only a single value for the
+            companion banner asset is supported.
+        breadcrumb1 (str):
+            First part of text that appears in the ad
+            with the displayed URL.
+        breadcrumb2 (str):
+            Second part of text that appears in the ad
+            with the displayed URL.
+    """
+
+    headlines = proto.RepeatedField(
+        proto.MESSAGE, number=1, message=ad_asset.AdTextAsset,
+    )
+    long_headlines = proto.RepeatedField(
+        proto.MESSAGE, number=2, message=ad_asset.AdTextAsset,
+    )
+    descriptions = proto.RepeatedField(
+        proto.MESSAGE, number=3, message=ad_asset.AdTextAsset,
+    )
+    call_to_actions = proto.RepeatedField(
+        proto.MESSAGE, number=4, message=ad_asset.AdTextAsset,
+    )
+    videos = proto.RepeatedField(
+        proto.MESSAGE, number=5, message=ad_asset.AdVideoAsset,
+    )
+    companion_banners = proto.RepeatedField(
+        proto.MESSAGE, number=6, message=ad_asset.AdImageAsset,
+    )
+    breadcrumb1 = proto.Field(proto.STRING, number=7,)
+    breadcrumb2 = proto.Field(proto.STRING, number=8,)
+
+
+class ResponsiveSearchAdInfo(proto.Message):
+    r"""A responsive search ad.
+    Responsive search ads let you create an ad that adapts to show
+    more text, and more relevant messages, to your customers. Enter
+    multiple headlines and descriptions when creating a responsive
+    search ad, and over time, Google Ads will automatically test
+    different combinations and learn which combinations perform
+    best. By adapting your ad's content to more closely match
+    potential customers' search terms, responsive search ads may
+    improve your campaign's performance.
+
+    More information at
+    https://support.google.com/google-ads/answer/7684791
+
+    Attributes:
+        headlines (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for headlines. When the
+            ad serves the headlines will be selected from
+            this list.
+        descriptions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for descriptions. When
+            the ad serves the descriptions will be selected
+            from this list.
+        path1 (str):
+            First part of text that can be appended to
+            the URL in the ad.
+
+            This field is a member of `oneof`_ ``_path1``.
+        path2 (str):
+            Second part of text that can be appended to the URL in the
+            ad. This field can only be set when ``path1`` is also set.
+
+            This field is a member of `oneof`_ ``_path2``.
+    """
+
+    headlines = proto.RepeatedField(
+        proto.MESSAGE, number=1, message=ad_asset.AdTextAsset,
+    )
+    descriptions = proto.RepeatedField(
+        proto.MESSAGE, number=2, message=ad_asset.AdTextAsset,
+    )
+    path1 = proto.Field(proto.STRING, number=5, optional=True,)
+    path2 = proto.Field(proto.STRING, number=6, optional=True,)
+
+
+class LegacyResponsiveDisplayAdInfo(proto.Message):
+    r"""A legacy responsive display ad. Ads of this type are labeled
+    'Responsive ads' in the Google Ads UI.
+
+    Attributes:
+        short_headline (str):
+            The short version of the ad's headline.
+
+            This field is a member of `oneof`_ ``_short_headline``.
+        long_headline (str):
+            The long version of the ad's headline.
+
+            This field is a member of `oneof`_ ``_long_headline``.
+        description (str):
+            The description of the ad.
+
+            This field is a member of `oneof`_ ``_description``.
+        business_name (str):
+            The business name in the ad.
+
+            This field is a member of `oneof`_ ``_business_name``.
+        allow_flexible_color (bool):
+            Advertiser's consent to allow flexible color. When true, the
+            ad may be served with different color if necessary. When
+            false, the ad will be served with the specified colors or a
+            neutral color. The default value is ``true``. Must be true
+            if ``main_color`` and ``accent_color`` are not set.
+
+            This field is a member of `oneof`_ ``_allow_flexible_color``.
+        accent_color (str):
+            The accent color of the ad in hexadecimal, for example,
+            #ffffff for white. If one of ``main_color`` and
+            ``accent_color`` is set, the other is required as well.
+
+            This field is a member of `oneof`_ ``_accent_color``.
+        main_color (str):
+            The main color of the ad in hexadecimal, for example,
+            #ffffff for white. If one of ``main_color`` and
+            ``accent_color`` is set, the other is required as well.
+
+            This field is a member of `oneof`_ ``_main_color``.
+        call_to_action_text (str):
+            The call-to-action text for the ad.
+
+            This field is a member of `oneof`_ ``_call_to_action_text``.
+        logo_image (str):
+            The MediaFile resource name of the logo image
+            used in the ad.
+
+            This field is a member of `oneof`_ ``_logo_image``.
+        square_logo_image (str):
+            The MediaFile resource name of the square
+            logo image used in the ad.
+
+            This field is a member of `oneof`_ ``_square_logo_image``.
+        marketing_image (str):
+            The MediaFile resource name of the marketing
+            image used in the ad.
+
+            This field is a member of `oneof`_ ``_marketing_image``.
+        square_marketing_image (str):
+            The MediaFile resource name of the square
+            marketing image used in the ad.
+
+            This field is a member of `oneof`_ ``_square_marketing_image``.
+        format_setting (google.ads.googleads.v12.enums.types.DisplayAdFormatSettingEnum.DisplayAdFormatSetting):
+            Specifies which format the ad will be served in. Default is
+            ALL_FORMATS.
+        price_prefix (str):
+            Prefix before price. For example, 'as low
+            as'.
+
+            This field is a member of `oneof`_ ``_price_prefix``.
+        promo_text (str):
+            Promotion text used for dynamic formats of
+            responsive ads. For example 'Free two-day
+            shipping'.
+
+            This field is a member of `oneof`_ ``_promo_text``.
+    """
+
+    short_headline = proto.Field(proto.STRING, number=16, optional=True,)
+    long_headline = proto.Field(proto.STRING, number=17, optional=True,)
+    description = proto.Field(proto.STRING, number=18, optional=True,)
+    business_name = proto.Field(proto.STRING, number=19, optional=True,)
+    allow_flexible_color = proto.Field(proto.BOOL, number=20, optional=True,)
+    accent_color = proto.Field(proto.STRING, number=21, optional=True,)
+    main_color = proto.Field(proto.STRING, number=22, optional=True,)
+    call_to_action_text = proto.Field(proto.STRING, number=23, optional=True,)
+    logo_image = proto.Field(proto.STRING, number=24, optional=True,)
+    square_logo_image = proto.Field(proto.STRING, number=25, optional=True,)
+    marketing_image = proto.Field(proto.STRING, number=26, optional=True,)
+    square_marketing_image = proto.Field(
+        proto.STRING, number=27, optional=True,
+    )
+    format_setting = proto.Field(
+        proto.ENUM,
+        number=13,
+        enum=display_ad_format_setting.DisplayAdFormatSettingEnum.DisplayAdFormatSetting,
+    )
+    price_prefix = proto.Field(proto.STRING, number=28, optional=True,)
+    promo_text = proto.Field(proto.STRING, number=29, optional=True,)
+
+
+class AppAdInfo(proto.Message):
+    r"""An app ad.
+
+    Attributes:
+        mandatory_ad_text (google.ads.googleads.v12.common.types.AdTextAsset):
+            Mandatory ad text.
+        headlines (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for headlines. When the
+            ad serves the headlines will be selected from
+            this list.
+        descriptions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for descriptions. When
+            the ad serves the descriptions will be selected
+            from this list.
+        images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            List of image assets that may be displayed
+            with the ad.
+        youtube_videos (Sequence[google.ads.googleads.v12.common.types.AdVideoAsset]):
+            List of YouTube video assets that may be
+            displayed with the ad.
+        html5_media_bundles (Sequence[google.ads.googleads.v12.common.types.AdMediaBundleAsset]):
+            List of media bundle assets that may be used
+            with the ad.
+    """
+
+    mandatory_ad_text = proto.Field(
+        proto.MESSAGE, number=1, message=ad_asset.AdTextAsset,
+    )
+    headlines = proto.RepeatedField(
+        proto.MESSAGE, number=2, message=ad_asset.AdTextAsset,
+    )
+    descriptions = proto.RepeatedField(
+        proto.MESSAGE, number=3, message=ad_asset.AdTextAsset,
+    )
+    images = proto.RepeatedField(
+        proto.MESSAGE, number=4, message=ad_asset.AdImageAsset,
+    )
+    youtube_videos = proto.RepeatedField(
+        proto.MESSAGE, number=5, message=ad_asset.AdVideoAsset,
+    )
+    html5_media_bundles = proto.RepeatedField(
+        proto.MESSAGE, number=6, message=ad_asset.AdMediaBundleAsset,
+    )
+
+
+class AppEngagementAdInfo(proto.Message):
+    r"""App engagement ads allow you to write text encouraging a
+    specific action in the app, like checking in, making a purchase,
+    or booking a flight. They allow you to send users to a specific
+    part of your app where they can find what they're looking for
+    easier and faster.
+
+    Attributes:
+        headlines (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for headlines. When the
+            ad serves the headlines will be selected from
+            this list.
+        descriptions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for descriptions. When
+            the ad serves the descriptions will be selected
+            from this list.
+        images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            List of image assets that may be displayed
+            with the ad.
+        videos (Sequence[google.ads.googleads.v12.common.types.AdVideoAsset]):
+            List of video assets that may be displayed
+            with the ad.
+    """
+
+    headlines = proto.RepeatedField(
+        proto.MESSAGE, number=1, message=ad_asset.AdTextAsset,
+    )
+    descriptions = proto.RepeatedField(
+        proto.MESSAGE, number=2, message=ad_asset.AdTextAsset,
+    )
+    images = proto.RepeatedField(
+        proto.MESSAGE, number=3, message=ad_asset.AdImageAsset,
+    )
+    videos = proto.RepeatedField(
+        proto.MESSAGE, number=4, message=ad_asset.AdVideoAsset,
+    )
+
+
+class AppPreRegistrationAdInfo(proto.Message):
+    r"""App pre-registration ads link to your app or game listing on
+    Google Play, and can run on Google Play, on YouTube (in-stream
+    only), and within other apps and mobile websites on the Display
+    Network. It will help capture people's interest in your app or
+    game and generate an early install base for your app or game
+    before a launch.
+
+    Attributes:
+        headlines (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for headlines. When the
+            ad serves the headlines will be selected from
+            this list.
+        descriptions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for descriptions. When
+            the ad serves the descriptions will be selected
+            from this list.
+        images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            List of image asset IDs whose images may be
+            displayed with the ad.
+        youtube_videos (Sequence[google.ads.googleads.v12.common.types.AdVideoAsset]):
+            List of YouTube video asset IDs whose videos
+            may be displayed with the ad.
+    """
+
+    headlines = proto.RepeatedField(
+        proto.MESSAGE, number=1, message=ad_asset.AdTextAsset,
+    )
+    descriptions = proto.RepeatedField(
+        proto.MESSAGE, number=2, message=ad_asset.AdTextAsset,
+    )
+    images = proto.RepeatedField(
+        proto.MESSAGE, number=3, message=ad_asset.AdImageAsset,
+    )
+    youtube_videos = proto.RepeatedField(
+        proto.MESSAGE, number=4, message=ad_asset.AdVideoAsset,
+    )
+
+
+class LegacyAppInstallAdInfo(proto.Message):
+    r"""A legacy app install ad that only can be used by a few select
+    customers.
+
+    Attributes:
+        app_id (str):
+            The ID of the mobile app.
+
+            This field is a member of `oneof`_ ``_app_id``.
+        app_store (google.ads.googleads.v12.enums.types.LegacyAppInstallAdAppStoreEnum.LegacyAppInstallAdAppStore):
+            The app store the mobile app is available in.
+        headline (str):
+            The headline of the ad.
+
+            This field is a member of `oneof`_ ``_headline``.
+        description1 (str):
+            The first description line of the ad.
+
+            This field is a member of `oneof`_ ``_description1``.
+        description2 (str):
+            The second description line of the ad.
+
+            This field is a member of `oneof`_ ``_description2``.
+    """
+
+    app_id = proto.Field(proto.STRING, number=6, optional=True,)
+    app_store = proto.Field(
+        proto.ENUM,
+        number=2,
+        enum=legacy_app_install_ad_app_store.LegacyAppInstallAdAppStoreEnum.LegacyAppInstallAdAppStore,
+    )
+    headline = proto.Field(proto.STRING, number=7, optional=True,)
+    description1 = proto.Field(proto.STRING, number=8, optional=True,)
+    description2 = proto.Field(proto.STRING, number=9, optional=True,)
+
+
+class ResponsiveDisplayAdInfo(proto.Message):
+    r"""A responsive display ad.
+
+    Attributes:
+        marketing_images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            Marketing images to be used in the ad. Valid image types are
+            GIF, JPEG, and PNG. The minimum size is 600x314 and the
+            aspect ratio must be 1.91:1 (+-1%). At least one
+            ``marketing_image`` is required. Combined with
+            ``square_marketing_images``, the maximum is 15.
+        square_marketing_images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            Square marketing images to be used in the ad. Valid image
+            types are GIF, JPEG, and PNG. The minimum size is 300x300
+            and the aspect ratio must be 1:1 (+-1%). At least one square
+            ``marketing_image`` is required. Combined with
+            ``marketing_images``, the maximum is 15.
+        logo_images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            Logo images to be used in the ad. Valid image types are GIF,
+            JPEG, and PNG. The minimum size is 512x128 and the aspect
+            ratio must be 4:1 (+-1%). Combined with
+            ``square_logo_images``, the maximum is 5.
+        square_logo_images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            Square logo images to be used in the ad. Valid image types
+            are GIF, JPEG, and PNG. The minimum size is 128x128 and the
+            aspect ratio must be 1:1 (+-1%). Combined with
+            ``square_logo_images``, the maximum is 5.
+        headlines (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            Short format headlines for the ad. The
+            maximum length is 30 characters. At least 1 and
+            max 5 headlines can be specified.
+        long_headline (google.ads.googleads.v12.common.types.AdTextAsset):
+            A required long format headline. The maximum
+            length is 90 characters.
+        descriptions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            Descriptive texts for the ad. The maximum
+            length is 90 characters. At least 1 and max 5
+            headlines can be specified.
+        youtube_videos (Sequence[google.ads.googleads.v12.common.types.AdVideoAsset]):
+            Optional YouTube videos for the ad. A maximum
+            of 5 videos can be specified.
+        business_name (str):
+            The advertiser/brand name. Maximum display
+            width is 25.
+
+            This field is a member of `oneof`_ ``_business_name``.
+        main_color (str):
+            The main color of the ad in hexadecimal, for example,
+            #ffffff for white. If one of ``main_color`` and
+            ``accent_color`` is set, the other is required as well.
+
+            This field is a member of `oneof`_ ``_main_color``.
+        accent_color (str):
+            The accent color of the ad in hexadecimal, for example,
+            #ffffff for white. If one of ``main_color`` and
+            ``accent_color`` is set, the other is required as well.
+
+            This field is a member of `oneof`_ ``_accent_color``.
+        allow_flexible_color (bool):
+            Advertiser's consent to allow flexible color. When true, the
+            ad may be served with different color if necessary. When
+            false, the ad will be served with the specified colors or a
+            neutral color. The default value is ``true``. Must be true
+            if ``main_color`` and ``accent_color`` are not set.
+
+            This field is a member of `oneof`_ ``_allow_flexible_color``.
+        call_to_action_text (str):
+            The call-to-action text for the ad. Maximum
+            display width is 30.
+
+            This field is a member of `oneof`_ ``_call_to_action_text``.
+        price_prefix (str):
+            Prefix before price. For example, 'as low
+            as'.
+
+            This field is a member of `oneof`_ ``_price_prefix``.
+        promo_text (str):
+            Promotion text used for dynamic formats of
+            responsive ads. For example 'Free two-day
+            shipping'.
+
+            This field is a member of `oneof`_ ``_promo_text``.
+        format_setting (google.ads.googleads.v12.enums.types.DisplayAdFormatSettingEnum.DisplayAdFormatSetting):
+            Specifies which format the ad will be served in. Default is
+            ALL_FORMATS.
+        control_spec (google.ads.googleads.v12.common.types.ResponsiveDisplayAdControlSpec):
+            Specification for various creative controls.
+    """
+
+    marketing_images = proto.RepeatedField(
+        proto.MESSAGE, number=1, message=ad_asset.AdImageAsset,
+    )
+    square_marketing_images = proto.RepeatedField(
+        proto.MESSAGE, number=2, message=ad_asset.AdImageAsset,
+    )
+    logo_images = proto.RepeatedField(
+        proto.MESSAGE, number=3, message=ad_asset.AdImageAsset,
+    )
+    square_logo_images = proto.RepeatedField(
+        proto.MESSAGE, number=4, message=ad_asset.AdImageAsset,
+    )
+    headlines = proto.RepeatedField(
+        proto.MESSAGE, number=5, message=ad_asset.AdTextAsset,
+    )
+    long_headline = proto.Field(
+        proto.MESSAGE, number=6, message=ad_asset.AdTextAsset,
+    )
+    descriptions = proto.RepeatedField(
+        proto.MESSAGE, number=7, message=ad_asset.AdTextAsset,
+    )
+    youtube_videos = proto.RepeatedField(
+        proto.MESSAGE, number=8, message=ad_asset.AdVideoAsset,
+    )
+    business_name = proto.Field(proto.STRING, number=17, optional=True,)
+    main_color = proto.Field(proto.STRING, number=18, optional=True,)
+    accent_color = proto.Field(proto.STRING, number=19, optional=True,)
+    allow_flexible_color = proto.Field(proto.BOOL, number=20, optional=True,)
+    call_to_action_text = proto.Field(proto.STRING, number=21, optional=True,)
+    price_prefix = proto.Field(proto.STRING, number=22, optional=True,)
+    promo_text = proto.Field(proto.STRING, number=23, optional=True,)
+    format_setting = proto.Field(
+        proto.ENUM,
+        number=16,
+        enum=display_ad_format_setting.DisplayAdFormatSettingEnum.DisplayAdFormatSetting,
+    )
+    control_spec = proto.Field(
+        proto.MESSAGE, number=24, message="ResponsiveDisplayAdControlSpec",
+    )
+
+
+class LocalAdInfo(proto.Message):
+    r"""A local ad.
+
+    Attributes:
+        headlines (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for headlines. When the
+            ad serves the headlines will be selected from
+            this list. At least 1 and at most 5 headlines
+            must be specified.
+        descriptions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for descriptions. When
+            the ad serves the descriptions will be selected
+            from this list. At least 1 and at most 5
+            descriptions must be specified.
+        call_to_actions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets for call-to-actions. When
+            the ad serves the call-to-actions will be
+            selected from this list. At least 1 and at most
+            5 call-to-actions must be specified.
+        marketing_images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            List of marketing image assets that may be
+            displayed with the ad. The images must be
+            314x600 pixels or 320x320 pixels. At least 1 and
+            at most 20 image assets must be specified.
+        logo_images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            List of logo image assets that may be
+            displayed with the ad. The images must be
+            128x128 pixels and not larger than 120KB. At
+            least 1 and at most 5 image assets must be
+            specified.
+        videos (Sequence[google.ads.googleads.v12.common.types.AdVideoAsset]):
+            List of YouTube video assets that may be
+            displayed with the ad. At least 1 and at most 20
+            video assets must be specified.
+        path1 (str):
+            First part of optional text that can be
+            appended to the URL in the ad.
+
+            This field is a member of `oneof`_ ``_path1``.
+        path2 (str):
+            Second part of optional text that can be appended to the URL
+            in the ad. This field can only be set when ``path1`` is also
+            set.
+
+            This field is a member of `oneof`_ ``_path2``.
+    """
+
+    headlines = proto.RepeatedField(
+        proto.MESSAGE, number=1, message=ad_asset.AdTextAsset,
+    )
+    descriptions = proto.RepeatedField(
+        proto.MESSAGE, number=2, message=ad_asset.AdTextAsset,
+    )
+    call_to_actions = proto.RepeatedField(
+        proto.MESSAGE, number=3, message=ad_asset.AdTextAsset,
+    )
+    marketing_images = proto.RepeatedField(
+        proto.MESSAGE, number=4, message=ad_asset.AdImageAsset,
+    )
+    logo_images = proto.RepeatedField(
+        proto.MESSAGE, number=5, message=ad_asset.AdImageAsset,
+    )
+    videos = proto.RepeatedField(
+        proto.MESSAGE, number=6, message=ad_asset.AdVideoAsset,
+    )
+    path1 = proto.Field(proto.STRING, number=9, optional=True,)
+    path2 = proto.Field(proto.STRING, number=10, optional=True,)
+
+
+class DisplayUploadAdInfo(proto.Message):
+    r"""A generic type of display ad. The exact ad format is controlled by
+    the ``display_upload_product_type`` field, which determines what
+    kinds of data need to be included with the ad.
+
+
+    .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
+
+    Attributes:
+        display_upload_product_type (google.ads.googleads.v12.enums.types.DisplayUploadProductTypeEnum.DisplayUploadProductType):
+            The product type of this ad. See comments on
+            the enum for details.
+        media_bundle (google.ads.googleads.v12.common.types.AdMediaBundleAsset):
+            A media bundle asset to be used in the ad. For information
+            about the media bundle for HTML5_UPLOAD_AD, see
+            https://support.google.com/google-ads/answer/1722096 Media
+            bundles that are part of dynamic product types use a special
+            format that needs to be created through the Google Web
+            Designer. See
+            https://support.google.com/webdesigner/answer/7543898 for
+            more information.
+
+            This field is a member of `oneof`_ ``media_asset``.
+    """
+
+    display_upload_product_type = proto.Field(
+        proto.ENUM,
+        number=1,
+        enum=gage_display_upload_product_type.DisplayUploadProductTypeEnum.DisplayUploadProductType,
+    )
+    media_bundle = proto.Field(
+        proto.MESSAGE,
+        number=2,
+        oneof="media_asset",
+        message=ad_asset.AdMediaBundleAsset,
+    )
+
+
+class ResponsiveDisplayAdControlSpec(proto.Message):
+    r"""Specification for various creative controls for a responsive
+    display ad.
+
+    Attributes:
+        enable_asset_enhancements (bool):
+            Whether the advertiser has opted into the
+            asset enhancements feature.
+        enable_autogen_video (bool):
+            Whether the advertiser has opted into
+            auto-gen video feature.
+    """
+
+    enable_asset_enhancements = proto.Field(proto.BOOL, number=1,)
+    enable_autogen_video = proto.Field(proto.BOOL, number=2,)
+
+
+class SmartCampaignAdInfo(proto.Message):
+    r"""A Smart campaign ad.
+
+    Attributes:
+        headlines (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets, each of which
+            corresponds to a headline when the ad serves.
+            This list consists of a minimum of 3 and up to
+            15 text assets.
+        descriptions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            List of text assets, each of which
+            corresponds to a description when the ad serves.
+            This list consists of a minimum of 2 and up to 4
+            text assets.
+    """
+
+    headlines = proto.RepeatedField(
+        proto.MESSAGE, number=1, message=ad_asset.AdTextAsset,
+    )
+    descriptions = proto.RepeatedField(
+        proto.MESSAGE, number=2, message=ad_asset.AdTextAsset,
+    )
+
+
+class CallAdInfo(proto.Message):
+    r"""A call ad.
+
+    Attributes:
+        country_code (str):
+            The country code in the ad.
+        phone_number (str):
+            The phone number in the ad.
+        business_name (str):
+            The business name in the ad.
+        headline1 (str):
+            First headline in the ad.
+        headline2 (str):
+            Second headline in the ad.
+        description1 (str):
+            The first line of the ad's description.
+        description2 (str):
+            The second line of the ad's description.
+        call_tracked (bool):
+            Whether to enable call tracking for the
+            creative. Enabling call tracking also enables
+            call conversions.
+        disable_call_conversion (bool):
+            Whether to disable call conversion for the creative. If set
+            to ``true``, disables call conversions even when
+            ``call_tracked`` is ``true``. If ``call_tracked`` is
+            ``false``, this field is ignored.
+        phone_number_verification_url (str):
+            The URL to be used for phone number
+            verification.
+        conversion_action (str):
+            The conversion action to attribute a call conversion to. If
+            not set a default conversion action is used. This field only
+            has effect if ``call_tracked`` is set to ``true``. Otherwise
+            this field is ignored.
+        conversion_reporting_state (google.ads.googleads.v12.enums.types.CallConversionReportingStateEnum.CallConversionReportingState):
+            The call conversion behavior of this call ad.
+            It can use its own call conversion setting,
+            inherit the account level setting, or be
+            disabled.
+        path1 (str):
+            First part of text that can be appended to
+            the URL in the ad. Optional.
+        path2 (str):
+            Second part of text that can be appended to the URL in the
+            ad. This field can only be set when ``path1`` is also set.
+            Optional.
+    """
+
+    country_code = proto.Field(proto.STRING, number=1,)
+    phone_number = proto.Field(proto.STRING, number=2,)
+    business_name = proto.Field(proto.STRING, number=3,)
+    headline1 = proto.Field(proto.STRING, number=11,)
+    headline2 = proto.Field(proto.STRING, number=12,)
+    description1 = proto.Field(proto.STRING, number=4,)
+    description2 = proto.Field(proto.STRING, number=5,)
+    call_tracked = proto.Field(proto.BOOL, number=6,)
+    disable_call_conversion = proto.Field(proto.BOOL, number=7,)
+    phone_number_verification_url = proto.Field(proto.STRING, number=8,)
+    conversion_action = proto.Field(proto.STRING, number=9,)
+    conversion_reporting_state = proto.Field(
+        proto.ENUM,
+        number=10,
+        enum=call_conversion_reporting_state.CallConversionReportingStateEnum.CallConversionReportingState,
+    )
+    path1 = proto.Field(proto.STRING, number=13,)
+    path2 = proto.Field(proto.STRING, number=14,)
+
+
+class DiscoveryMultiAssetAdInfo(proto.Message):
+    r"""A discovery multi asset ad.
+
+    Attributes:
+        marketing_images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            Marketing image assets to be used in the ad. Valid image
+            types are GIF, JPEG, and PNG. The minimum size is 600x314
+            and the aspect ratio must be 1.91:1 (+-1%). Required if
+            square_marketing_images is not present. Combined with
+            ``square_marketing_images`` and
+            ``portrait_marketing_images`` the maximum is 20.
+        square_marketing_images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            Square marketing image assets to be used in the ad. Valid
+            image types are GIF, JPEG, and PNG. The minimum size is
+            300x300 and the aspect ratio must be 1:1 (+-1%). Required if
+            marketing_images is not present. Combined with
+            ``marketing_images`` and ``portrait_marketing_images`` the
+            maximum is 20.
+        portrait_marketing_images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            Portrait marketing image assets to be used in the ad. Valid
+            image types are GIF, JPEG, and PNG. The minimum size is
+            480x600 and the aspect ratio must be 4:5 (+-1%). Combined
+            with ``marketing_images`` and ``square_marketing_images``
+            the maximum is 20.
+        logo_images (Sequence[google.ads.googleads.v12.common.types.AdImageAsset]):
+            Logo image assets to be used in the ad. Valid
+            image types are GIF, JPEG, and PNG. The minimum
+            size is 128x128 and the aspect ratio must be
+            1:1(+-1%). At least 1 and max 5 logo images can
+            be specified.
+        headlines (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            Headline text asset of the ad. Maximum
+            display width is 30. At least 1 and max 5
+            headlines can be specified.
+        descriptions (Sequence[google.ads.googleads.v12.common.types.AdTextAsset]):
+            The descriptive text of the ad. Maximum
+            display width is 90. At least 1 and max 5
+            descriptions can be specified.
+        business_name (str):
+            The Advertiser/brand name. Maximum display
+            width is 25. Required.
+
+            This field is a member of `oneof`_ ``_business_name``.
+        call_to_action_text (str):
+            Call to action text.
+
+            This field is a member of `oneof`_ ``_call_to_action_text``.
+        lead_form_only (bool):
+            Boolean option that indicates if this ad must
+            be served with lead form.
+
+            This field is a member of `oneof`_ ``_lead_form_only``.
+    """
+
+    marketing_images = proto.RepeatedField(
+        proto.MESSAGE, number=1, message=ad_asset.AdImageAsset,
+    )
+    square_marketing_images = proto.RepeatedField(
+        proto.MESSAGE, number=2, message=ad_asset.AdImageAsset,
+    )
+    portrait_marketing_images = proto.RepeatedField(
+        proto.MESSAGE, number=3, message=ad_asset.AdImageAsset,
+    )
+    logo_images = proto.RepeatedField(
+        proto.MESSAGE, number=4, message=ad_asset.AdImageAsset,
+    )
+    headlines = proto.RepeatedField(
+        proto.MESSAGE, number=5, message=ad_asset.AdTextAsset,
+    )
+    descriptions = proto.RepeatedField(
+        proto.MESSAGE, number=6, message=ad_asset.AdTextAsset,
+    )
+    business_name = proto.Field(proto.STRING, number=7, optional=True,)
+    call_to_action_text = proto.Field(proto.STRING, number=8, optional=True,)
+    lead_form_only = proto.Field(proto.BOOL, number=9, optional=True,)
+
+
+class DiscoveryCarouselAdInfo(proto.Message):
+    r"""A discovery carousel ad.
+
+    Attributes:
+        business_name (str):
+            Required. The Advertiser/brand name.
+        logo_image (google.ads.googleads.v12.common.types.AdImageAsset):
+            Required. Logo image to be used in the ad.
+            The minimum size is 128x128 and the aspect ratio
+            must be 1:1(+-1%).
+        headline (google.ads.googleads.v12.common.types.AdTextAsset):
+            Required. Headline of the ad.
+        description (google.ads.googleads.v12.common.types.AdTextAsset):
+            Required. The descriptive text of the ad.
+        call_to_action_text (str):
+            Call to action text.
+        carousel_cards (Sequence[google.ads.googleads.v12.common.types.AdDiscoveryCarouselCardAsset]):
+            Required. Carousel cards that will display
+            with the ad. Min 2 max 10.
+    """
+
+    business_name = proto.Field(proto.STRING, number=1,)
+    logo_image = proto.Field(
+        proto.MESSAGE, number=2, message=ad_asset.AdImageAsset,
+    )
+    headline = proto.Field(
+        proto.MESSAGE, number=3, message=ad_asset.AdTextAsset,
+    )
+    description = proto.Field(
+        proto.MESSAGE, number=4, message=ad_asset.AdTextAsset,
+    )
+    call_to_action_text = proto.Field(proto.STRING, number=5,)
+    carousel_cards = proto.RepeatedField(
+        proto.MESSAGE, number=6, message=ad_asset.AdDiscoveryCarouselCardAsset,
+    )
+
+
+__all__ = tuple(sorted(__protobuf__.manifest))