Ad

某个广告。

JSON 表示法 
{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "finalAppUrls": [
    {
      object (FinalAppUrl)
    }
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "type": enum (AdType),
  "devicePreference": enum (Device),
  "urlCollections": [
    {
      object (UrlCollection)
    }
  ],
  "systemManagedResourceSource": enum (SystemManagedResourceSource),
  "id": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "displayUrl": string,
  "addedByGoogleAds": boolean,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (TextAdInfo)
  },
  "expandedTextAd": {
    object (ExpandedTextAdInfo)
  },
  "callAd": {
    object (CallAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (ExpandedDynamicSearchAdInfo)
  },
  "hotelAd": {
    object (HotelAdInfo)
  },
  "shoppingSmartAd": {
    object (ShoppingSmartAdInfo)
  },
  "shoppingProductAd": {
    object (ShoppingProductAdInfo)
  },
  "imageAd": {
    object (ImageAdInfo)
  },
  "videoAd": {
    object (VideoAdInfo)
  },
  "videoResponsiveAd": {
    object (VideoResponsiveAdInfo)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdInfo)
  },
  "legacyResponsiveDisplayAd": {
    object (LegacyResponsiveDisplayAdInfo)
  },
  "appAd": {
    object (AppAdInfo)
  },
  "legacyAppInstallAd": {
    object (LegacyAppInstallAdInfo)
  },
  "responsiveDisplayAd": {
    object (ResponsiveDisplayAdInfo)
  },
  "localAd": {
    object (LocalAdInfo)
  },
  "displayUploadAd": {
    object (DisplayUploadAdInfo)
  },
  "appEngagementAd": {
    object (AppEngagementAdInfo)
  },
  "shoppingComparisonListingAd": {
    object (ShoppingComparisonListingAdInfo)
  },
  "smartCampaignAd": {
    object (SmartCampaignAdInfo)
  },
  "appPreRegistrationAd": {
    object (AppPreRegistrationAdInfo)
  },
  "demandGenMultiAssetAd": {
    object (DemandGenMultiAssetAdInfo)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAdInfo)
  },
  "demandGenVideoResponsiveAd": {
    object (DemandGenVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}
字段
resourceName

string

不可变。广告的资源名称。广告资源名称采用以下格式：

customers/{customerId}/ads/{ad_id}
finalUrls[]

string

广告的所有跨网域重定向之后可能存在的最终到达网址列表。
finalAppUrls[]

object (FinalAppUrl)

用户安装了特定应用后在移动设备上使用的最终到达应用网址列表。
finalMobileUrls[]

string

广告的所有跨网域重定向之后可能存在的最终到达移动网址列表。
urlCustomParameters[]

object (CustomParameter)

可用于替换 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中的自定义参数标记的映射列表。对于 mutate，请使用网址自定义参数操作。
type

enum (AdType)

仅限输出。广告的类型。
devicePreference

enum (Device)

广告的设备偏好设置。您只能指定移动设备的偏好设置。设置此偏好设置后，当某广告在移动设备上展示时，该广告将优于其他广告。广告仍可在其他类型的设备上展示，例如在没有其他广告可展示的情况下。如果未指定（无设备偏好设置），则系统会定位所有设备。仅受部分广告类型支持。
urlCollections[]

object (UrlCollection)

广告的其他网址，使用可从广告中的其他字段引用的唯一标识符进行标记。
systemManagedResourceSource

enum (SystemManagedResourceSource)

仅限输出。如果广告由系统管理，则此字段会指示来源。此字段为只读字段。
id

string (int64 format)

仅限输出。广告的 ID。
trackingUrlTemplate

string

用于构建跟踪网址的网址模板。
finalUrlSuffix

string

构建最终到达网址时使用的后缀。
displayUrl

string

在某些广告格式的广告说明中显示的网址。
addedByGoogleAds

boolean

仅限输出。指示此广告是否由 Google Ads 自动添加，而不是由用户添加。例如，当根据现有广告的效果自动创建广告作为新广告的建议时，可能会发生这种情况。
name

string

不可变。广告的名称。此名称仅用于识别广告。它不必是唯一的，也不会影响投放的广告。name 字段目前仅支持 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd。
联合字段 ad_data。与广告类型相关的详细信息。必须设置一个值。ad_data 只能是下列其中一项：
textAd

object (TextAdInfo)

不可变。与文字广告有关的详细信息。
expandedTextAd

object (ExpandedTextAdInfo)

与加大型文字广告相关的详情。
callAd

object (CallAdInfo)

与来电广告相关的详情。
expandedDynamicSearchAd

object (ExpandedDynamicSearchAdInfo)

不可变。与加大型动态搜索广告相关的详细信息。此类广告的标题、最终到达网址和显示网址会在投放时根据广告系列级关联 dynamicSearchAdsSetting 提供的域名特定信息自动生成。
hotelAd

object (HotelAdInfo)

与酒店广告相关的详细信息。
shoppingSmartAd

object (ShoppingSmartAdInfo)

与智能购物广告相关的详细信息。
shoppingProductAd

object (ShoppingProductAdInfo)

与购物产品广告相关的详细信息。
imageAd

object (ImageAdInfo)

不可变。与图片广告有关的详情。
videoAd

object (VideoAdInfo)

与视频广告相关的详细信息。
videoResponsiveAd

object (VideoResponsiveAdInfo)

与视频自适应广告相关的详细信息。
responsiveSearchAd

object (ResponsiveSearchAdInfo)

与自适应搜索广告相关的详细信息。
legacyResponsiveDisplayAd

object (LegacyResponsiveDisplayAdInfo)

与旧版自适应展示广告相关的详细信息。
appAd

object (AppAdInfo)

与应用广告相关的详情。
legacyAppInstallAd

object (LegacyAppInstallAdInfo)

不可变。与旧版应用安装广告相关的详细信息。
responsiveDisplayAd

object (ResponsiveDisplayAdInfo)

与自适应展示广告相关的详细信息。
localAd

object (LocalAdInfo)

与本地广告相关的详情。
displayUploadAd

object (DisplayUploadAdInfo)

与上传的展示广告相关的详情。
appEngagementAd

object (AppEngagementAdInfo)

与应用互动广告相关的详情。
shoppingComparisonListingAd

object (ShoppingComparisonListingAdInfo)

与比价购物广告相关的详细信息。
smartCampaignAd

object (SmartCampaignAdInfo)

与智能广告系列广告相关的详细信息。
appPreRegistrationAd

object (AppPreRegistrationAdInfo)

与应用预注册广告相关的详细信息。
demandGenMultiAssetAd

object (DemandGenMultiAssetAdInfo)

与多重素材资源需求开发广告相关的详细信息。
demandGenVideoResponsiveAd

object (DemandGenVideoResponsiveAdInfo)

与需求开发视频自适应广告相关的详细信息。
demandGenProductAd

object (DemandGenProductAdInfo)

与产品需求开发广告相关的详细信息。
travelAd

object (TravelAdInfo)

与旅游广告相关的详细信息。

FinalAppUrl

用于深层链接到指定操作系统的应用的网址。

JSON 表示法 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
字段
osType

enum (AppUrlOperatingSystemType)

此网址所针对的操作系统。必填。
url

string

应用深层链接网址。深层链接用于指定应用中与您要展示的内容相对应的位置，并且应采用 {scheme}://{host_path} 格式。该架构用于标识要打开哪个应用。对于您的应用，您可以使用以应用名称开头的自定义架构。主机和路径用于指定内容在应用中的唯一位置。例如：“exampleapp://productid_1234”。必填。

AppUrlOperatingSystemType

操作系统

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
IOS Apple iOS 操作系统。
ANDROID Android 操作系统。

AdType

可能的广告类型。

枚举
UNSPECIFIED 未指定值。
UNKNOWN

接收的值在此版本中未知。

这是一个仅用于响应的值。
TEXT_AD 该广告是文字广告。
EXPANDED_TEXT_AD 该广告是加大型文字广告。
EXPANDED_DYNAMIC_SEARCH_AD 该广告是加大型动态搜索广告。
HOTEL_AD 该广告是酒店广告。
SHOPPING_SMART_AD 该广告是智能购物广告。
SHOPPING_PRODUCT_AD 该广告是标准购物广告。
VIDEO_AD 该广告是视频广告。
IMAGE_AD 此广告是图片广告。
RESPONSIVE_SEARCH_AD 该广告是自适应搜索广告。
LEGACY_RESPONSIVE_DISPLAY_AD 该广告是旧版自适应展示广告。
APP_AD 该广告是应用广告。
LEGACY_APP_INSTALL_AD 该广告是旧版应用安装广告。
RESPONSIVE_DISPLAY_AD 该广告是自适应展示广告。
LOCAL_AD 该广告是本地广告。
HTML5_UPLOAD_AD 该广告是采用 HTML5_UPLOAD_AD 产品类型的展示广告上传广告。
DYNAMIC_HTML5_AD 该广告是上传展示广告，包含 DYNAMIC_HTML5_* 产品类型之一。
APP_ENGAGEMENT_AD 该广告是应用互动广告。
SHOPPING_COMPARISON_LISTING_AD 该广告是购物比价购物广告。
VIDEO_BUMPER_AD 视频导视广告。
VIDEO_NON_SKIPPABLE_IN_STREAM_AD 不可跳过的插播广告。
VIDEO_OUTSTREAM_AD 外播视频广告。
VIDEO_TRUEVIEW_IN_STREAM_AD TrueView 插播视频广告。
VIDEO_RESPONSIVE_AD 视频自适应广告。
SMART_CAMPAIGN_AD 智能广告系列。
CALL_AD 来电广告。
APP_PRE_REGISTRATION_AD 通用应用预注册广告。
IN_FEED_VIDEO_AD 信息流视频广告。
DEMAND_GEN_MULTI_ASSET_AD 多素材资源需求开发广告。
TRAVEL_AD 旅游广告。
DEMAND_GEN_VIDEO_RESPONSIVE_AD 需求开发视频自适应广告。
DEMAND_GEN_PRODUCT_AD 产品需求开发广告。

UrlCollection

使用唯一标识符标记的网址集合。

JSON 表示法 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
字段
finalUrls[]

string

可能的最终到达网址的列表。
finalMobileUrls[]

string

可能的最终到达移动网址列表。
urlCollectionId

string

此 UrlCollection 实例的唯一标识符。
trackingUrlTemplate

string

用于构建跟踪网址的网址模板。

SystemManagedResourceSource

列出可能的系统管理的实体来源的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
AD_VARIATIONS 生成的广告变体实验广告。

TextAdInfo

文字广告。

JSON 表示法 
{
  "headline": string,
  "description1": string,
  "description2": string
}
字段
headline

string

广告的标题。
description1

string

广告内容描述的第一行。
description2

string

广告内容描述的第二行。

ExpandedTextAdInfo

加大型文字广告。

JSON 表示法 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
字段
headlinePart1

string

广告标题的第一部分。
headlinePart2

string

广告标题的第二部分。
headlinePart3

string

广告标题的第三部分。
description

string

广告的广告内容描述。
description2

string

广告的第二条说明。
path1

string

可以与广告的显示网址一起显示的文字。
path2

string

可以与广告的显示网址一起显示的其他文字。

CallAdInfo

来电广告。

JSON 表示法 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
字段
countryCode

string

广告中的国家/地区代码。
phoneNumber

string

广告中的电话号码。
businessName

string

广告中的商家名称。
headline1

string

广告中的第一个标题。
headline2

string

广告中的第二个标题。
description1

string

广告内容描述的第一行。
description2

string

广告内容描述的第二行。
callTracked

boolean

是否为广告素材启用来电跟踪。启用来电跟踪的同时也会启用来电转化。
disableCallConversion

boolean

是否为广告素材停用来电转化。如果设置为 true，即使 callTracked 为 true，也会停用致电转化。如果 callTracked 为 false，系统会忽略此字段。
phoneNumberVerificationUrl

string

要用于电话号码验证的网址。
conversionAction

string

将来电转化归因于的转化操作。如果未设置，系统将使用默认转化操作。只有在 callTracked 设置为 true 时，此字段才会生效。否则，系统会忽略此字段。
conversionReportingState

enum (CallConversionReportingState)

此来电广告的来电转化行为。它可以使用自己的致电转化设置，也可以沿用账号级设置，也可以被停用。
path1

string

可附加到广告中网址的第一部分文字。可选。
path2

string

可附加到广告中网址的第二部分文字。仅当同时设置了 path1 时，才能设置此字段。可选。

ExpandedDynamicSearchAdInfo

加大型动态搜索广告。

JSON 表示法 
{
  "description": string,
  "description2": string
}
字段
description

string

广告的广告内容描述。
description2

string

广告的第二条说明。

HotelAdInfo

此类型没有字段。

酒店广告。

ShoppingSmartAdInfo

此类型没有字段。

智能购物广告。

ShoppingProductAdInfo

此类型没有字段。

标准购物广告。

ImageAdInfo

图片广告。

JSON 表示法 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "imageAsset": {
    object (AdImageAsset)
  },
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
字段
mimeType

enum (MimeType)

图片的 MIME 类型。
pixelWidth

string (int64 format)

全尺寸图片的宽度（以像素为单位）。
pixelHeight

string (int64 format)

全尺寸图片的高度（以像素为单位）。
imageUrl

string

全尺寸图片的网址。
previewPixelWidth

string (int64 format)

预览尺寸图片的宽度（以像素为单位）。
previewPixelHeight

string (int64 format)

预览尺寸图片的高度（以像素为单位）。
previewImageUrl

string

预览尺寸图片的网址。
name

string

图片的名称。如果图像是从媒体文件创建而来，则这是媒体文件的名称。如果图片是通过字节创建的，则为空。
联合字段 image。用以创建 ImageAd 的图片。这可以通过以下两种方式之一进行指定。1. 现有的媒体文件资源。2. 原始图片数据（以字节为单位）。image 只能是下列其中一项：
imageAsset

object (AdImageAsset)

广告所用的图片素材资源。
data

string (bytes format)

原始图片数据（以字节为单位）。

使用 base64 编码的字符串。
adIdToCopyImageFrom

string (int64 format)

要从中复制图片的广告 ID。

AdImageAsset

在广告中使用的图片素材资源。

JSON 表示法 
{
  "asset": string
}
字段
asset

string

此图片的 Asset 资源名称。

VideoAdInfo

视频广告。

JSON 表示法 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
字段
video

object (AdVideoAsset)

广告使用的 YouTube 视频素材资源。
联合字段 format。不同视频广告格式的具体格式架构。format 只能是下列其中一项：
inStream

object (VideoTrueViewInStreamAdInfo)

视频 TrueView 插播广告格式。
bumper

object (VideoBumperInStreamAdInfo)

导视插播视频广告格式。
outStream

object (VideoOutstreamAdInfo)

外播视频广告格式。
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

不可跳过的插播广告格式。
inFeed

object (InFeedVideoAdInfo)

信息流视频广告格式。

AdVideoAsset

在广告中使用的视频素材资源。

JSON 表示法 
{
  "asset": string,
  "adVideoAssetInfo": {
    object (AdVideoAssetInfo)
  }
}
字段
asset

string

此视频的资产资源名称。
adVideoAssetInfo

object (AdVideoAssetInfo)

包含此 AdVideoAsset 的信息字段。

AdVideoAssetInfo

包含 AdVideoAssets 的信息字段。

JSON 表示法 
{
  "adVideoAssetInventoryPreferences": {
    object (AdVideoAssetInventoryPreferences)
  }
}
字段
adVideoAssetInventoryPreferences

object (AdVideoAssetInventoryPreferences)

此 AdVideoAsset 的广告资源偏好设置列表。此字段只能用于 DiscoveryVideoResponsiveAd。在投放期间，设置了广告资源素材资源偏好设置的视频素材资源将优先于同一广告中的其他视频。例如，假设此广告是为特定广告资源投放。服务器会先尝试将符合条件的视频与相应广告资源的匹配偏好设置进行匹配。仅当找到具有匹配偏好且符合指定广告位条件的视频时，才会选择未设置偏好设置的视频。

AdVideoAssetInventoryPreferences

YouTube 视频资产广告资源偏好设置。下一个代码：4

JSON 表示法 
{
  "inFeedPreference": boolean,
  "inStreamPreference": boolean,
  "shortsPreference": boolean
}
字段
inFeedPreference

boolean

如果为 true，则在选择要在 Feed 中投放的视频时，系统会优先选择具有此广告资源偏好设置的 YouTube 视频素材资源。
inStreamPreference

boolean

如果为 true，则在选择要投放视频插播广告的视频时，系统会优先选择具有此广告资源偏好设置的 YouTube 视频素材资源。
shortsPreference

boolean

如果为 true，则在选择要在 YouTube Shorts 上投放的视频时，系统会优先选择具有此广告资源偏好设置的 YouTube 视频素材资源。

VideoTrueViewInStreamAdInfo

表示 TrueView 视频插播广告格式（在视频播放期间展示的广告，通常在开始播放时，会在视频几秒后显示一个“跳过”按钮）。

JSON 表示法 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
字段
actionButtonLabel

string

号召性用语 (CTA) 按钮上的标签，可将用户引导至视频广告的最终到达网址。对于 TrueView 行动号召广告系列，此字段为必填字段，否则为选填字段。
actionHeadline

string

随 CTA（号召性用语）按钮一起显示的额外文字，可提供背景信息并鼓励用户点击该按钮。
companionBanner

object (AdImageAsset)

与广告一起使用的随播横幅广告的图片素材资源。

VideoBumperInStreamAdInfo

表示导视插播广告格式（非常短的不可跳过的插播视频广告）。

JSON 表示法 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
字段
companionBanner

object (AdImageAsset)

与广告一起使用的随播横幅广告的图片素材资源。
actionButtonLabel

string

“号召性用语”按钮上的标签，可将用户引导至视频广告的最终到达网址。
actionHeadline

string

随 CTA（号召性用语）按钮一起显示的额外文字，可提供背景信息并鼓励用户点击该按钮。

VideoOutstreamAdInfo

外播视频广告格式的表示形式（与具有自动播放功能的 Feed 一起展示的广告，无声音）。

JSON 表示法 
{
  "headline": string,
  "description": string
}
字段
headline

string

广告的标题。
description

string

广告内容描述。

VideoNonSkippableInStreamAdInfo

表示不可跳过的插播广告格式（15 秒不可跳过的插播视频广告）。

JSON 表示法 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
字段
companionBanner

object (AdImageAsset)

与广告一起使用的随播横幅广告的图片素材资源。
actionButtonLabel

string

“号召性用语”按钮上的标签，可将用户引导至视频广告的最终到达网址。
actionHeadline

string

随“号召性用语”按钮一起显示的其他文字，用于提供背景信息并鼓励用户点击该按钮。

InFeedVideoAdInfo

信息流视频广告格式的表示形式。

JSON 表示法 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
字段
headline

string

广告的标题。
description1

string

广告的第一行文字。
description2

string

广告的第二行文字。
thumbnail

enum (VideoThumbnail)

要使用的视频缩略图。

VideoThumbnail

枚举可能的视频缩略图类型。

枚举
UNSPECIFIED 未指定类型。
UNKNOWN 接收的值在此版本中未知。这是一个仅用于响应的值。
DEFAULT_THUMBNAIL 默认缩略图。可以自动生成，也可以由用户上传。
THUMBNAIL_1 由视频生成的缩略图 1。
THUMBNAIL_2 由视频生成的缩略图 2。
THUMBNAIL_3 由视频生成的缩略图 3。

VideoResponsiveAdInfo

视频自适应广告。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
字段
headlines[]

object (AdTextAsset)

短标题所用文字素材资源的列表。目前仅支持短标题的单个值。
longHeadlines[]

object (AdTextAsset)

用于长标题的文字素材资源列表。目前仅支持长标题的单个值。
descriptions[]

object (AdTextAsset)

用于说明文字素材资源的列表。目前仅支持说明的单个值。
callToActions[]

object (AdTextAsset)

用于该按钮的文字素材资源列表，例如“号召性用语”按钮。目前仅支持为按钮使用单个值。
videos[]

object (AdVideoAsset)

广告所用 YouTube 视频素材资源的列表。目前仅支持为 YouTube 视频素材资源使用一个值。
companionBanners[]

object (AdImageAsset)

随播横幅广告使用的图片素材资源列表。目前仅支持为随播横幅广告素材资源提供一个值。
breadcrumb1

string

与显示网址一起在广告中显示的文字的第一部分。
breadcrumb2

string

与显示网址一起在广告中显示的文字的第二部分。

ResponsiveSearchAdInfo

自适应搜索广告。

采用自适应搜索广告格式制作广告，可以根据客户的搜索字词向其展示更丰富的文字信息以及更切实相关的广告内容。制作自适应搜索广告时，您只需输入多个标题和广告内容描述即可；随着时间的推移，Google Ads 会自动测试各种不同的组合，通过机器学习技术逐渐摸索出效果最好的组合。自适应搜索广告可以动态调整广告的内容，使其更贴近潜在客户的搜索字词，从而提升您的广告系列效果。

有关详情，请访问 https://support.google.com/google-ads/answer/7684791

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
字段
headlines[]

object (AdTextAsset)

标题的文字素材资源列表。广告投放时，系统会从此列表中选择标题。
descriptions[]

object (AdTextAsset)

说明的文字素材资源列表。广告投放时，系统会从此列表中选择说明。
path1

string

可附加到广告中网址的第一部分文字。
path2

string

可附加到广告中网址的第二部分文字。仅当同时设置了 path1 时，才能设置此字段。

LegacyResponsiveDisplayAdInfo

旧版自适应展示广告。此类广告在 Google Ads 界面中标记为“自适应广告”。

JSON 表示法 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
字段
formatSetting

enum (DisplayAdFormatSetting)

指定投放广告采用的格式。默认为 ALL_FORMAT。
shortHeadline

string

短版本的广告标题。
longHeadline

string

长版本的广告标题。
description

string

广告的广告内容描述。
businessName

string

广告中的商家名称。
allowFlexibleColor

boolean

广告主同意使用灵活的颜色。如果为 true，则系统可根据需要以不同颜色投放广告。如果为 false，则系统会以指定颜色或中性颜色投放广告。默认值为 true。如果未设置 mainColor 和 accentColor，则必须为 true。
accentColor

string

广告的强调色，采用十六进制格式，例如 #ffffff 表示白色。如果设置了 mainColor 和 accentColor 中的一个，则另一个也是必需的。
mainColor

string

广告的主颜色，以十六进制格式表示，例如 #ffffff 表示白色。如果设置了 mainColor 和 accentColor 中的一个，则另一个也是必需的。
callToActionText

string

广告的号召性用语。
logoImage

string

广告中使用的徽标图片的 MediaFile 资源名称。
squareLogoImage

string

广告中使用的方形徽标图片的 MediaFile 资源名称。
marketingImage

string

广告中使用的营销图片的 MediaFile 资源名称。
squareMarketingImage

string

广告中使用的方形营销图片的 MediaFile 资源名称。
pricePrefix

string

价格之前的前缀。例如，“低至”。
promoText

string

用于动态格式自适应广告的宣传文字。例如，“两日运费免费”。

DisplayAdFormatSetting

枚举展示广告格式设置。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
ALL_FORMATS 文字、图片和原生广告格式。
NON_NATIVE 文字和图片格式。
NATIVE 例如，原生格式广告的格式呈现由发布商控制，而不受 Google 控制。

AppAdInfo

应用广告。

JSON 表示法 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
字段
mandatoryAdText

object (AdTextAsset)

必填广告文字。
headlines[]

object (AdTextAsset)

标题的文字素材资源列表。广告投放时，系统会从此列表中选择标题。
descriptions[]

object (AdTextAsset)

说明的文字素材资源列表。广告投放时，系统会从此列表中选择说明。
images[]

object (AdImageAsset)

可以与广告一起展示的图片素材资源列表。
youtubeVideos[]

object (AdVideoAsset)

可与广告一起展示的 YouTube 视频素材资源列表。
html5MediaBundles[]

object (AdMediaBundleAsset)

可与广告一起使用的媒体包素材资源列表。

AdMediaBundleAsset

在广告中使用的媒体包素材资源。

JSON 表示法 
{
  "asset": string
}
字段
asset

string

此媒体包的素材资源资源名称。

LegacyAppInstallAdInfo

只能由少数精选客户使用的旧版应用安装广告。

JSON 表示法 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
字段
appStore

enum (LegacyAppInstallAdAppStore)

提供移动应用的应用商店。
appId

string

移动应用的 ID。
headline

string

广告的标题。
description1

string

广告的第一行广告内容描述。
description2

string

广告的第二行广告内容描述。

LegacyAppInstallAdAppStore

旧版应用安装广告中的应用商店类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
APPLE_APP_STORE Apple iTunes。
GOOGLE_PLAY Google Play。
WINDOWS_STORE Windows 应用商店。
WINDOWS_PHONE_STORE Windows Phone Store。
CN_APP_STORE 该应用托管在中国应用商店中。

ResponsiveDisplayAdInfo

自适应展示广告。

JSON 表示法 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
字段
marketingImages[]

object (AdImageAsset)

在广告中使用的营销图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 600x314，宽高比必须为 1.91:1 (+-1%)。必须至少选择一个 marketingImage。搭配 squareMarketingImages 使用时，最大值为 15。
squareMarketingImages[]

object (AdImageAsset)

在广告中使用的方形营销图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 300x300，宽高比必须为 1:1 (+-1%)。必须至少提供一个方形 marketingImage。搭配 marketingImages 使用时，最大值为 15。
logoImages[]

object (AdImageAsset)

在广告中使用的徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 512x128，宽高比必须为 4:1 (+-1%)。搭配 squareLogoImages 使用时，最大值为 5。
squareLogoImages[]

object (AdImageAsset)

在广告中使用的方形徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128，宽高比必须为 1:1 (+-1%)。搭配 logoImages 使用时，最大值为 5。
headlines[]

object (AdTextAsset)

广告的短格式标题。最大长度为 30 个字符。可以指定至少 1 个和最多 5 个标题。
longHeadline

object (AdTextAsset)

必须提供长格式标题。最大长度为 90 个字符。
descriptions[]

object (AdTextAsset)

广告的描述性文字。最大长度为 90 个字符。可以指定至少 1 个和最多 5 个标题。
youtubeVideos[]

object (AdVideoAsset)

（可选）广告的 YouTube 视频。最多可以指定 5 个视频。
formatSetting

enum (DisplayAdFormatSetting)

指定投放广告采用的格式。默认为 ALL_FORMAT。
controlSpec

object (ResponsiveDisplayAdControlSpec)

各种广告素材控件的规范。
businessName

string

广告主/品牌名称。最大展示宽度为 25。
mainColor

string

广告的主颜色，以十六进制格式表示，例如 #ffffff 表示白色。如果设置了 mainColor 和 accentColor 中的一个，则另一个也是必需的。
accentColor

string

广告的强调色，采用十六进制格式，例如 #ffffff 表示白色。如果设置了 mainColor 和 accentColor 中的一个，则另一个也是必需的。
allowFlexibleColor

boolean

广告主同意使用灵活的颜色。如果为 true，则系统可根据需要以不同颜色投放广告。如果为 false，则系统会以指定颜色或中性颜色投放广告。默认值为 true。如果未设置 mainColor 和 accentColor，则必须为 true。
callToActionText

string

广告的号召性用语文字。最大展示宽度为 30。
pricePrefix

string

价格之前的前缀。例如，“低至”。
promoText

string

用于动态格式自适应广告的宣传文字。例如，“两日运费免费”。

ResponsiveDisplayAdControlSpec

自适应展示广告的各种广告素材控制规范。

JSON 表示法 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
字段
enableAssetEnhancements

boolean

广告客户是否已选择启用素材资源自动美化功能。
enableAutogenVideo

boolean

广告客户是否已选择启用自动生成的视频功能。

LocalAdInfo

本地广告。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
字段
headlines[]

object (AdTextAsset)

标题的文字素材资源列表。投放广告时，系统会从此列表中选择标题。必须指定至少 1 个标题，最多 5 个。
descriptions[]

object (AdTextAsset)

说明的文字素材资源列表。投放广告时，系统会从此列表中选择广告内容描述。必须指定至少 1 条广告内容描述（最多 5 条）。
callToActions[]

object (AdTextAsset)

号召性用语文字素材资源列表。广告投放时，系统将从此列表中选择号召性用语。必须指定至少 1 条、最多 5 条号召性用语。
marketingImages[]

object (AdImageAsset)

可与广告一起展示的营销图片素材资源的列表。图片尺寸必须为 314x600 像素或 320x320 像素。必须指定至少 1 个图片素材资源，但最多不能超过 20 个。
logoImages[]

object (AdImageAsset)

可与广告一起展示的徽标图片素材资源的列表。图片大小必须为 128x128 像素，且不超过 120KB。必须指定至少 1 个图片素材资源，但最多不能超过 5 个。
videos[]

object (AdVideoAsset)

可与广告一起展示的 YouTube 视频素材资源列表。必须指定视频素材资源，但不能超过 20 个。
path1

string

可选文字的第一部分，可附加到广告中的网址。
path2

string

可选文字的第二部分，可附加到广告中的网址。仅当同时设置了 path1 时，才能设置此字段。

DisplayUploadAdInfo

通用类型的展示广告。具体的广告格式由 displayUploadProductType 字段控制，该字段用于确定广告中需要包含的数据类型。

JSON 表示法 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
字段
displayUploadProductType

enum (DisplayUploadProductType)

此广告的产品类型。如需了解详情，请参阅有关枚举的注释。
联合字段 media_asset。构成广告的素材资源数据。media_asset 只能是下列其中一项：
mediaBundle

object (AdMediaBundleAsset)

要在广告中使用的媒体包素材资源。有关适用于 HTML5_UPLOAD_AD 的媒体包的信息，请参阅 https://support.google.com/google-ads/answer/1722096 属于动态产品类型一部分的媒体包使用一种特殊格式，且需通过 Google Web Designer 创建。如需了解详情，请参阅 https://support.google.com/webdesigner/answer/7543898。

DisplayUploadProductType

枚举与展示广告上传相关的商品类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
HTML5_UPLOAD_AD HTML5 上传广告。对于此商品类型，需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。
DYNAMIC_HTML5_EDUCATION_AD HTML5 动态教育广告。对于此商品类型，需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于教育广告系列。
DYNAMIC_HTML5_FLIGHT_AD HTML5 动态航班广告。对于此商品类型，需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于投放广告系列。
DYNAMIC_HTML5_HOTEL_RENTAL_AD 动态 HTML5 酒店及房屋租赁广告。对于此商品类型，需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于酒店广告系列。
DYNAMIC_HTML5_JOB_AD 动态 HTML5 求职招聘广告。对于此商品类型，需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于求职招聘广告系列。
DYNAMIC_HTML5_LOCAL_AD 动态 HTML5 本地广告。对于此商品类型，需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于本地广告系列。
DYNAMIC_HTML5_REAL_ESTATE_AD 动态 HTML5 房地产广告。对于此商品类型，需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于房地产广告系列。
DYNAMIC_HTML5_CUSTOM_AD 动态 HTML5 自定义广告。对于此商品类型，需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于自定义广告系列。
DYNAMIC_HTML5_TRAVEL_AD 动态 HTML5 旅游广告。对于此商品类型，需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于旅游广告系列。
DYNAMIC_HTML5_HOTEL_AD 动态 HTML5 酒店广告。对于此商品类型，需要设置 DisplayUploadAdInfo 中的 upload_media_bundle 字段。只能用于酒店广告系列。

AppEngagementAdInfo

利用应用互动广告，您可以撰写旨在鼓励用户在应用中采取特定操作（比如登记、购买或预订机票）的广告文字。通过自适应展示广告，您可以将用户引导至您应用的特定部分，以便他们更轻松快捷地找到所需内容。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
字段
headlines[]

object (AdTextAsset)

标题的文字素材资源列表。广告投放时，系统会从此列表中选择标题。
descriptions[]

object (AdTextAsset)

说明的文字素材资源列表。广告投放时，系统会从此列表中选择说明。
images[]

object (AdImageAsset)

可以与广告一起展示的图片素材资源列表。
videos[]

object (AdVideoAsset)

可与广告一起展示的视频素材资源列表。

ShoppingComparisonListingAdInfo

比价购物广告。

JSON 表示法 
{
  "headline": string
}
字段
headline

string

广告的标题。必须填写此字段。允许的长度介于 25 到 45 个字符之间。

AppPreRegistrationAdInfo

应用预注册广告会链接到您在 Google Play 上的应用或游戏详情，并且可以在 Google Play、YouTube（仅限插播广告）以及展示广告网络中的其他应用和移动网站上投放。这有助于激发用户对应用或游戏的兴趣，并在应用或游戏发布前预先吸引安装群体。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
字段
headlines[]

object (AdTextAsset)

标题的文字素材资源列表。广告投放时，系统会从此列表中选择标题。
descriptions[]

object (AdTextAsset)

说明的文字素材资源列表。广告投放时，系统会从此列表中选择说明。
images[]

object (AdImageAsset)

图片素材资源 ID 列表，其中的图片可与广告一起显示。
youtubeVideos[]

object (AdVideoAsset)

YouTube 视频资产 ID 列表，其中的视频可与广告一起展示。

DemandGenMultiAssetAdInfo

一种多素材资源需求开发广告。

JSON 表示法 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
字段
marketingImages[]

object (AdImageAsset)

要在广告中使用的营销图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 600x314，宽高比必须为 1.91:1 (+-1%)。如果不存在 squareMarketingImages，则该属性为必需。与 squareMarketingImages 和 portraitMarketingImages 结合使用时，上限为 20。
squareMarketingImages[]

object (AdImageAsset)

在广告中使用的方形营销图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 300x300，宽高比必须为 1:1 (+-1%)。如果 marketingImages 不存在，则为必需。与 marketingImages 和 portraitMarketingImages 结合使用时，上限为 20。
portraitMarketingImages[]

object (AdImageAsset)

在广告中使用的纵向营销图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 480x600，宽高比必须为 4:5 (+-1%)。与 marketingImages 和 squareMarketingImages 结合使用时，上限为 20。
logoImages[]

object (AdImageAsset)

要在广告中使用的徽标图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128，宽高比必须为 1:1 (+-1%)。可以指定至少 1 个到 5 个徽标图片。
headlines[]

object (AdTextAsset)

广告的标题文字素材资源。显示宽度上限为 30。可以指定至少 1 个和最多 5 个标题。
descriptions[]

object (AdTextAsset)

广告的描述性文字。最大显示宽度为 90。可以指定至少 1 到 5 条广告内容描述。
businessName

string

广告客户/品牌名称。最大显示宽度为 25。必填。
callToActionText

string

号召性用语文字。
leadFormOnly

boolean

指示此广告是否必须与潜在客户表单一起投放的布尔值选项。

DemandGenCarouselAdInfo

轮播式需求开发广告。

JSON 表示法 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDemandGenCarouselCardAsset)
    }
  ]
}
字段
businessName

string

必需。广告客户/品牌名称。
logoImage

object (AdImageAsset)

必需。在广告中使用的徽标图片。最小尺寸为 128x128，宽高比必须为 1:1 (+-1%)。
headline

object (AdTextAsset)

必需。广告的标题。
description

object (AdTextAsset)

必需。广告的描述性文字。
callToActionText

string

号召性用语文字。
carouselCards[]

object (AdDemandGenCarouselCardAsset)

必需。将与广告一起显示的轮播卡片。最小值 2 最大值 10。

AdDemandGenCarouselCardAsset

在广告中使用的需求开发轮播卡片素材资源。

JSON 表示法 
{
  "asset": string
}
字段
asset

string

此轮播式发现广告卡片的资产资源名称。

DemandGenVideoResponsiveAdInfo

需求开发视频自适应广告。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
字段
headlines[]

object (AdTextAsset)

短标题所用文字素材资源的列表。
longHeadlines[]

object (AdTextAsset)

用于长标题的文字素材资源列表。
descriptions[]

object (AdTextAsset)

用于说明文字素材资源的列表。
videos[]

object (AdVideoAsset)

广告所用 YouTube 视频素材资源的列表。
logoImages[]

object (AdImageAsset)

在广告中使用的徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128，宽高比必须为 1:1 (+-1%)。
breadcrumb1

string

与显示网址一起在广告中显示的文字的第一部分。
breadcrumb2

string

与显示网址一起在广告中显示的文字的第二部分。
businessName

object (AdTextAsset)

必需。广告客户/品牌名称。
callToActions[]

object (AdCallToActionAsset)

用于“号召性用语”按钮的 CallToActionAsset 类型的素材资源。

AdCallToActionAsset

在广告中使用的号召性用语素材资源。

JSON 表示法 
{
  "asset": string
}
字段
asset

string

此号召性用语素材资源的资源名称。

DemandGenProductAdInfo

一个产品需求开发广告。

JSON 表示法 
{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}
字段
breadcrumb1

string

与显示网址一起在广告中显示的文字的第一部分。
breadcrumb2

string

与显示网址一起在广告中显示的文字的第二部分。
businessName

object (AdTextAsset)

必需。广告客户/品牌名称。
headline

object (AdTextAsset)

必需。用于短标题的文字素材资源。
description

object (AdTextAsset)

必需。用于广告内容描述的文字素材资源。
logoImage

object (AdImageAsset)

必需。在广告中使用的徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128，宽高比必须为 1:1 (+-1%)。
callToAction

object (AdCallToActionAsset)

用于“号召性用语”按钮的 CallToActionAsset 类型的素材资源。

TravelAdInfo

此类型没有字段。

一则旅游广告。