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 中的自定义参数标记的映射列表。对于更改，请使用网址自定义参数操作。
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

不可变。广告的名称。此名称仅用于能够标识广告。该名称不必是唯一的，也不会影响投放的广告。目前只有 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_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

图片的名称。如果图片是通过 MediaFile 创建的，则为 MediaFile 的名称。如果图片是通过字节创建的，则为空。
联合字段 image。用于创建 ImageAd 的图片。您可以通过以下两种方式之一指定此值。1. 现有的 MediaFile 资源。2. 原始图片数据（以字节为单位）。image 只能是下列其中一项：
imageAsset

object (AdImageAsset)

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

string (bytes format)

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

使用 base64 编码的字符串。
adIdToCopyImageFrom

string (int64 format)

图片复制自的广告 ID。

AdImageAsset

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

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

string

此图片的素材资源名称。

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

包含 AdVideoAsset 的信息字段。

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

object (AdVideoAssetInventoryPreferences)

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

AdVideoAssetInventoryPreferences

YouTube 视频素材资源广告资源偏好设置。

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

boolean

如果为 true，则在选择要在信息流中投放的视频时，系统会优先选择具有此广告资源偏好设置的 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)
    }
  ],
  "appDeepLink": {
    object (AdAppDeepLinkAsset)
  }
}
字段
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

此媒体文件包的资产资源名称。

AdAppDeepLinkAsset

广告中使用的应用深层链接。

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 应用商店。
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 像素，且不大于 120 KB。必须指定至少 1 个，最多 5 个图片素材资源。
videos[]

object (AdVideoAsset)

可与广告一起展示的 YouTube 视频素材资源列表。必须指定至少 1 项，最多 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)
    }
  ],
  "tallPortraitMarketingImages": [
    {
      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 和 tallPortraitMarketingImages 结合使用时，上限为 20。
squareMarketingImages[]

object (AdImageAsset)

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

object (AdImageAsset)

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

object (AdImageAsset)

要在广告中使用的竖长型纵向营销图片素材资源。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 600x1067，宽高比必须为 9:16 (+-1%)。与 marketingImages、squareMarketingImages 和 portraitMarketingImages 结合使用时，上限为 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

此类型没有字段。

旅游广告。