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

airflow/providers/google/ads/_vendor/googleads/v12/common/types/ad_type_infos.py

@@ -1,1249 +0,0 @@
-# -*- 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.ads._vendor.googleads.v12.common.types import ad_asset
-from airflow.providers.google.ads._vendor.googleads.v12.enums.types import call_conversion_reporting_state
-from airflow.providers.google.ads._vendor.googleads.v12.enums.types import display_ad_format_setting
-from airflow.providers.google.ads._vendor.googleads.v12.enums.types import (
-    display_upload_product_type as gage_display_upload_product_type,
-)
-from airflow.providers.google.ads._vendor.googleads.v12.enums.types import legacy_app_install_ad_app_store
-from airflow.providers.google.ads._vendor.googleads.v12.enums.types import mime_type as gage_mime_type
-from airflow.providers.google.ads._vendor.googleads.v12.enums.types import video_thumbnail
-
-
-__protobuf__ = proto.module(
-    package="google.ads.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))