REST Resource: customers.ads

{
  "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)
  },
  "discoveryMultiAssetAd": {
    object (DiscoveryMultiAssetAdInfo)
  },
  "discoveryCarouselAd": {
    object (DiscoveryCarouselAdInfo)
  },
  "discoveryVideoResponsiveAd": {
    object (DiscoveryVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}

string

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

customers/{customerId}/ads/{ad_id}

string

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

object (FinalAppUrl)

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

string

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

object (CustomParameter)

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

enum (AdType)

仅供输出。广告的类型。

enum (Device)

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

object (UrlCollection)

广告的其他网址，该网址带有可从广告中的其他字段引用的唯一标识符。

enum (SystemManagedResourceSource)

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

string (int64 format)

仅供输出。广告的 ID。

string

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

string

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

string

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

boolean

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

string

不可变。广告的名称。这仅用于识别广告。该名称不必是唯一的，也不会影响投放的广告。目前，只有 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd 支持 name 字段。

object (TextAdInfo)

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

object (ExpandedTextAdInfo)

与加大型文字广告有关的详细信息。

object (CallAdInfo)

与来电广告相关的详细信息。

object (ExpandedDynamicSearchAdInfo)

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

object (HotelAdInfo)

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

object (ShoppingSmartAdInfo)

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

object (ShoppingProductAdInfo)

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

object (ImageAdInfo)

不可变。与图片广告有关的详细信息。

object (VideoAdInfo)

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

object (VideoResponsiveAdInfo)

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

object (ResponsiveSearchAdInfo)

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

object (LegacyResponsiveDisplayAdInfo)

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

object (AppAdInfo)

与应用广告相关的详细信息。

object (LegacyAppInstallAdInfo)

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

object (ResponsiveDisplayAdInfo)

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

object (LocalAdInfo)

与本地广告相关的详细信息。

object (DisplayUploadAdInfo)

与上传的展示广告相关的详细信息。

object (AppEngagementAdInfo)

与应用互动广告相关的详细信息。

object (ShoppingComparisonListingAdInfo)

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

object (SmartCampaignAdInfo)

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

object (AppPreRegistrationAdInfo)

与应用预注册广告相关的详情。

object (DiscoveryMultiAssetAdInfo)

与多重素材资源发现广告有关的详细信息。

object (DiscoveryCarouselAdInfo)

与轮播式发现广告的相关详情。

object (DiscoveryVideoResponsiveAdInfo)

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

object (DemandGenProductAdInfo)

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

object (TravelAdInfo)

与旅游广告相关的详情。

{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}

enum (AppUrlOperatingSystemType)

此网址定位的操作系统。必填。

string

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

{
  "key": string,
  "value": string
}

string

与参数标记名称匹配的键。

string

要替换的值。

{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}

string

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

string

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

string

此 UrlCollection 实例的唯一标识符。

string

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

{
  "headline": string,
  "description1": string,
  "description2": string
}

string

广告的标题。

string

广告内容描述的第一行。

string

广告内容描述的第二行。

{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}

string

广告标题的第一部分。

string

广告标题的第二部分。

string

广告标题的第三部分。

string

广告的广告内容描述。

string

广告的第二条说明。

string

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

string

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

{
  "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
}

string

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

string

广告中的电话号码。

string

广告中的商家名称。

string

广告中的第一个标题。

string

广告中的第二个标题。

string

广告内容描述的第一行。

string

广告内容描述的第二行。

boolean

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

boolean

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

string

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

string

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

enum (CallConversionReportingState)

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

string

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

string

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

{
  "description": string,
  "description2": string
}

string

广告的广告内容描述。

string

广告的第二条说明。

{
  "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.
}

enum (MimeType)

图片的 MIME 类型。

string (int64 format)

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

string (int64 format)

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

string

全尺寸图片的网址。

string (int64 format)

预览大小图片的宽度（以像素为单位）。

string (int64 format)

预览大小图片的高度（以像素为单位）。

string

预览尺寸图片的网址。

string

图片的名称。如果图片是从媒体文件创建的，这就是该媒体文件的名称。如果图片是通过字节创建的，则为空。

object (AdImageAsset)

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

string (bytes format)

原始图片数据（以字节形式）。

使用 base64 编码的字符串。

string (int64 format)

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

{
  "asset": string
}

string

此图片的资产资源名称。

{
  "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.
}

object (AdVideoAsset)

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

object (VideoTrueViewInStreamAdInfo)

视频 TrueView 插播广告格式。

object (VideoBumperInStreamAdInfo)

导视插播视频广告格式。

object (VideoOutstreamAdInfo)

视频外播广告格式。

object (VideoNonSkippableInStreamAdInfo)

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

object (InFeedVideoAdInfo)

信息流视频广告格式。

{
  "asset": string
}

string

此视频的资产资源名称。

{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}

string

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

string

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

object (AdImageAsset)

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

{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}

object (AdImageAsset)

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

string

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

string

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

{
  "headline": string,
  "description": string
}

string

广告的标题。

string

广告内容描述。

{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}

object (AdImageAsset)

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

string

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

string

通过“号召性用语”按钮显示的额外文字，提供了背景信息并鼓励用户点击该按钮。

{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}

string

广告的标题。

string

广告的第一行文字。

string

广告的第二行文字。

enum (VideoThumbnail)

要使用的视频缩略图。

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}

object (AdTextAsset)

用于短标题的文字素材资源列表。目前仅支持短标题的一个值。

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdTextAsset)

用于按钮的文字素材资源列表，例如“号召性用语”按钮。目前仅支持按钮的一个值。

object (AdVideoAsset)

广告所用 YouTube 视频素材资源的列表。目前，YouTube 视频素材资源仅支持单个值。

object (AdImageAsset)

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

string

广告中显示的文字的第一部分，包含显示网址。

string

广告中显示的文字的第二部分以及显示网址。

{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}

enum (ServedAssetFieldType)

素材资源的固定字段。这会将素材资源限制为仅在此字段内投放。您可以将多个素材资源固定到同一字段。取消固定或固定到其他字段的素材资源将不会在已固定其他一些素材资源的字段中投放。

enum (AssetPerformanceLabel)

此文字素材资源的效果标签。

object (AdAssetPolicySummary)

此文字素材资源的政策摘要。

string

素材资源文字。

{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}

object (PolicyTopicEntry)

此资产的政策发现结果列表。

enum (PolicyReviewStatus)

此素材资源在审核过程中的哪个阶段。

enum (PolicyApprovalStatus)

此素材资源的整体审批状态，根据其各个政策主题条目的状态计算得出。

{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}

enum (PolicyTopicEntryType)

描述此政策会对广告投放产生的负面影响或积极影响。

object (PolicyTopicEvidence)

用于解释发现结果的其他信息（例如，商标发现结果的品牌名称）。

object (PolicyTopicConstraint)

指明此资源的投放可能会受到怎样的影响（例如，不在某个国家/地区投放）。

string

此发现结果涉及的政策主题。例如，“ALCOHOL”“TRADEMARKS_IN_AD_TEXT”或“DESTINATION_NOT_WORKING”。可能的政策主题集不是针对特定 API 版本固定的，可能随时发生更改。

{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}

object (WebsiteList)

与此资源关联的网站的列表。

object (TextList)

在资源文本中发现的证据列表。

string

检测到编写资源时使用的语言。这是 IETF 语言标记，例如“en-US”。

object (DestinationTextList)

导致政策发现结果的资源目标位置中的文本。

object (DestinationMismatch)

资源网址的目标页面不匹配。

object (DestinationNotWorking)

详细说明目的地何时返回 HTTP 错误代码，或并非在所有常用设备都正常运行。

{
  "websites": [
    string
  ]
}

string

导致违规的网站。

{
  "texts": [
    string
  ]
}

string

资源中导致政策发现结果的文本片段。

{
  "destinationTexts": [
    string
  ]
}

string

在资源的目标页面中发现的文本列表。

{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

彼此不匹配的网址集。

{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

未能加载网址的设备类型。

string

无法访问的完整网址。

string

上次检查网址的时间。其格式为“YYYY-MM-DD HH:MM:SS”。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

DNS 错误的类型。

string (int64 format)

HTTP 错误代码。

{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}

object (CountryConstraintList)

无法投放资源的国家/地区。

object (ResellerConstraint)

转销商限制条件。

object (CountryConstraintList)

需要有证书才能投放广告的国家/地区。

object (CountryConstraintList)

资源的网域不在与其关联的证书涵盖的国家/地区。

{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}

object (CountryConstraint)

广告投放受限的国家/地区。

integer

资源定位的国家/地区总数。

{
  "countryCriterion": string
}

string

广告投放受限的国家/地区的地理位置定位常量资源名称。

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}

object (AdTextAsset)

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

object (AdTextAsset)

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

string

可以附加到广告中网址的第一部分。

string

可以附加到广告中网址的第二部分文字。只有在同时设置了 path1 时才能设置此字段。

{
  "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
}

enum (DisplayAdFormatSetting)

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

string

短版本的广告标题。

string

长版本的广告标题。

string

广告的广告内容描述。

string

广告中的商家名称。

boolean

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

string

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

string

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

string

广告的号召性用语。

string

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

string

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

string

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

string

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

string

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

string

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

{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}

object (AdTextAsset)

必填广告文字。

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdImageAsset)

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

object (AdVideoAsset)

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

object (AdMediaBundleAsset)

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

{
  "asset": string
}

string

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

{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}

enum (LegacyAppInstallAdAppStore)

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

string

移动应用的 ID。

string

广告的标题。

string

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

string

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

{
  "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
}

object (AdImageAsset)

要在广告中使用的营销图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 600x314，宽高比必须为 1.91:1 (+-1%)。至少需要提供一个 marketingImage。如果与 squareMarketingImages 结合使用，则最大值为 15。

object (AdImageAsset)

要在广告中使用的方形营销图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 300x300，宽高比必须为 1:1 (+-1%)。至少需要一个方形 marketingImage。如果与 marketingImages 结合使用，则最大值为 15。

object (AdImageAsset)

要在广告中使用的徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 512x128，宽高比必须为 4:1 (+-1%)。如果与 squareLogoImages 结合使用，则最多可以指定 5 个。

object (AdImageAsset)

要在广告中使用的正方形徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128，宽高比必须为 1:1 (+-1%)。如果与 logoImages 结合使用，则最多可以指定 5 个。

object (AdTextAsset)

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

object (AdTextAsset)

必需的长格式标题。最大长度为 90 个字符。

object (AdTextAsset)

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

object (AdVideoAsset)

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

enum (DisplayAdFormatSetting)

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

object (ResponsiveDisplayAdControlSpec)

各种广告素材控制的规范。

string

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

string

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

string

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

boolean

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

string

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

string

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

string

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

{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}

boolean

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

boolean

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

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}

object (AdTextAsset)

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

object (AdTextAsset)

说明的文字素材资源列表。在投放广告时，系统会从此列表中选择广告内容描述。必须至少指定 1 到 5 项广告内容描述。

object (AdTextAsset)

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

object (AdImageAsset)

可与广告一起展示的营销图片素材资源列表。图片必须为 314x600 像素或 320x320 像素。必须至少指定 1 到 20 项图片素材资源。

object (AdImageAsset)

可随广告一起展示的徽标图片素材资源的列表。图片必须为 128x128 像素，且不得超过 120KB。必须至少指定 1 到 5 项图片素材资源。

object (AdVideoAsset)

可与广告一起展示的 YouTube 视频素材资源的列表。必须指定至少 1 到 20 项视频素材资源。

string

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

string

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

{
  "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.
}

enum (DisplayUploadProductType)

此广告的产品类型。如需了解详情，请参阅枚举的注释。

object (AdMediaBundleAsset)

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

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdImageAsset)

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

object (AdVideoAsset)

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

{
  "headline": string
}

string

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

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}

object (AdTextAsset)

文字素材资源列表，其中每项素材资源都与广告投放时的一个标题相对应。此列表包含至少 3 到 15 个文字素材资源。

object (AdTextAsset)

文字素材资源列表，其中每项素材资源在广告投放时均对应一条广告内容描述。此列表包含至少 2 到 4 个文字素材资源。

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdImageAsset)

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

object (AdVideoAsset)

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

{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}

object (AdImageAsset)

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

object (AdImageAsset)

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

object (AdImageAsset)

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

object (AdImageAsset)

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

object (AdTextAsset)

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

object (AdTextAsset)

广告的描述性文字。显示屏宽度上限为 90。可以指定至少 1 到 5 项广告内容描述。

string

广告客户/品牌名称。显示屏宽度上限为 25。必填。

string

号召性用语文字。

boolean

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

{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}

string

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

object (AdImageAsset)

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

object (AdTextAsset)

必需。广告的标题。

object (AdTextAsset)

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

string

号召性用语文字。

object (AdDiscoveryCarouselCardAsset)

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

{
  "asset": string
}

string

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

{
  "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)
    }
  ]
}

object (AdTextAsset)

用于短标题的文字素材资源列表。

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdVideoAsset)

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

object (AdImageAsset)

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

string

广告中显示的文字的第一部分，包含显示网址。

string

广告中显示的文字的第二部分以及显示网址。

object (AdTextAsset)

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

object (AdCallToActionAsset)

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

{
  "asset": string
}

string

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

{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}

string

广告中显示的文字的第一部分，包含显示网址。

string

广告中显示的文字的第二部分以及显示网址。

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdTextAsset)

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

object (AdImageAsset)

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

object (AdCallToActionAsset)

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