SearchAds360Row

查询返回的行。

JSON 表示法 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
字段
adGroup

object (AdGroup)

查询中引用的广告组。
adGroupAd

object (AdGroupAd)

查询中引用的广告。
adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

查询中引用的广告组广告有效标签。
adGroupAdLabel

object (AdGroupAdLabel)

查询中引用的广告组广告标签。
adGroupAsset

object (AdGroupAsset)

查询中引用的广告组素材资源。
adGroupAssetSet

object (AdGroupAssetSet)

查询中引用的广告组素材资源集。
adGroupAudienceView

object (AdGroupAudienceView)

查询中引用的广告组受众群体视图。
adGroupBidModifier

object (AdGroupBidModifier)

查询中引用的出价调节系数。
adGroupCriterion

object (AdGroupCriterion)

查询中引用的条件。
adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

查询中引用的广告组条件有效标签。
adGroupCriterionLabel

object (AdGroupCriterionLabel)

查询中引用的广告组条件标签。
adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

查询中引用的广告组有效标签。
adGroupLabel

object (AdGroupLabel)

查询中引用的广告组标签。
ageRangeView

object (AgeRangeView)

查询中引用的年龄段视图。
asset

object (Asset)

查询中引用的资产。
assetGroupAsset

object (AssetGroupAsset)

查询中引用的素材资源组素材资源。
assetGroupSignal

object (AssetGroupSignal)

查询中引用的素材资源组信号。
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

查询中引用的素材资源组产品信息组过滤条件。
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

查询中引用的素材资源组效果最佳的组合视图。
assetGroup

object (AssetGroup)

查询中引用的素材资源组。
assetSetAsset

object (AssetSetAsset)

查询中引用的素材资源组的素材资源。
assetSet

object (AssetSet)

查询中引用的资源集。
biddingStrategy

object (BiddingStrategy)

查询中引用的出价策略。
campaignBudget

object (CampaignBudget)

查询中引用的广告系列预算。
campaign

object (Campaign)

查询中引用的广告系列。
campaignAsset

object (CampaignAsset)

查询中引用的广告系列素材资源。
campaignAssetSet

object (CampaignAssetSet)

查询中引用的广告系列素材资源组。
campaignAudienceView

object (CampaignAudienceView)

查询中引用的广告系列受众群体视图。
campaignCriterion

object (CampaignCriterion)

查询中引用的广告系列条件。
campaignEffectiveLabel

object (CampaignEffectiveLabel)

查询中引用的有效广告系列标签。
campaignLabel

object (CampaignLabel)

查询中引用的广告系列标签。
cartDataSalesView

object (CartDataSalesView)

查询中引用的购物车数据销售情况视图。
audience

object (Audience)

查询中引用的受众群体。
conversionAction

object (ConversionAction)

查询中引用的转化操作。
conversionCustomVariable

object (ConversionCustomVariable)

查询中引用的转化自定义变量。
customer

object (Customer)

查询中引用的客户。
customerAsset

object (CustomerAsset)

查询中引用的客户资产。
customerAssetSet

object (CustomerAssetSet)

查询中引用的客户素材资源集。
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

查询中引用的可访问出价策略。
customerClient

object (CustomerClient)

查询中引用的 CustomerClient。
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

查询中引用的动态搜索广告搜索字词视图。
genderView

object (GenderView)

查询中引用的性别视图。
geoTargetConstant

object (GeoTargetConstant)

查询中引用的地理位置定位条件常量。
keywordView

object (KeywordView)

查询中引用的关键字视图。
label

object (Label)

查询中引用的标签。
languageConstant

object (LanguageConstant)

查询中引用的语言常量。
locationView

object (LocationView)

查询中引用的位置视图。
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

查询中引用的商品出价类别。
productGroupView

object (ProductGroupView)

查询中引用的商品组视图。
shoppingPerformanceView

object (ShoppingPerformanceView)

查询中引用的购物广告效果视图。
userList

object (UserList)

查询中引用的用户列表。
userLocationView

object (UserLocationView)

查询中引用的用户位置信息视图。
webpageView

object (WebpageView)

查询中引用的网页视图。
visit

object (Visit)

查询中引用的事件级访问。
conversion

object (Conversion)

查询中引用的事件级转化。
metrics

object (Metrics)

指标。
segments

object (Segments)

细分。
customColumns[]

object (Value)

自定义列。

广告组

一个广告组。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
字段
resourceName

string

广告组的资源名称。广告组资源名称采用以下格式：

customers/{customerId}/adGroups/{ad_group_id}
status

enum (AdGroupStatus)

广告组的状态。
type

enum (AdGroupType)

广告组的类型。
adRotationMode

enum (AdGroupAdRotationMode)

广告组的广告轮播模式。
creationTime

string

创建相应 adGroup 时的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。
targetingSetting

object (TargetingSetting)

与定位相关的功能的设置。
labels[]

string

附加到此广告组的标签的资源名称。
effectiveLabels[]

string

附加到相应广告组的有效标签的资源名称。有效标签是指继承或直接分配给相应广告组的标签。
engineId

string

外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号，例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体，请改用“adGroup.id”。
startDate

string

相应广告组开始投放广告的日期。默认情况下，广告组会立即或在广告组的开始日期（以较早者为准）开始投放广告。如果设置了此字段，则广告组将从客户时区的指定日期开始时开始投放广告。此字段仅可用于 Microsoft Advertising 和 Facebook 网关账号。

格式：YYYY-MM-DD 示例：2019-03-14
endDate

string

广告组停止投放广告的日期。默认情况下，广告组会在广告组的结束日期停止投放广告。如果设置了此字段，则广告组会在客户时区的指定日期结束时停止投放广告。此字段仅可用于 Microsoft Advertising 和 Facebook 网关账号。

格式：YYYY-MM-DD 示例：2019-03-14
languageCode

string

广告组中的广告和关键字的语言。此字段仅可用于 Microsoft Advertising 账号。如需了解详情，请访问：https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
lastModifiedTime

string

上次修改此广告组的日期时间。日期时间采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。
id

string (int64 format)

广告组的 ID。
name

string

广告组的名称。

此字段为必填字段，在创建新广告组时不应为空。

它包含的 UTF-8 全宽字符不得超过 255 个，

并且不得包含任何 null（码位 0x0）、NL 换行符（码位 0xA）或回车符（码位 0xD）。
trackingUrlTemplate

string

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

string (int64 format)

每次点击费用 (cost-per-click) 出价上限。
engineStatus

enum (AdGroupEngineStatus)

广告组的引擎状态。
finalUrlSuffix

string

用于将参数附加到最终到达网址的网址模板。

AdGroupStatus

广告组的可能状态。

枚举
UNSPECIFIED 未指定状态。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
ENABLED 广告组已启用。
PAUSED 广告组已暂停。
REMOVED 广告组已移除。

AdGroupType

列出广告组可能类型的枚举。

枚举
UNSPECIFIED 未指定类型。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
SEARCH_STANDARD 搜索广告系列的默认广告组类型。
DISPLAY_STANDARD 展示广告系列的默认广告组类型。
SHOPPING_PRODUCT_ADS 投放标准产品广告的购物广告系列的广告组类型。
SHOPPING_SHOWCASE_ADS 广告组的类型，此类广告组仅限于在购物结果中投放橱窗广告或商家广告。
HOTEL_ADS 酒店广告系列的默认广告组类型。
SHOPPING_SMART_ADS 智能购物广告系列中广告组的类型。
VIDEO_BUMPER 不可跳过的短插播视频广告。
VIDEO_TRUE_VIEW_IN_STREAM TrueView（可跳过）插播视频广告。
VIDEO_TRUE_VIEW_IN_DISPLAY TrueView 展示视频广告。
VIDEO_NON_SKIPPABLE_IN_STREAM 不可跳过的插播视频广告。
VIDEO_OUTSTREAM 外播视频广告。
SEARCH_DYNAMIC_ADS 动态搜索广告广告组的广告组类型。
SHOPPING_COMPARISON_LISTING_ADS 比价购物广告系列中广告组的类型。
PROMOTED_HOTEL_ADS 促销酒店广告组的广告组类型。
VIDEO_RESPONSIVE 自适应视频广告组。
VIDEO_EFFICIENT_REACH “经济实惠地扩大覆盖面”视频广告组。
SMART_CAMPAIGN_ADS 智能广告系列的广告组类型。
TRAVEL_ADS 旅游广告系列的广告组类型。

AdGroupAdRotationMode

广告组的可能广告轮播模式。

枚举
UNSPECIFIED 未指定广告轮播模式。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
OPTIMIZE 根据点击次数或转化次数优化广告组广告。
ROTATE_FOREVER 永久均匀轮播。

AdGroupEngineStatus

广告组引擎的状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AD_GROUP_ELIGIBLE

已弃用。请勿使用。
AD_GROUP_EXPIRED 此广告组的结束日期已过，因此没有广告在投放。
AD_GROUP_REMOVED 相应广告组已被删除。
AD_GROUP_DRAFT 此广告组未投放任何广告，因为关联的广告组仍处于草稿状态。
AD_GROUP_PAUSED 相应广告组已暂停。
AD_GROUP_SERVING 广告组处于有效状态，目前正在投放广告。
AD_GROUP_SUBMITTED 广告组已提交（Microsoft Bing Ads 旧版状态）。
CAMPAIGN_PAUSED 此广告组没有投放任何广告，因为相应广告系列已暂停。
ACCOUNT_PAUSED 此广告组未投放任何广告，因为相应账号已被暂停。

TargetingSetting

广告系列和广告组层级与定位相关的功能的设置。如需详细了解定位设置，请访问 https://support.google.com/google-ads/answer/7365594

JSON 表示法 
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
字段
targetRestrictions[]

object (TargetRestriction)

用于限制广告系列或广告组覆盖面的每个定位维度的设置。

TargetRestriction

每个定位维度对应的定位设置列表。

JSON 表示法 
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
字段
targetingDimension

enum (TargetingDimension)

这些设置所适用的定位维度。
bidOnly

boolean

表示是否限制您的广告仅根据您为此定位维度选择的条件进行展示，或者是否定位此定位维度的所有值，并根据您在其他定位维度中的定位条件展示广告。值为 true 表示这些条件只会应用出价调整系数，而不会影响定位。值为 false 表示这些条件将限制定位，并应用出价调节系数。

TargetingDimension

用于描述可能的定位维度的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
KEYWORD 关键字条件，例如“火星之旅”。KEYWORD 可用作自定义出价维度。关键字始终是定位维度，因此不得使用 TargetRestriction 将其设置为目标“全部”维度。
AUDIENCE 受众群体条件，包括用户名单、用户兴趣、自定义的兴趣相似受众群体和自定义的有购买意向的受众群体。
TOPIC 用于定位内容类别的“主题”条件，例如“category::Animals>Pets”。用于展示广告和视频广告定位。
GENDER 性别定位条件。
AGE_RANGE 年龄段定位条件。
PLACEMENT 展示位置条件，包括“www.flowers4sale.com”等网站，以及移动应用、移动应用类别、YouTube 视频和 YouTube 频道。
PARENTAL_STATUS 育儿状况定位条件的条件。
INCOME_RANGE 收入范围定位条件的条件。

AdGroupAd

广告组广告。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
字段
resourceName

string

相应广告的资源名称。广告组广告资源名称采用以下格式：

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}
status

enum (AdGroupAdStatus)

广告的状态。
ad

object (Ad)

广告。
creationTime

string

相应 adGroupAd 的创建时间戳。日期时间采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。
labels[]

string

附加到此广告组广告的标签的资源名称。
effectiveLabels[]

string

附加到相应广告的有效标签的资源名称。有效标签是指继承或直接分配给相应广告的标签。
engineId

string

外部引擎账号中的广告的 ID。此字段仅适用于 Search Ads 360 账号，例如 Yahoo Japan、Microsoft、百度等。对于非 Search Ads 360 实体，请改用“adGroupAd.ad.id”。
engineStatus

enum (AdGroupAdEngineStatus)

外部引擎账号中的广告的其他状态。可能的状态（取决于外部账号的类型）包括“活跃”“有效”“待审核”等。
lastModifiedTime

string

上次修改此广告组广告的日期时间。日期时间采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。

AdGroupAdStatus

广告组广告可能的状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
ENABLED 广告组广告已启用。
PAUSED 广告组中的广告已暂停。
REMOVED 广告组广告已移除。

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 相应广告是加大型文字广告。
CALL_ONLY_AD 相应广告是来电专用广告。
EXPANDED_DYNAMIC_SEARCH_AD 相应广告是加大型动态搜索广告。
HOTEL_AD 相应广告是酒店广告。
SHOPPING_SMART_AD 广告是智能购物广告。
SHOPPING_PRODUCT_AD 广告是标准购物广告。
VIDEO_AD 广告是视频广告。
GMAIL_AD 此广告是 Gmail 广告。
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_DISCOVERY_AD TrueView 展示视频广告。
VIDEO_TRUEVIEW_IN_STREAM_AD 视频 TrueView 插播广告。
VIDEO_RESPONSIVE_AD 自适应视频广告。
SMART_CAMPAIGN_AD 智能广告系列广告。
APP_PRE_REGISTRATION_AD 通用应用预注册广告。
DISCOVERY_MULTI_ASSET_AD 发现多素材资源广告。
TRAVEL_AD 旅游广告。
DISCOVERY_VIDEO_RESPONSIVE_AD 视频发现自适应广告。
MULTIMEDIA_AD 多媒体广告。

SearchAds360TextAdInfo

Search Ads 360 文字广告。

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

string

广告的标题。
description1

string

广告说明的第一行。
description2

string

广告说明的第二行。
displayUrl

string

广告的显示网址。
displayMobileUrl

string

广告的移动版显示网址。
adTrackingId

string (int64 format)

广告的跟踪 ID。

SearchAds360ExpandedTextAdInfo

Search Ads 360 加大型文字广告。

JSON 表示法 
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
字段
headline

string

广告的标题。
headline2

string

广告的第二个标题。
headline3

string

广告的第三个标题。
description1

string

广告说明的第一行。
description2

string

广告说明的第二行。
path1

string

附加到自动生成的可见网址的文字，带有分隔符。
path2

string

附加到 path1 的文本，带有分隔符。
adTrackingId

string (int64 format)

广告的跟踪 ID。

SearchAds360ResponsiveSearchAdInfo

Search Ads 360 自适应搜索广告。

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

object (AdTextAsset)

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

object (AdTextAsset)

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

string

附加到自动生成的可见网址的文字，带有分隔符。
path2

string

附加到 path1 的文本，带有分隔符。
adTrackingId

string (int64 format)

广告的跟踪 ID。

AdTextAsset

广告中使用的文字素材资源。

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

string

素材资源文字。

SearchAds360ProductAdInfo

此类型没有字段。

Search Ads 360 产品广告。

SearchAds360ExpandedDynamicSearchAdInfo

加大型动态搜索广告。

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

string

广告说明的第一行。
description2

string

广告说明的第二行。
adTrackingId

string (int64 format)

广告的跟踪 ID。

AdGroupAdEngineStatus

枚举 AdGroupAd 引擎状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AD_GROUP_AD_ELIGIBLE

已弃用。请勿使用。
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN 百度：广告素材未获批准。
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW 百度：移动网址正在接受审核。
AD_GROUP_AD_PARTIALLY_INVALID 百度：广告素材在移动设备上无效，但在桌面设备上有效。
AD_GROUP_AD_TO_BE_ACTIVATED 百度：广告素材已可启用。
AD_GROUP_AD_NOT_REVIEWED 百度：广告素材未经过审核。
AD_GROUP_AD_ON_HOLD

已弃用。请勿使用。之前由 Gemini 使用
AD_GROUP_AD_PAUSED 广告素材已暂停。
AD_GROUP_AD_REMOVED 广告素材已被移除。
AD_GROUP_AD_PENDING_REVIEW 广告素材正在等待审核。
AD_GROUP_AD_UNDER_REVIEW 广告素材正在接受审核。
AD_GROUP_AD_APPROVED 广告素材已获批。
AD_GROUP_AD_DISAPPROVED 广告素材已被拒登。
AD_GROUP_AD_SERVING 广告素材正在投放。
AD_GROUP_AD_ACCOUNT_PAUSED 广告素材已被暂停，原因是账号处于暂停状态。
AD_GROUP_AD_CAMPAIGN_PAUSED 由于广告系列处于暂停状态，因此广告素材也处于暂停状态。
AD_GROUP_AD_AD_GROUP_PAUSED 广告素材已暂停，因为广告组处于暂停状态。

AdGroupAdEffectiveLabel

广告组广告与有效标签之间的关系。有效标签是指继承或直接分配给相应广告组广告的标签。

JSON 表示法 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
字段
resourceName

string

广告组广告有效标签的资源名称。广告组广告有效标签资源名称采用以下格式：customers/{ownerCustomerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

有效标签所附加到的广告组广告。
label

string

分配给广告组广告的有效标签。
ownerCustomerId

string (int64 format)

拥有有效标签的客户的 ID。

AdGroupAdLabel

广告组广告与标签之间的关系。

JSON 表示法 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
字段
resourceName

string

广告组广告标签的资源名称。广告组广告标签资源名称采用以下格式：customers/{ownerCustomerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

标签附加到的广告组广告。
label

string

分配给广告组广告的标签。
ownerCustomerId

string (int64 format)

拥有相应标签的客户的 ID。

AdGroupAsset

广告组与素材资源之间的关联。

JSON 表示法 
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
字段
resourceName

string

广告组素材资源的资源名称。AdGroupAsset 资源名称采用以下格式：

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}
adGroup

string

必需。素材资源关联到的广告组。
asset

string

必需。与广告组关联的素材资源。
status

enum (AssetLinkStatus)

广告组素材资源的状态。

AssetLinkStatus

用于描述资产链接状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 已启用资源链接。
REMOVED 已移除素材资源链接。
PAUSED 素材资源链接已暂停。

AdGroupAssetSet

AdGroupAssetSet 是广告组与素材资源组之间的关联。创建 AdGroupAssetSet 会将素材资源集与广告组相关联。

JSON 表示法 
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
字段
resourceName

string

广告组素材资源集的资源名称。广告组素材资源集的资源名称采用以下格式：

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
adGroup

string

相应素材资源集所关联到的广告组。
assetSet

string

与广告组相关联的素材资源集。
status

enum (AssetSetLinkStatus)

广告组素材资源集的状态。只读。

AssetSetLinkStatus

素材资源组与其容器之间关联的可能状态。

枚举
UNSPECIFIED 未指定状态。
UNKNOWN 此版本中未知收到的值。此值为仅限响应的值。
ENABLED 已启用素材资源集与其容器之间的关联。
REMOVED 移除了素材资源集与其容器之间的关联。

AdGroupAudienceView

广告组受众群体视图。包括展示广告网络和 YouTube 广告网络的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 的效果数据，这些数据按受众群体级别汇总。

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

string

广告组受众群体视图的资源名称。广告组受众群体视图资源名称采用以下格式：

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

表示广告组出价调节系数。

JSON 表示法 
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
字段
resourceName

string

广告组出价调节系数的资源名称。广告组出价调节系数资源名称采用以下格式：

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}
bidModifier

number

条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。对于 PreferredContent，该范围介于 1.0 - 6.0 之间。使用 0 可停用设备类型。

联合字段 criterion。相应广告组出价调节系数的标准。

在 V5 中开始的创建操作中是必需的。criterion 只能是下列其中一项：
device

object (DeviceInfo)

设备条件。

DeviceInfo

设备条件。

JSON 表示法 
{
  "type": enum (Device)
}
字段
type

enum (Device)

设备类型。

设备

列出可供定位的 Google Ads 设备。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
MOBILE 配备完善的网络浏览功能的移动设备。
TABLET 配备完善的网络浏览功能的平板电脑。
DESKTOP 计算机。
CONNECTED_TV 智能电视和游戏机。
OTHER 其他设备类型。

AdGroupCriterion

广告组条件。adGroupCriterion 报告仅返回明确添加到广告组中的条件。

JSON 表示法 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
字段
resourceName

string

广告组条件的资源名称。广告组条件资源名称采用以下格式：

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}
creationTime

string

创建此广告组条件时的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。
status

enum (AdGroupCriterionStatus)

条件的状态。

这是广告组条件实体的状态，由客户端设置。注意：界面报告可能包含其他信息，这些信息会影响条件是否能够运行。在某些情况下，在 API 中移除的条件可能仍会在界面中显示为已启用。例如，默认情况下，广告系列会面向所有年龄段的用户展示（已被排除的除外）。该界面会将各个年龄段显示为“已启用”，因为它们有资格观看广告；但 AdGroupCriterion.status 会显示为“已移除”，因为系统未添加任何肯定条件。
qualityInfo

object (QualityInfo)

有关相应条件质量的信息。
type

enum (CriterionType)

条件的类型。
labels[]

string

广告组条件所附标签的资源名称。
effectiveLabels[]

string

附加到相应广告组条件的有效标签的资源名称。有效标签是指继承或直接分配给相应广告组条件的标签。
positionEstimates

object (PositionEstimates)

不同位置的条件出价的估算值。
finalUrls[]

string

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

string

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

object (CustomParameter)

用于替换 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中的自定义参数标记的映射列表。
engineId

string

外部引擎账号中的广告组条件的 ID。此字段仅适用于非 Google Ads 账号，例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体，请改用“adGroupCriterion.criterion_id”。
lastModifiedTime

string

上次修改此广告组条件的日期时间。日期时间采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。
criterionId

string (int64 format)

条件的 ID。
adGroup

string

条件所属的广告组。
negative

boolean

是定位 (false) 还是排除 (true) 条件。

该字段不可更改。 如需将条件从正切换为负，请先移除再重新添加。
bidModifier

number

条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。
cpcBidMicros

string (int64 format)

每次点击费用出价。
effectiveCpcBidMicros

string (int64 format)

有效每次点击费用 (cost-per-click) 出价。
engineStatus

enum (AdGroupCriterionEngineStatus)

广告组条件的引擎状态。
finalUrlSuffix

string

用于将参数附加到最终到达网址的网址模板。
trackingUrlTemplate

string

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

联合字段 criterion。广告组条件。

只能设置一个值。criterion 只能是下列其中一项：
keyword

object (KeywordInfo)

关键字。
listingGroup

object (ListingGroupInfo)

商品详情组。
ageRange

object (AgeRangeInfo)

年龄段。
gender

object (GenderInfo)

性别。
userList

object (UserListInfo)

用户列表。
webpage

object (WebpageInfo)

网页
location

object (LocationInfo)

位置信息。

AdGroupCriterionStatus

AdGroupCriterion 的可能状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
ENABLED 广告组条件已启用。
PAUSED 广告组条件处于暂停状态。
REMOVED 广告组条件已移除。

QualityInfo

用于存放广告组条件质量信息的容器。

JSON 表示法 
{
  "qualityScore": integer
}
字段
qualityScore

integer

质量得分。

如果 Google 没有足够的信息来确定值，则系统可能不会填充该字段。

CriterionType

用于描述可能的目标条件的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
KEYWORD 关键字，例如“火星邮轮”。
PLACEMENT 展示位置（也称为“网站”），例如“www.flowers4sale.com”
MOBILE_APP_CATEGORY 要定位的移动应用类别。
MOBILE_APPLICATION 要定位到的移动应用。
DEVICE 要定位到的设备。
LOCATION 要定位到的地理位置。
LISTING_GROUP 要定位的群组列表。
AD_SCHEDULE 广告投放时间。
AGE_RANGE 年龄段。
GENDER 性别。
INCOME_RANGE 收入范围。
PARENTAL_STATUS 育儿状况。
YOUTUBE_VIDEO YouTube 视频。
YOUTUBE_CHANNEL YouTube 频道。
USER_LIST 用户名单。
PROXIMITY 近程。
TOPIC 展示广告网络上的主题定位（例如“宠物和动物”）。
LISTING_SCOPE 要定位到的商家详情范围。
LANGUAGE 语言。
IP_BLOCK IpBlock。
CONTENT_LABEL 用于类别排除的内容标签。
CARRIER 运营商。
USER_INTEREST 用户感兴趣的类别。
WEBPAGE 动态搜索广告的网页条件。
OPERATING_SYSTEM_VERSION 操作系统版本
APP_PAYMENT_MODEL 应用付费模式。
MOBILE_DEVICE 移动设备。
CUSTOM_AFFINITY 自定义的兴趣相似受众群体。
CUSTOM_INTENT 自定义 intent。
LOCATION_GROUP 营业地点组。
CUSTOM_AUDIENCE 自定义受众群体
COMBINED_AUDIENCE 组合的受众群体
KEYWORD_THEME 智能广告系列关键字主题
AUDIENCE 受众群体
LOCAL_SERVICE_ID 本地生活服务广告服务 ID。
BRAND 品牌
BRAND_LIST 品牌列表
LIFE_EVENT 人生大事

PositionEstimates

不同位置的条件出价的估算值。

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

string (int64 format)

要让广告显示在搜索结果首页顶部所需的每次点击费用出价的估算值。

AdGroupCriterionEngineStatus

枚举 AdGroupCriterion 引擎状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AD_GROUP_CRITERION_ELIGIBLE

已弃用。请勿使用。
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN 百度：出价过低或质量太差，因此无法展示。
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME 百度：由于搜索量较低，百度已将其暂停。
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW 百度：移动网址正在接受审核。
AD_GROUP_CRITERION_PARTIALLY_INVALID 百度：某个设备的着陆页无效，而其他设备的着陆页有效。
AD_GROUP_CRITERION_TO_BE_ACTIVATED 百度：百度账号管理已创建关键字并将其暂停，现在您可以启用该关键字。
AD_GROUP_CRITERION_UNDER_REVIEW 百度：正在等待百度审核。Gemini：条件正在接受审核。
AD_GROUP_CRITERION_NOT_REVIEWED 百度：待审核的条件。
AD_GROUP_CRITERION_ON_HOLD

已弃用。请勿使用。之前由 Gemini 使用
AD_GROUP_CRITERION_PENDING_REVIEW Y!J：条件待审核
AD_GROUP_CRITERION_PAUSED 相应条件已暂停。
AD_GROUP_CRITERION_REMOVED 相应条件已移除。
AD_GROUP_CRITERION_APPROVED 相应条件已获批准。
AD_GROUP_CRITERION_DISAPPROVED 相应条件已被拒批。
AD_GROUP_CRITERION_SERVING 相应条件处于有效状态且正在投放。
AD_GROUP_CRITERION_ACCOUNT_PAUSED 由于账号已暂停，相应条件也已暂停。

CustomParameter

可供 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中的自定义参数标记使用的映射。

JSON 表示法 
{
  "key": string,
  "value": string
}
字段
key

string

与参数代码名称匹配的键。
value

string

要替换的值。

KeywordInfo

关键字条件。

JSON 表示法 
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
字段
matchType

enum (KeywordMatchType)

关键字的匹配类型。
text

string

关键字文本（最多 80 个字符和 10 个字词）。

KeywordMatchType

可能的关键字匹配类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
EXACT 完全匹配。
PHRASE 词组匹配。
BROAD 广泛匹配。

ListingGroupInfo

商品详情组条件。

JSON 表示法 
{
  "type": enum (ListingGroupType)
}
字段
type

enum (ListingGroupType)

商品详情组的类型。

ListingGroupType

相应商品组的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
SUBDIVISION 沿某个商品详情维度细分商品。这些节点不会被用于定位商品详情条目，而仅用于定义树的结构。
UNIT 用于定义出价的商品详情组单元。

AgeRangeInfo

年龄范围条件。

JSON 表示法 
{
  "type": enum (AgeRangeType)
}
字段
type

enum (AgeRangeType)

年龄段的类型。

AgeRangeType

人口统计年龄段范围的类型（例如，18 至 24 岁）。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AGE_RANGE_18_24 年龄介于 18 至 24 岁之间。
AGE_RANGE_25_34 年龄在 25 至 34 岁之间。
AGE_RANGE_35_44 年龄介于 35 至 44 岁之间。
AGE_RANGE_45_54 年龄介于 45 至 54 岁之间。
AGE_RANGE_55_64 年龄介于 55 至 64 岁之间。
AGE_RANGE_65_UP 65 岁及以上。
AGE_RANGE_UNDETERMINED 年龄段未确定。

GenderInfo

性别条件。

JSON 表示法 
{
  "type": enum (GenderType)
}
字段
type

enum (GenderType)

性别的类型。

GenderType

人口统计性别类型（例如女性）。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
MALE 男。
FEMALE 女性。
UNDETERMINED 性别未确定。

UserListInfo

用户名单条件。表示广告客户定义的要定位的用户名单。

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

string

用户名单资源名称。

WebpageInfo

表示用于定位广告客户网站网页的条件。

JSON 表示法 
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
字段
conditions[]

object (WebpageConditionInfo)

网页定位的条件或逻辑表达式。在为定位进行评估时，网页定位条件列表会连接在一起。如果条件列表为空，则表示定位到相应广告系列网站的所有网页。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
coveragePercentage

number

网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如，当覆盖率返回为 1 时，表示覆盖率为 100%。此字段为只读字段。
criterionName

string

相应参数所定义的条件的名称。名称值将用于标识、排序和过滤此类参数的条件。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

WebpageConditionInfo

用于定位广告客户网站网页的逻辑表达式。

JSON 表示法 
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
字段
operand

enum (WebpageConditionOperand)

网页定位条件的运算对象。
operator

enum (WebpageConditionOperator)

网页定位条件的运算符。
argument

string

网页定位条件的实参。

WebpageConditionOperand

网页条件中的网页条件操作数。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
URL 表示网页网址定位条件的运算对象。
CATEGORY 表示网页类别定位条件的运算对象。
PAGE_TITLE 表示网页标题定位条件的运算对象。
PAGE_CONTENT 表示网页内容定位条件的运算对象。
CUSTOM_LABEL 表示网页自定义标签定位条件的运算对象。

WebpageConditionOperator

网页条件中的网页条件运算符。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
EQUALS 实参 Web 条件与比较的 Web 条件相同。
CONTAINS 实参 Web 条件是比较的 Web 条件的一部分。

LocationInfo

位置条件。

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

string

目标地理位置常量资源名称。

AdGroupCriterionEffectiveLabel

广告组条件与有效标签之间的关系。有效标签是指继承或直接分配给相应广告组条件的标签。

JSON 表示法 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
字段
resourceName

string

广告组条件有效标签的资源名称。广告组条件有效标签资源名称采用以下格式：customers/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

有效标签所附加到的广告组条件。
label

string

分配给广告组条件的有效标签。
ownerCustomerId

string (int64 format)

拥有有效标签的客户的 ID。

AdGroupCriterionLabel

广告组条件与标签之间的关系。

JSON 表示法 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
字段
resourceName

string

广告组条件标签的资源名称。广告组条件标签资源名称采用以下格式：customers/{ownerCustomerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

标签附加到的广告组条件。
label

string

分配给广告组条件的标签。
ownerCustomerId

string (int64 format)

拥有相应标签的客户的 ID。

AdGroupEffectiveLabel

广告组与有效标签之间的关系。有效标签是指继承或直接分配给相应广告组的标签。

JSON 表示法 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
字段
resourceName

string

广告组有效标签的资源名称。广告组有效标签资源名称采用以下格式：customers/{ownerCustomerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
adGroup

string

有效标签所附加到的广告组。
label

string

分配给广告组的有效标签。
ownerCustomerId

string (int64 format)

拥有有效标签的客户的 ID。

AdGroupLabel

广告组与标签之间的关系。

JSON 表示法 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
字段
resourceName

string

广告组标签的资源名称。广告组标签资源名称采用以下格式：customers/{ownerCustomerId}/adGroupLabels/{ad_group_id}~{label_id}
adGroup

string

标签附加到的广告组。
label

string

分配给广告组的标签。
ownerCustomerId

string (int64 format)

拥有相应标签的客户的 ID。

AgeRangeView

年龄段视图。

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

string

年龄段视图的资源名称。年龄段视图资源名称采用以下格式：

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

素材资源

素材资源是广告的组成部分，可供多个广告共用。它可以是图片 (ImageAsset)、视频 (YoutubeVideoAsset) 等。素材资源是不可变的，无法移除。如需停止投放某个素材资源，请从使用该素材资源的实体中移除该素材资源。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
字段
resourceName

string

相应素材资源的资源名称。资产资源名称采用以下格式：

customers/{customerId}/assets/{assetId}
type

enum (AssetType)

素材资源的类型。
finalUrls[]

string

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

string

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

object (CustomParameter)

用于替换 trackingUrlTemplate、finalUrls 和/或 finalMobileUrls 中的网址自定义参数标记的映射列表。
status

enum (AssetStatus)

素材资源的状态。
creationTime

string

创建此素材资源时的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。
lastModifiedTime

string

上次修改此素材资源的日期时间。日期时间采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。
id

string (int64 format)

资产的 ID。
name

string

素材资源的选填名称。
trackingUrlTemplate

string

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

string

用于将参数附加到采用并行跟踪机制投放的着陆页网址的网址模板。
engineStatus

enum (AssetEngineStatus)

素材资源的引擎状态。
联合字段 asset_data。资源的具体类型。asset_data 只能是下列其中一项：
youtubeVideoAsset

object (YoutubeVideoAsset)

YouTube 视频素材资源。
imageAsset

object (ImageAsset)

图片素材资源。
textAsset

object (TextAsset)

文字素材资源。
calloutAsset

object (UnifiedCalloutAsset)

统一的宣传信息素材资源。
pageFeedAsset

object (UnifiedPageFeedAsset)

统一的页面 Feed 素材资源。
mobileAppAsset

object (MobileAppAsset)

移动应用素材资源。
callAsset

object (UnifiedCallAsset)

统一的电话素材资源。
callToActionAsset

object (CallToActionAsset)

号召性用语素材资源。
locationAsset

object (UnifiedLocationAsset)

统一的地址素材资源。

资源类型

用于描述可能的素材资源类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
YOUTUBE_VIDEO YouTube 视频素材资源。
MEDIA_BUNDLE 媒体包素材资源。
IMAGE 图片素材资源。
TEXT 文字素材资源。
LEAD_FORM 潜在客户表单素材资源。
BOOK_ON_GOOGLE “在 Google 上预订”素材资源。
PROMOTION 促销信息素材资源。
CALLOUT 宣传信息素材资源。
STRUCTURED_SNIPPET 结构化摘要素材资源。
PAGE_FEED 页面 Feed 素材资源。
DYNAMIC_EDUCATION 动态教育素材资源。
MOBILE_APP 移动应用素材资源。
HOTEL_CALLOUT 酒店宣传信息素材资源。
CALL 电话素材资源。
PRICE 价格素材资源。
CALL_TO_ACTION 号召性用语素材资源。
DYNAMIC_REAL_ESTATE 动态房地产素材资源。
DYNAMIC_CUSTOM 动态自定义素材资源。
DYNAMIC_HOTELS_AND_RENTALS 动态酒店及房屋租赁素材资源。
DYNAMIC_FLIGHTS 动态航班素材资源。
DYNAMIC_TRAVEL 动态旅行素材资源。
DYNAMIC_LOCAL 动态本地素材资源。
DYNAMIC_JOBS 动态职位素材资源。
LOCATION 地址素材资源。
HOTEL_PROPERTY 酒店房源素材资源。

AssetStatus

素材资源可能的状态。

枚举
UNSPECIFIED 未指定状态。
UNKNOWN 此版本中未知收到的值。此值为仅限响应的值。
ENABLED 相应资源已启用。
REMOVED 相应素材资源已被移除。
ARCHIVED 相应素材资源已归档。
PENDING_SYSTEM_GENERATED 相应素材资源是系统生成的，正在等待用户审核。

AssetEngineStatus

用于描述可能的素材资源引擎状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
SERVING 相应资源处于有效状态。
SERVING_LIMITED 相应素材资源处于“有效（受限）”状态。
DISAPPROVED 相应素材资源已被拒登（不符合条件）。
DISABLED 相应资源处于非活跃状态（待处理）。
REMOVED 相应素材资源已被移除。

YoutubeVideoAsset

YouTube 资产。

JSON 表示法 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
字段
youtubeVideoTitle

string

YouTube 视频标题。
youtubeVideoId

string

YouTube 视频 ID。这是 YouTube 视频网址中使用的 11 个字符的字符串值。

ImageAsset

图片素材资源。

JSON 表示法 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
字段
mimeType

enum (MimeType)

图片素材资源的 MIME 类型。
fullSize

object (ImageDimension)

相应图片在原始大小下的元数据。
fileSize

string (int64 format)

图片素材资源的文件大小（以字节为单位）。

MimeType

MIME 类型

枚举
UNSPECIFIED 未指定 MIME 类型。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
IMAGE_JPEG image/jpeg 的 MIME 类型。
IMAGE_GIF 图片/GIF 的 MIME 类型。
IMAGE_PNG image/png 的 MIME 类型。
FLASH application/x-shockwave-flash 的 MIME 类型。
TEXT_HTML text/html 的 MIME 类型。
PDF application/pdf 的 MIME 类型。
MSWORD application/msword 的 MIME 类型。
MSEXCEL application/vnd.ms-excel 的 MIME 类型。
RTF application/rtf 的 MIME 类型。
AUDIO_WAV 音频/wav 的 MIME 类型。
AUDIO_MP3 音频/mp3 的 MIME 类型。
HTML5_AD_ZIP application/x-html5-ad-zip 的 MIME 类型。

ImageDimension

特定尺寸（原始尺寸或调整后的尺寸）的图片的元数据。

JSON 表示法 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
字段
heightPixels

string (int64 format)

图片的高度。
widthPixels

string (int64 format)

图片的宽度。
url

string

返回具有此高度和宽度的图片的网址。

TextAsset

文字素材资源。

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

string

文字素材资源的文本内容。

UnifiedCalloutAsset

统一的宣传信息素材资源。

JSON 表示法 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
字段
calloutText

string

宣传信息文字。此字符串的长度应介于 1 和 25 之间（含 1 和 25）。
startDate

string

相应素材资源生效并可开始投放的开始日期，格式为 yyyy-MM-dd。
endDate

string

相应素材资源生效并仍投放的最后日期，格式为 yyyy-MM-dd。
adScheduleTargets[]

object (AdScheduleInfo)

不重叠的时间安排列表，用于指定相应素材资源可投放的所有时间段。每天最多可有 6 个安排，总共 42 个。
useSearcherTimeZone

boolean

是否以搜索用户的时区显示相应资源。适用于 Microsoft Ads。

AdScheduleInfo

表示 AdSchedule 条件。

AdSchedule 指定为星期几以及广告的展示时段。

同一天最多只能添加 6 个广告投放时间。

JSON 表示法 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
字段
startMinute

enum (MinuteOfHour)

此时间表在开始小时后开始的分钟数。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
endMinute

enum (MinuteOfHour)

相应时间表结束时间的小时数之后的分钟数。相应安排不包含结束分钟。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
dayOfWeek

enum (DayOfWeek)

投放时间是星期几。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
startHour

integer

开始时间（24 小时制）。此字段必须介于 0 和 23 之间（含 0 和 23）。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
endHour

integer

结束小时（采用 24 小时制）；24 表示一天结束。此字段的值必须介于 0 到 24 之间（含边界值）。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

MinuteOfHour

枚举了四分之一小时。例如，“FIFTEEN”

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
ZERO 整点。
FIFTEEN 整点过 15 分钟。
THIRTY 整点过 30 分钟。
FORTY_FIVE 整点过后 45 分钟。

DayOfWeek

枚举周几，例如“星期一”。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
MONDAY 周一。
TUESDAY 星期二。
WEDNESDAY 星期三。
THURSDAY 星期四。
FRIDAY 星期五。
SATURDAY 星期六。
SUNDAY 周日。

UnifiedSitelinkAsset

统一的站内链接素材资源。

JSON 表示法 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
字段
linkText

string

站内链接的网址显示文本。此字符串的长度应介于 1 和 25 之间（含 1 和 25）。
description1

string

站内链接的说明的第一行。如此行已设置，则长度应介于 1 到 35 之间（包括 1 和 35），并且还必须设置 description2。
description2

string

站内链接的说明的第二行。如此行已设置，则长度应介于 1 到 35 之间（包括 1 和 35），并且还必须设置 description1。
startDate

string

相应素材资源生效并可开始投放的开始日期，格式为 yyyy-MM-dd。
endDate

string

相应素材资源生效并仍投放的最后日期，格式为 yyyy-MM-dd。
adScheduleTargets[]

object (AdScheduleInfo)

不重叠的时间安排列表，用于指定相应素材资源可投放的所有时间段。每天最多可有 6 个安排，总共 42 个。
trackingId

string (int64 format)

用于跟踪站内链接素材资源点击情况的 ID。这是 Yahoo! 仅限日本的字段。
useSearcherTimeZone

boolean

是否在搜索用户的时区中显示站内链接素材资源。适用于 Microsoft Ads。
mobilePreferred

boolean

偏好设置是否为在移动设备上展示站内链接素材资源。适用于 Microsoft Ads。

UnifiedPageFeedAsset

统一的页面 Feed 素材资源。

JSON 表示法 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
字段
pageUrl

string

广告客户希望定位到的网页。
labels[]

string

用于对网页网址进行分组的标签。

MobileAppAsset

表示移动应用的资源。

JSON 表示法 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
字段
appId

string

必需。唯一标识移动应用的字符串。它应仅包含平台原生 ID，例如 Android 的“com.android.ebay”或 iOS 的“12345689”。
appStore

enum (MobileAppVendor)

必需。分发相应应用的具体应用商店。

MobileAppVendor

移动应用供应商的类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
APPLE_APP_STORE Apple 应用商店的移动应用供应商。
GOOGLE_APP_STORE Google 应用商店的移动应用供应商。

UnifiedCallAsset

统一的电话素材资源。

JSON 表示法 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
字段
countryCode

string

电话号码的双字母国家/地区代码。示例：'US'、'us'。
phoneNumber

string

广告客户的原始电话号码。示例：“1234567890”“(123)456-7890”
callConversionReportingState

enum (CallConversionReportingState)

表示相应 CallAsset 应使用自己的来电转化设置、遵循账号级设置，还是停用来电转化。
callConversionAction

string

用于归因来电转化的转化操作。如果未设置，则使用默认转化操作。仅当 callConversionReportingState 设置为 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 时，此字段才会生效。
adScheduleTargets[]

object (AdScheduleInfo)

不重叠的时间安排列表，用于指定相应素材资源可投放的所有时间段。每天最多可有 6 个安排，总共 42 个。
callOnly

boolean

来电专用广告是否仅显示电话号码而不显示网站链接。适用于 Microsoft Ads。
callTrackingEnabled

boolean

是否应在来电跟踪中启用相应来电。适用于 Microsoft Ads。
useSearcherTimeZone

boolean

是否在搜索用户的时区显示电话广告附加信息。适用于 Microsoft Ads。
startDate

string

相应素材资源生效并可开始投放的开始日期，格式为 yyyy-MM-dd。
endDate

string

相应素材资源生效并仍投放的最后日期，格式为 yyyy-MM-dd。

CallConversionReportingState

来电转化操作状态的可能数据类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
DISABLED 来电转化操作已停用。
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION 来电转化操作将使用账号级来电转化类型。
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 来电转化操作将使用在资源（来电专用广告/附加电话信息）级设置的来电转化类型。

CallToActionAsset

号召性用语素材资源。

JSON 表示法 
{
  "callToAction": enum (CallToActionType)
}
字段
callToAction

enum (CallToActionType)

号召性用语。

CallToActionType

用于描述可能的号召性用语类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
LEARN_MORE 号召性用语类型为“了解详情”。
GET_QUOTE 号召性用语类型为“获取报价”。
APPLY_NOW 号召性用语类型为“立即申请”。
SIGN_UP 号召性用语类型为“注册”。
CONTACT_US 号召性用语类型为“与我们联系”。
SUBSCRIBE 号召性用语类型为“订阅”。
DOWNLOAD 号召性用语类型为“下载”。
BOOK_NOW 号召性用语类型为“立即预订”。
SHOP_NOW 号召性用语类型为“立即选购”。
BUY_NOW 号召性用语类型为“立即购买”。
DONATE_NOW 号召性用语类型为“立即捐款”。
ORDER_NOW 号召性用语类型为“立即订购”。
PLAY_NOW 号召性用语类型为“立即播放”。
SEE_MORE 号召性用语类型为“查看更多”。
START_NOW 号召性用语类型为“立即开始”。
VISIT_SITE 号召性用语类型为“访问网站”。
WATCH_NOW 号召性用语类型为“立即观看”。

UnifiedLocationAsset

统一的地址素材资源。

JSON 表示法 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
字段
placeId

string

地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。此字段对于给定的客户 ID 和资源类型是唯一的。如需详细了解地点 ID，请访问 https://developers.google.com/places/web-service/place-id。
businessProfileLocations[]

object (BusinessProfileLocation)

客户的营业地点列表。仅当地址素材资源与商家资料账号同步时，才会返回此值。同一账号下可以有多份指向同一地点 ID 的商家资料。
locationOwnershipType

enum (LocationOwnershipType)

地点所有权类型。如果类型为 BUSINESS_OWNER，则会作为附加地址信息展示。如果类型为 AFFILIATE，则会作为关联商户地址提供。

BusinessProfileLocation

从关联的商家资料账号同步的商家资料营业地点数据。

JSON 表示法 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
字段
labels[]

string

广告客户为商家资料账号中的营业地点指定的标签。此信息会从商家资料账号同步。
storeCode

string

相应营业地点的商家资料实体店代码。此信息会从商家资料账号同步。
listingId

string (int64 format)

相应商家资料营业地点的商家详情 ID。此信息会从关联的商家资料账号同步。

LocationOwnershipType

地点所有权的可能类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
BUSINESS_OWNER 营业地点的企业主（旧版附加地址信息 - LE）。
AFFILIATE 关联商户地址（第三方地址信息扩展服务 - ALE）。

AssetGroupAsset

AssetGroupAsset 是素材资源与素材资源组之间的关联。添加 AssetGroupAsset 会将素材资源与素材资源组相关联。

JSON 表示法 
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
字段
resourceName

string

素材资源组素材资源的资源名称。素材资源组素材资源名称采用以下格式：

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}
assetGroup

string

相应素材资源组资产所关联的素材资源组。
asset

string

相应素材资源组中的素材资源所关联的素材资源。
fieldType

enum (AssetFieldType)

素材资源在素材资源组中的展示位置说明。例如：HEADLINE、YOUTUBE_VIDEO 等
status

enum (AssetLinkStatus)

素材资源与素材资源组之间关联的状态。

AssetFieldType

用于描述素材资源的可能展示位置的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
HEADLINE 素材资源已关联，可作为广告标题使用。
DESCRIPTION 素材资源已关联，可用于作为广告内容描述。
MANDATORY_AD_TEXT 相应素材资源已关联，可作为必填广告文字使用。
MARKETING_IMAGE 素材资源已关联，可用于作为营销图片。
MEDIA_BUNDLE 素材资源已关联，可作为媒体包使用。
YOUTUBE_VIDEO 该资产已关联，可作为 YouTube 视频使用。
BOOK_ON_GOOGLE 关联素材资源是为了表明酒店广告系列已启用“在 Google 上预订”功能。
LEAD_FORM 相应素材资源已关联，可作为附加潜在客户表单使用。
PROMOTION 相应素材资源已关联，可用于促销信息附加信息。
CALLOUT 相应素材资源已关联，可作为附加宣传信息使用。
STRUCTURED_SNIPPET 相应素材资源已关联，可作为附加结构化摘要信息使用。
MOBILE_APP 相应素材资源已关联，可作为附加移动应用信息使用。
HOTEL_CALLOUT 相应素材资源已关联，可作为酒店附加宣传信息使用。
CALL 相应素材资源已关联，可作为附加电话信息使用。
PRICE 素材资源已关联，可作为附加价格信息使用。
LONG_HEADLINE 关联的素材资源用作长标题。
BUSINESS_NAME 素材资源已关联，可用于作为商家名称。
SQUARE_MARKETING_IMAGE 素材资源已关联，可作为方形营销图片使用。
PORTRAIT_MARKETING_IMAGE 素材资源已关联，可用于纵向营销图片。
VIDEO 相应素材资源已关联，可作为非 YouTube 徽标使用。
CALL_TO_ACTION_SELECTION 该素材资源已关联，可用于选择号召性用语。
AD_IMAGE 该素材资源已关联，可用于选择广告图片。
HOTEL_PROPERTY 该素材资源已关联，可作为酒店房源用于指定旅行目标的效果最大化广告系列。
LONG_DESCRIPTION 关联素材资源以用作长广告内容描述。
CALL_TO_ACTION 该素材资源已关联，可作为号召性用语使用。

AssetGroupSignal

AssetGroupSignal 表示素材资源组中的信号。信号的存在会告知效果最大化广告系列哪些用户最有可能完成转化。效果最大化广告系列会参考信号，寻找意向相似或更强烈的新用户，以在搜索网络、展示广告网络、视频平台等位置促成转化。

JSON 表示法 
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
字段
resourceName

string

素材资源组信号的资源名称。素材资源组信号资源名称采用以下格式：

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}
assetGroup

string

相应素材资源组信号所属的素材资源组。
联合字段 signal。素材资源组的信号。signal 只能是下列其中一项：
audience

object (AudienceInfo)

效果最大化广告系列要使用的受众群体信号。

AudienceInfo

受众群体条件。

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

string

受众群体资源名称。

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter 表示素材资源组中的产品信息组过滤条件树节点。

JSON 表示法 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
字段
resourceName

string

素材资源组产品信息组过滤条件的资源名称。素材资源组产品信息组过滤条件资源名称采用以下格式：

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

相应素材资源组产品信息组过滤条件所属的素材资源组。
id

string (int64 format)

ListingGroupFilter 的 ID。
type

enum (ListingGroupFilterType)

商品详情组过滤条件节点的类型。
vertical

enum (ListingGroupFilterVertical)

当前节点树所代表的垂直行业。同一树中的所有节点都必须属于同一垂直行业。
caseValue

object (ListingGroupFilterDimension)

相应商品详情组用于细化其父级的维度值。对于根组，此值为未定义。
parentListingGroupFilter

string

父级商品详情组细分的资源名称。对于根商品详情组过滤条件节点，此值为 null。
path

object (ListingGroupFilterDimensionPath)

定义相应商品详情组过滤条件的维度的路径。

ListingGroupFilterType

商品详情组过滤条件的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
SUBDIVISION 沿某些商品详情维度细分商品。
UNIT_INCLUDED 一个包含的产品信息组过滤条件叶节点。
UNIT_EXCLUDED 已排除的产品信息组过滤条件叶节点。

ListingGroupFilterVertical

相应商品详情组过滤条件的行业类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
SHOPPING 表示购物行业。此垂直行业仅适用于面向零售行业的效果最大化广告系列。

ListingGroupFilterDimension

素材资源组产品信息组过滤条件的商品详情维度。

JSON 表示法 
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
字段
联合字段 dimension。始终存在以下类型之一的维度。dimension 只能是下列其中一项：
productBiddingCategory

object (ProductBiddingCategory)

商品优惠的出价类别。
productBrand

object (ProductBrand)

商品优惠的品牌。
productChannel

object (ProductChannel)

商品优惠的适用地区。
productCondition

object (ProductCondition)

商品优惠的条件。
productCustomAttribute

object (ProductCustomAttribute)

商品优惠的自定义属性。
productItemId

object (ProductItemId)

商品优惠的商品 ID。
productType

object (ProductType)

商品优惠的类型。

ProductBiddingCategory

特定级别的出价类别的一个元素。顶层类别的级别为 1，其子类别的级别为 2，以此类推。目前，我们最多支持 5 个级别。用户必须指定一个维度类型，以指明类别的级别。同一细分的所有情形都必须具有相同的维度类型（类别级）。

JSON 表示法 
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
字段
level

enum (ListingGroupFilterBiddingCategoryLevel)

表示类目在分类中的级别。
id

string (int64 format)

商品出价类别的 ID。

此 ID 等同于此文章中所述的 google_product_category ID：https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

相应商品信息组过滤条件出价类别的级别。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
LEVEL1 1 级。
LEVEL2 2 级。
LEVEL3 3 级。
LEVEL4 4 级。
LEVEL5 第 5 级。

ProductBrand

商品的品牌。

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

string

商品品牌的字符串值。

ProductChannel

商品优惠的适用地区。

JSON 表示法 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
字段
channel

enum (ListingGroupFilterProductChannel)

相应地区的价值。

ListingGroupFilterProductChannel

用于描述商品优惠的本地化设置的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ONLINE 商品在线销售。
LOCAL 商品在本地商店中销售。

ProductCondition

商品优惠的条件。

JSON 表示法 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
字段
condition

enum (ListingGroupFilterProductCondition)

条件的值。

ListingGroupFilterProductCondition

用于描述商品优惠状况的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NEW 商品是全新商品。
REFURBISHED 商品状况为翻新。
USED 商品状况为二手。

ProductCustomAttribute

商品优惠的自定义属性。

JSON 表示法 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
字段
index

enum (ListingGroupFilterCustomAttributeIndex)

表示自定义属性的索引。
value

string

商品自定义属性的字符串值。

ListingGroupFilterCustomAttributeIndex

客户属性的索引。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
INDEX0 第一个产品信息组过滤条件自定义属性。
INDEX1 第二个产品信息组过滤条件自定义属性。
INDEX2 第三个产品信息组过滤条件自定义属性。
INDEX3 第四个商品详情组过滤条件自定义属性。
INDEX4 第五个产品信息组过滤条件自定义属性。

ProductItemId

商品优惠的商品 ID。

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

string

相应 ID 的值。

ProductType

商品优惠的类型。

JSON 表示法 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
字段
level

enum (ListingGroupFilterProductTypeLevel)

类型的级别。
value

string

相应类型的值。

ListingGroupFilterProductTypeLevel

枚举，用于描述商品优惠类型的级别。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
LEVEL1 1 级。
LEVEL2 2 级。
LEVEL3 3 级。
LEVEL4 4 级。
LEVEL5 第 5 级。

ListingGroupFilterDimensionPath

用于定义商品详情组过滤条件的维度路径。

JSON 表示法 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
字段
dimensions[]

object (ListingGroupFilterDimension)

从商品详情组过滤条件层次结构（不包括根节点）到相应商品详情组过滤条件的维度的完整路径。

AssetGroupTopCombinationView

显示素材资源组素材资源效果最佳的组合的使用情况。

JSON 表示法 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
字段
resourceName

string

素材资源组热门组合视图的资源名称。AssetGroup Top Combination 视图资源名称采用以下格式：“customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}”
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

一起投放的素材资源组合中效果最佳的组合。

AssetGroupAssetCombinationData

素材资源组素材资源组合数据

JSON 表示法 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
字段
assetCombinationServedAssets[]

object (AssetUsage)

投放的素材资源。

AssetUsage

包含相应素材资源的用量信息。

JSON 表示法 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
字段
asset

string

相应素材资源的资源名称。
servedAssetFieldType

enum (ServedAssetFieldType)

相应素材资源的投放字段类型。

ServedAssetFieldType

可能的素材资源字段类型。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
HEADLINE_1 相应素材资源已在标题 1 中使用。
HEADLINE_2 相应素材资源已在标题 2 中使用。
HEADLINE_3 相应素材资源已在标题 3 中使用。
DESCRIPTION_1 相应素材资源用于广告内容描述 1。
DESCRIPTION_2 相应素材资源用于广告内容描述 2。
HEADLINE 相应素材资源曾用于标题。仅当广告中只有一个标题时才使用此属性。否则，请使用 HEADLINE_1、HEADLINE_2 或 HEADLINE_3 枚举
HEADLINE_IN_PORTRAIT 相应素材资源曾用作纵向图片中的标题。
LONG_HEADLINE 相应素材资源曾用于长标题（用于 MultiAssetResponsiveAd）。
DESCRIPTION 相应素材资源曾用于广告内容描述。仅当广告中只有一条广告内容描述时才使用此属性。否则，请使用 DESCRIPTION_1 或 DESCRIPTION_@ 枚举
DESCRIPTION_IN_PORTRAIT 相应素材资源曾用作纵向图片的描述。
BUSINESS_NAME_IN_PORTRAIT 相应素材资源已用作纵向图片中的商家名称。
BUSINESS_NAME 相应素材资源曾用作商家名称。
MARKETING_IMAGE 相应素材资源曾用作营销图片。
MARKETING_IMAGE_IN_PORTRAIT 相应素材资源曾用作纵向营销图片。
SQUARE_MARKETING_IMAGE 相应素材资源用作方形营销图片。
PORTRAIT_MARKETING_IMAGE 相应素材资源用作纵向营销图片。
CALL_TO_ACTION 相应素材资源用作号召性用语。
YOU_TUBE_VIDEO 相应资产曾用作 YouTube 视频。
CALL 相应素材资源用作电话。
MOBILE_APP 相应资源用作移动应用。
CALLOUT 此素材资源用作宣传信息。
STRUCTURED_SNIPPET 相应素材资源用作结构化摘要。
PRICE 相应素材资源用作价格。
PROMOTION 相应素材资源用作促销信息。
AD_IMAGE 此素材资源用作图片。
LEAD_FORM 相应素材资源用作潜在客户表单。
DESCRIPTION_PREFIX 相应素材资源用作说明前缀。

AssetGroup

素材资源组。AssetGroupAsset 用于将素材资源与素材资源组相关联。AssetGroupSignal 用于将信号与素材资源组相关联。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
字段
resourceName

string

素材资源组的资源名称。素材资源组资源名称采用以下格式：

customers/{customerId}/assetGroups/{asset_group_id}
id

string (int64 format)

素材资源组的 ID。
campaign

string

相应素材资源组关联到的广告系列。与素材资源组相关联的素材资源。
name

string

必需。素材资源组的名称。必需。长度不得少于 1 个字符，不得超过 128 个字符。在广告系列中必须是唯一的。
finalUrls[]

string

所有跨网域重定向之后的最终到达网址列表。在效果最大化广告系列中，除非选择停用，否则网址默认符合扩展条件。
finalMobileUrls[]

string

所有跨网域重定向之后的最终到达移动网址列表。在效果最大化广告系列中，除非选择停用，否则网址默认符合扩展条件。
status

enum (AssetGroupStatus)

素材资源组的状态。
path1

string

可能显示的文字的第一部分（附加到广告中展示的网址）。
path2

string

可能显示的文字的第二部分（附加到广告中展示的网址）。仅当设置了 path1 时才能设置此字段。
adStrength

enum (AdStrength)

相应素材资源组的整体广告效力。

AssetGroupStatus

素材资源组可能的状态。

枚举
UNSPECIFIED 未指定状态。
UNKNOWN 此版本中未知收到的值。
ENABLED 素材资源组已启用。
PAUSED 相应素材资源组已暂停。
REMOVED 素材资源组已移除。

AdStrength

列出可能广告效力的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
PENDING 广告效力目前处于“待定”状态。
NO_ADS 无法生成广告。
POOR 强度较差。
AVERAGE 平均强度。
GOOD 力量不错。
EXCELLENT 出色的强度。

AssetSetAsset

AssetSetAsset 是素材资源与素材资源集之间的关联。添加 AssetSetAsset 会将素材资源与素材资源集相关联。

JSON 表示法 
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
字段
resourceName

string

资源集资产的资源名称。资产集资产资源名称采用以下格式：

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}
assetSet

string

此素材资源集中的素材资源所关联的素材资源集。
asset

string

此素材资源集中的素材资源所关联的素材资源。
status

enum (AssetSetAssetStatus)

素材资源组的素材资源的状态。只读。

AssetSetAssetStatus

素材资源组的素材资源的可能状态。

枚举
UNSPECIFIED 未指定状态。
UNKNOWN 此版本中未知收到的值。此值为仅限响应的值。
ENABLED 素材资源组的素材资源已启用。
REMOVED 移除了素材资源集中的素材资源。

AssetSet

表示一组素材资源的素材资源组。使用 AssetSetAsset 将素材资源与素材资源组相关联。

JSON 表示法 
{
  "id": string,
  "resourceName": string
}
字段
id

string (int64 format)

素材资源组的 ID。
resourceName

string

资源组的资源名称。资产集的资源名称采用以下格式：

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

出价策略。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
字段
resourceName

string

出价策略的资源名称。出价策略资源名称采用以下格式：

customers/{customerId}/biddingStrategies/{bidding_strategy_id}
status

enum (BiddingStrategyStatus)

出价策略的状态。

此字段为只读字段。
type

enum (BiddingStrategyType)

出价策略的类型。通过设置出价方案创建出价策略。

此字段为只读字段。
currencyCode

string

出价策略所用的币种（ISO 4217 三字母代码）。

对于经理客户中的出价策略，此币种可在创建时设置，默认设置为经理客户的币种。对于投放广告的客户，此字段无法设置；投放广告的客户中的所有策略都会隐式使用投放广告的客户的币种。在所有情况下，effectiveCurrencyCode 字段都会返回相应策略所用的币种。
id

string (int64 format)

出价策略的 ID。
name

string

出价策略的名称。账号中的所有出价策略必须区分命名。

此字符串的长度应介于 1 到 255 之间（包括 1 和 255），以 UTF-8 字节为单位（经过修剪）。
effectiveCurrencyCode

string

出价策略所用的币种（ISO 4217 三字母代码）。

对于经理客户中的出价策略，这是广告客户在创建策略时设置的币种。对于服务客户，这是客户的 currencyCode。

出价策略指标以相应币种报告。

此字段为只读字段。
campaignCount

string (int64 format)

附加到相应出价策略的广告系列数量。

此字段为只读字段。
nonRemovedCampaignCount

string (int64 format)

附加到出价策略的未移除广告系列的数量。

此字段为只读字段。

联合字段 scheme。出价方案。

只能设置一个。scheme 只能是下列其中一项：
enhancedCpc

object (EnhancedCpc)

一种出价策略，可针对更有可能促成转化的点击提高出价，并针对不太可能促成转化的点击降低出价。
maximizeConversionValue

object (MaximizeConversionValue)

一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能高的转化价值。
maximizeConversions

object (MaximizeConversions)

一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能多的转化。
targetCpa

object (TargetCpa)

一种出价策略，可设置出价，在将每次转化费用控制在您设定的目标水平的前提下，帮助您争取尽可能多的转化。
targetImpressionShare

object (TargetImpressionShare)

一种自动出价策略，可自动优化以实现所选的展示百分比。
targetOutrankShare

object (TargetOutrankShare)

一种出价策略，可根据广告客户应在多少百分比的竞价中胜过特定竞争对手来设置出价。该字段已弃用。使用此字段创建新的出价策略或将使用此字段的出价策略附加到广告系列的操作将失败。允许对已填充此方案的策略进行变异。
targetRoas

object (TargetRoas)

一种出价策略，可帮助您在达到特定目标广告支出回报率 (ROAS) 平均值的同时，尽可能提高收入。
targetSpend

object (TargetSpend)

一种出价策略，使用该策略，系统会自动为您设置适当的出价，确保在不超出预算的前提下为您争取尽可能多的点击。

BiddingStrategyStatus

BiddingStrategy 的可能状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
ENABLED 出价策略已启用。
REMOVED 出价策略已移除。

BiddingStrategyType

枚举，用于描述可能的出价策略类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
COMMISSION “佣金”是一种自动出价策略，采用此策略时，广告客户需支付转化价值的一定比例作为费用。
ENHANCED_CPC 智能点击付费是一种出价策略，它会针对更有可能促成转化的点击提高出价，并针对不太可能促成转化的点击降低出价。
INVALID 仅用于返回值。表示广告系列没有出价策略。这会阻止广告系列投放。例如，某个广告系列可能与经理账号出价策略相关联，但随后广告投放账号与经理账号解除关联。在这种情况下，广告系列将自动与现在无法访问的经理账号出价策略分离，并改用 INVALID 出价策略类型。
MANUAL_CPA 一种人工出价策略，可让广告客户为广告客户指定的操作设置出价。
MANUAL_CPC 基于点击的人工出价，此类出价中用户按点击次数付费。
MANUAL_CPM 基于人工展示的出价，用户按每千次展示付费。
MANUAL_CPV 一种出价策略，可按每次视频观看支付可配置的金额。
MAXIMIZE_CONVERSIONS 一种出价策略，可在不超出每日预算的前提下自动争取尽可能多的转化次数。
MAXIMIZE_CONVERSION_VALUE 这是一种自动出价策略，可以自动设置出价，以便在您的预算范围内尽可能提高收入。
PAGE_ONE_PROMOTED “首页热推”出价方案，用于设置最高每次点击费用出价，以争取在 google.com 的首页或首页热推广告位上展示广告。此枚举值已弃用。
PERCENT_CPC “按百分比付费”出价策略是指，出价是部分商品或服务的广告价格的一小部分。
TARGET_CPA “目标每次转化费用”是一种自动出价策略，可为您设置合适的出价，在不超出您设置的目标每次转化费用 (CPA) 的前提下，帮您获得尽可能多的转化。
TARGET_CPM “目标每千次展示费用”是一种自动出价策略，可为您设置合适的出价，在不超出您设置的目标每千次展示费用 (CPM) 的前提下，帮您获得尽可能多的展示。
TARGET_IMPRESSION_SHARE 一种自动出价策略，可设置出价，使一定百分比的搜索广告展示在首页顶部（或其他目标位置）。
TARGET_OUTRANK_SHARE “排名胜出率目标”是一种自动出价策略，它会根据广告客户应在多少百分比的竞价中胜过特定竞争对手来设置出价。此枚举值已弃用。
TARGET_ROAS “目标广告支出回报率”是一种自动出价策略，可帮助您在达到特定平均广告支出回报率 (ROAS) 的前提下，尽可能提高收入。
TARGET_SPEND “目标支出”是一种自动出价策略，使用该策略，系统会自动为您设置适当的出价，确保在不超出预算的前提下为您争取尽可能多的点击。

EnhancedCpc

此类型没有字段。

这种自动出价策略会提高更有可能促成转化的点击的出价，并降低不太可能促成转化的点击的出价。

此出价策略已被弃用，无法再创建。使用 ManualCpc 并将 enhancedCpcEnabled 设置为 true，即可实现相同的功能。

MaximizeConversionValue

一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能高的转化价值。

JSON 表示法 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
字段
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略。
cpcBidFloorMicros

string (int64 format)

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略。
targetRoas

number

目标广告支出回报率 (ROAS) 选项。如果设置此选项，出价策略会最大限度地增加收入，同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高，则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率，则出价策略的目标是尽可能为预算实现最高的广告支出回报率。

MaximizeConversions

一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能多的转化。

JSON 表示法 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
字段
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略。
cpcBidFloorMicros

string (int64 format)

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 仅适用于组合出价策略。
targetCpaMicros

string (int64 format)

“目标每次转化费用 (CPA)”选项。这是您希望为每次转化操作支付的平均金额，以出价策略所用币种的微单位表示。如果设置了此出价策略，系统会在不超出目标每次转化费用的前提下，尽可能争取更多转化。如果未设置目标每次转化费用，则出价策略的目标是尽可能为预算实现最低的每次转化费用。

TargetCpa

一种自动出价策略，可通过设置出价来帮助您达成所设置的目标每次转化费用，同时争取尽可能多的转化。

JSON 表示法 
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
字段
targetCpaMicros

string (int64 format)

平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。
cpcBidFloorMicros

string (int64 format)

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。

TargetImpressionShare

一种自动出价策略，可设置出价，使一定百分比的搜索广告展示在首页顶部（或其他目标位置）。

JSON 表示法 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
字段
location

enum (TargetImpressionShareLocation)

搜索结果页上的目标位置。
locationFractionMicros

string (int64 format)

要在定位到的地理位置展示的广告所占的比例（以微为单位）。例如，1% 等于 10,000。
cpcBidCeilingMicros

string (int64 format)

自动出价系统可以指定的最高每次点击费用出价。这是由广告客户输入的必填字段，该字段用于设置上限值，并以本地微单位指定。

TargetImpressionShareLocation

用于描述可能的目标的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ANYWHERE_ON_PAGE 网页上的任何位置。
TOP_OF_PAGE 顶部广告框。
ABSOLUTE_TOP_OF_PAGE 顶部广告框中的顶部广告位。

TargetOutrankShare

一种自动出价策略，可根据广告客户应在多少百分比的竞价中胜过特定竞争对手来设置出价。此策略已被弃用。

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

string (Int64Value format)

可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

TargetRoas

一种自动出价策略，可帮助您在达到特定目标广告支出回报率 (ROAS) 平均值的同时，尽可能提高收入。

JSON 表示法 
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
字段
targetRoas

number

必需。每单位支出所选择的收入（基于转化数据）。值必须介于 0.01 到 1000.0 之间（包括 0.01 和 1000.0）。
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。
cpcBidFloorMicros

string (int64 format)

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。

TargetSpend

这是一种自动出价策略，使用该策略，系统会为您设置适当的出价，确保在不超出预算的前提下为您争取尽可能多的点击。

JSON 表示法 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
字段
targetSpendMicros
(deprecated)

string (int64 format)

已弃用：尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定，则预算会被用作支出目标。 此字段已弃用，不应再使用。如需了解详情，请访问 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

CampaignBudget

广告系列预算。

JSON 表示法 
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
字段
resourceName

string

广告系列预算的资源名称。广告系列预算资源名称采用以下格式：

customers/{customerId}/campaignBudgets/{campaign_budget_id}
deliveryMethod

enum (BudgetDeliveryMethod)

确定广告系列预算的支出速率的投放方式。

如果在创建操作中未指定，则默认为 STANDARD。
period

enum (BudgetPeriod)

支出预算的时间段。如果未指定，则默认为 DAILY。
amountMicros

string (int64 format)

预算的金额，以账号的本地货币为单位。金额以微单位指定，即一百万等同于一个货币单位。每月支出上限为该金额的 30.4 倍。

BudgetDeliveryMethod

预算的可能投放方式。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
STANDARD 预算服务器将在整个时间段内平均地调节投放。
ACCELERATED 预算服务器不会限制投放，广告会尽可能快地投放。

BudgetPeriod

预算的可能期限。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
DAILY 每日预算。
FIXED_DAILY 固定每日预算。
CUSTOM_PERIOD 自定义预算可与 total_amount 搭配使用，以指定整个生命周期的预算上限。

广告系列

广告系列。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
字段
resourceName

string

相应广告系列的资源名称。广告系列资源名称采用以下格式：

customers/{customerId}/campaigns/{campaign_id}
status

enum (CampaignStatus)

广告系列的状态。

添加新的广告系列时，状态默认为 ENABLED。
servingStatus

enum (CampaignServingStatus)

广告系列的广告投放状态。
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

广告系列出价策略的系统状态。
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

广告系列的广告投放优化状态。
advertisingChannelType

enum (AdvertisingChannelType)

广告系列中的广告的主要投放目标。可以在 networkSettings 中优化定位选项。

此字段为必填字段，在创建新广告系列时不应为空。

只能在创建广告系列时设置。创建广告系列后，此字段便无法更改。
advertisingChannelSubType

enum (AdvertisingChannelSubType)

对 advertisingChannelType 的可选优化。必须是父级渠道类型的有效子类型。

只能在创建广告系列时设置。创建广告系列后，此字段便无法更改。
urlCustomParameters[]

object (CustomParameter)

用于替换 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中的自定义参数标记的映射列表。
realTimeBiddingSetting

object (RealTimeBiddingSetting)

实时出价的设置，此功能仅适用于定位到 Ad Exchange 广告资源的广告系列。
networkSettings

object (NetworkSettings)

相应广告系列的投放网络设置。
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

用于控制动态搜索广告 (DSA) 的设置。
shoppingSetting

object (ShoppingSetting)

用于控制购物广告系列的设置。
geoTargetTypeSetting

object (GeoTargetTypeSetting)

广告地理位置定位的设置。
effectiveLabels[]

string

附加到相应广告系列的有效标签的资源名称。有效标签是指继承或直接分配给相应广告系列的标签。
labels[]

string

此广告系列所附标签的资源名称。
biddingStrategyType

enum (BiddingStrategyType)

出价策略的类型。

您可以通过以下方式创建出价策略：设置出价方案来创建标准出价策略，或设置 biddingStrategy 字段来创建组合出价策略。

此字段为只读字段。
accessibleBiddingStrategy

string

AccessibleBiddingStrategy 的资源名称，这是附加的组合出价策略（由“biddingStrategy”标识）的无限制属性的只读视图。如果广告系列未使用组合策略，则为空。不受限制的策略属性可供共享相应策略的所有客户使用，并且可从 AccessibleBiddingStrategy 资源中读取。相比之下，受限属性仅适用于出价策略的所有者客户及其经理。只能从 BiddingStrategy 资源中读取受限属性。
frequencyCaps[]

object (FrequencyCapEntry)

用于限制每个用户看到相应广告系列广告的频次的名单。
selectiveOptimization

object (SelectiveOptimization)

相应广告系列的选择性优化设置，其中包括一组转化操作，用于指导广告系列优化方向。此功能仅适用于将 MULTI_CHANNEL 用作 AdvertisingChannelType 且将 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 用作 AdvertisingChannelSubType 的应用广告系列。
optimizationGoalSetting

object (OptimizationGoalSetting)

相应广告系列的优化目标设置，包括一组优化目标类型。
trackingSetting

object (TrackingSetting)

用于跟踪信息的广告系列级设置。
engineId

string

外部引擎账号中的广告系列的 ID。此字段仅适用于非 Google Ads 账号，例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体，请改用“campaign.id”。
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

应从此广告系列中排除的素材资源字段类型。具有这些字段类型的素材资源链接不会由此广告系列从更高级别继承。
createTime

string

创建广告系列时的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。createTime 将在 v1 中被弃用。请改用 creationTime。
creationTime

string

创建广告系列时的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。
lastModifiedTime

string

上次修改此广告系列的日期时间。日期时间采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。
feedTypes[]

enum (AssetSetType)

直接附加到相应广告系列的 Feed 类型。
id

string (int64 format)

广告系列的 ID。
name

string

广告系列的名称。

此字段为必填字段，在创建新广告系列时不应为空。

并且不得包含任何 null（码位 0x0）、NL 换行符（码位 0xA）或回车符（码位 0xD）。
trackingUrlTemplate

string

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

string

相应广告系列的广告系列预算的资源名称。
startDate

string

广告系列在提供服务的客户所在时区开始运行的日期（采用 YYYY-MM-DD 格式）。
endDate

string

广告系列在提供服务的客户所在时区运行的最后一天（采用 YYYY-MM-DD 格式）。创建时，默认为 2037-12-30，这表示广告系列将无限期投放。要将现有的广告系列设置为无限期投放，请将此字段设置为 2037-12-30。
finalUrlSuffix

string

用于将查询参数附加到通过并行跟踪投放的着陆页的后缀。
urlExpansionOptOut

boolean

表示选择停用网址扩展功能，以定位到更具针对性的网址。如果选择停用（true），则仅定位到素材资源组中的最终到达网址或广告客户的 Google Merchant Center 或商家数据 Feed 中指定的网址。如果选择启用（false），则定位整个网域。此字段只能针对效果最大化广告系列进行设置，其默认值为 false。

联合字段 campaign_bidding_strategy。相应广告系列的竞价策略。

必须是组合出价策略（通过 BiddingStrategy 服务创建）或嵌入到广告系列中的标准出价策略。campaign_bidding_strategy 只能是下列其中一项：
biddingStrategy

string

相应广告系列所用组合出价策略的资源名称。
manualCpa

object (ManualCpa)

标准“每次转化费用人工出价”出价策略。一种人工出价策略，可让广告客户为广告客户指定的操作设置出价。仅支持本地生活服务广告系列。
manualCpc

object (ManualCpc)

标准“每次点击费用人工出价”出价策略。基于点击的手动出价，用户按每次点击付费。
manualCpm

object (ManualCpm)

标准“每千次展示费用人工出价”出价策略。人工出价，按展示次数付费，用户为每千次展示付费。
maximizeConversions

object (MaximizeConversions)

标准“尽可能提高转化次数”出价策略，可在不超出预算的前提下自动争取尽可能多的转化次数。
maximizeConversionValue

object (MaximizeConversionValue)

标准“尽可能提高转化价值”出价策略，可自动设置出价，以便在您的预算范围内，帮助您争取尽可能高的收入。
targetCpa

object (TargetCpa)

标准“目标每次转化费用”出价策略，可自动设置出价，在不超出您设置的目标每次转化费用 (CPA) 的前提下，帮您获得尽可能多的转化。
targetImpressionShare

object (TargetImpressionShare)

“目标展示次数份额”出价策略。一种自动出价策略，可设置出价以实现所选的展示次数百分比。
targetRoas

object (TargetRoas)

标准“目标广告支出回报率”出价策略，可自动最大限度地提高收入，同时确保达到特定的平均目标广告支出回报率 (ROAS)。
targetSpend

object (TargetSpend)

一种标准的目标支出出价策略，使用该策略，系统会自动为您设置适当的出价，确保在不超出预算的前提下为您争取尽可能多的点击。
percentCpc

object (PercentCpc)

标准“百分比形式的每次点击费用”出价策略，其中出价是部分商品或服务的广告价格的一小部分。
targetCpm

object (TargetCpm)

一种自动优化每千次展示费用的出价策略。

CampaignStatus

广告系列可能的状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 广告系列处于有效状态，可以展示广告。
PAUSED 用户已暂停广告系列。
REMOVED 广告系列已移除。

CampaignServingStatus

广告系列可能所处的投放状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
SERVING 提供服务。
NONE 无。
ENDED 已结束。
PENDING Pending.
SUSPENDED 已暂停。

BiddingStrategySystemStatus

BiddingStrategy 可能的系统状态。

枚举
UNSPECIFIED 表示发生了意外错误，例如未找到出价策略类型或未找到状态信息。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 该出价策略有效，AdWords没有发现该策略存在任何问题。
LEARNING_NEW 出价策略正在学习，因为它是最近创建或重新启用的。
LEARNING_SETTING_CHANGE 由于最近更改了设置，出价策略正在学习。
LEARNING_BUDGET_CHANGE 由于预算近期发生了更改，出价策略正在学习。
LEARNING_COMPOSITION_CHANGE 由于与出价策略相关联的广告系列、广告组或关键字的数量近期发生了变化，因此出价策略正在学习。
LEARNING_CONVERSION_TYPE_CHANGE 出价策略依赖于转化报告，而客户最近修改了与出价策略相关的转化类型。
LEARNING_CONVERSION_SETTING_CHANGE 出价策略取决于转化报告，而客户最近更改了转化设置。
LIMITED_BY_CPC_BID_CEILING 出价策略受出价上限限制。
LIMITED_BY_CPC_BID_FLOOR 出价策略受出价下限限制。
LIMITED_BY_DATA 由于过去几周的转化流量不足，出价策略受到限制。
LIMITED_BY_BUDGET 此出价策略中的很大一部分关键字都受到预算的限制。
LIMITED_BY_LOW_PRIORITY_SPEND 由于支出优先级降低，出价策略无法达到目标支出。
LIMITED_BY_LOW_QUALITY 此出价策略中的很大一部分关键字的质量得分较低。
LIMITED_BY_INVENTORY 由于定位范围过窄，出价策略无法充分利用预算。
MISCONFIGURED_ZERO_ELIGIBILITY 缺少智能购物广告系列的转化跟踪（没有 ping）和/或再营销名单。
MISCONFIGURED_CONVERSION_TYPES 出价策略取决于转化报告，但客户缺少可根据此策略报告的转化类型。
MISCONFIGURED_CONVERSION_SETTINGS 出价策略依赖于转化报告，但客户的转化设置配置有误。
MISCONFIGURED_SHARED_BUDGET 有些广告系列不在出价策略中，但与纳入该策略的广告系列共享预算。
MISCONFIGURED_STRATEGY_TYPE 相应广告系列的策略类型无效，因此未投放。
PAUSED 出价策略未启用。要么是没有任何有效的广告系列、广告组或关键字与出价策略相关联。或者没有与出价策略相关联的有效预算。
UNAVAILABLE 此出价策略目前不支持状态报告。
MULTIPLE_LEARNING 在相关时间段内，此出价策略存在多个 LEARNING_* 系统状态。
MULTIPLE_LIMITED 在相关时间段内，此出价策略存在多个 LIMITED_* 系统状态。
MULTIPLE_MISCONFIGURED 在相关时间段内，此出价策略存在多个 MISCONFIGURED_* 系统状态。
MULTIPLE 在相关时间段内，此出价策略存在多种系统状态。

AdServingOptimizationStatus

用于描述可能投放状态的枚举。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
OPTIMIZE 系统会根据广告系列的点击率优化广告投放。
CONVERSION_OPTIMIZE 系统会根据广告系列的点击率 * 转化次数来优化广告投放。如果广告系列未采用转化优化工具出价策略，则默认采用“优化”设置。
ROTATE 在 90 天内均匀地轮换展示广告，然后根据点击次数进行优化。
ROTATE_INDEFINITELY 以与效果较好的广告大致相同的频率展示效果欠佳的广告，但不进行优化。
UNAVAILABLE 广告投放优化状态未知。

AdvertisingChannelType

枚举，用于描述各种广告渠道类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
SEARCH 搜索网络。包括捆绑式展示广告系列和搜索广告系列与展示广告系列组合。
DISPLAY 仅限 Google 展示广告网络。
SHOPPING 购物广告系列可在 Google 购物媒体资源和 google.com 搜索结果中投放。
HOTEL 酒店广告系列。
VIDEO 视频广告系列。
MULTI_CHANNEL 应用广告系列和以吸引用户互动为目标的应用广告系列，这些广告系列可在多个渠道中投放。
LOCAL 本地广告系列。
SMART 智能广告系列。
PERFORMANCE_MAX 效果最大化广告系列。
LOCAL_SERVICES 本地生活服务广告系列。
DISCOVERY 发现广告系列。
TRAVEL 旅游广告系列。
SOCIAL 社交广告系列。

AdvertisingChannelSubType

用于描述不同渠道子类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用作返回值。表示此版本中的未知值。
SEARCH_MOBILE_APP 搜索广告系列的移动应用广告系列。
DISPLAY_MOBILE_APP 投放到展示广告网络的移动应用广告系列。
SEARCH_EXPRESS AdWords Express 搜索广告系列。
DISPLAY_EXPRESS AdWords Express 展示广告系列。
SHOPPING_SMART_ADS 智能购物广告系列。
DISPLAY_GMAIL_AD Gmail 广告系列。
DISPLAY_SMART_CAMPAIGN 智能型展示广告系列：无法再制作这一子类型的新广告系列。
VIDEO_OUTSTREAM 外播视频广告系列。
VIDEO_ACTION TrueView 行动号召视频广告系列。
VIDEO_NON_SKIPPABLE 投放不可跳过的视频广告的视频广告系列。
APP_CAMPAIGN 应用广告系列可让您轻松地在 Google 的各种热门产品和服务（包括 Google 搜索、Google Play、YouTube 和 Google 展示广告网络）中宣传 Android 应用或 iOS 应用。
APP_CAMPAIGN_FOR_ENGAGEMENT 以提高应用互动度为目标的应用广告系列，旨在通过 Google 的多项热门产品和服务（包括 Google 搜索、YouTube 和 Google 展示广告网络）促使用户重新与应用互动。
LOCAL_CAMPAIGN 专门用于本地广告的广告系列。
SHOPPING_COMPARISON_LISTING_ADS 比价购物广告系列。
SMART_CAMPAIGN 标准智能广告系列。
VIDEO_SEQUENCE 包含依序播放视频广告的视频广告系列。
APP_CAMPAIGN_FOR_PRE_REGISTRATION 专门用于宣传移动应用预注册的应用广告系列，可在 Google Play、YouTube 和展示广告网络中定位多个广告渠道。
VIDEO_REACH_TARGET_FREQUENCY 采用“目标频次”出价策略的视频覆盖面广告系列。
TRAVEL_ACTIVITIES 旅游活动广告系列。
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook 仅跟踪社交广告系列。

RealTimeBiddingSetting

实时出价的设置，此功能仅适用于定位到 Ad Exchange 广告资源的广告系列。

JSON 表示法 
{
  "optIn": boolean
}
字段
optIn

boolean

相应广告系列是否已选择启用实时出价。

NetworkSettings

相应广告系列的投放网络设置。

JSON 表示法 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
字段
targetSearchNetwork

boolean

广告是否将在 Google 搜索网络中的合作伙伴网站上投放（要求 targetGoogleSearch 也设为 true）。
targetContentNetwork

boolean

广告是否将在 Google 展示广告网络中的指定展示位置上投放。展示位置通过“展示位置”定位条件指定。
targetPartnerSearchNetwork

boolean

广告是否将在 Google 合作伙伴网络中投放。这仅可用于部分 Google 合作伙伴账号。

DynamicSearchAdsSetting

用于控制动态搜索广告 (DSA) 的设置。

JSON 表示法 
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
字段
domainName

string

必需。相应设置所代表的网域，例如“google.com”或“www.google.com”。
languageCode

string

必需。指定网域语言的语言代码，例如“en”。
useSuppliedUrlsOnly

boolean

广告系列是否仅使用广告客户提供的网址。

ShoppingSetting

购物广告系列的设置。定义了广告系列可宣传的商品范围，以及此广告系列与其他购物广告系列的互动方式。

JSON 表示法 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
字段
feedLabel

string

要纳入广告系列中的商品的 Feed 标签。只能设置 feedLabel 或 salesCountry 之一。如果使用 feedLabel 字段代替 salesCountry 字段，则该字段接受相同格式的国家/地区代码，例如“XX”。否则，可以是 Google Merchant Center 中用于 Feed 标签的任何字符串。
useVehicleInventory

boolean

是否定位车辆详情广告资源。
merchantId

string (int64 format)

Merchant Center 账号的 ID。此字段对于创建操作是必需的。对于购物广告系列，此字段不可更改。
salesCountry

string

广告系列中待涵盖产品的销售国家/地区。
campaignPriority

integer

广告系列的优先级。数值越高，相应广告系列的优先级就越高，反之越低。此字段是购物广告系列的必需字段，值介于 0 到 2 之间（含边界值）。对于智能购物广告系列而言，此字段是选填项，如进行设置则须等于 3。
enableLocal

boolean

是否包含本地商品。

GeoTargetTypeSetting

表示与广告地理位置定位相关的一组设置。

JSON 表示法 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
字段
positiveGeoTargetType

enum (PositiveGeoTargetType)

相应广告系列中用于正向地理位置定位的设置。
negativeGeoTargetType

enum (NegativeGeoTargetType)

相应广告系列中用于否定地理位置定位的设置。

PositiveGeoTargetType

可能的正地理位置定位类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
PRESENCE_OR_INTEREST 指定当用户位于广告客户定位到的地理位置或对这些地理位置表现出兴趣时，触发相应广告。
SEARCH_INTEREST 指定当用户搜索广告客户的目标地理位置时，广告是否触发。此功能只能用于搜索广告系列和标准购物广告系列。
PRESENCE 指定当用户位于或经常位于广告客户定位到的地理位置时，触发广告。

NegativeGeoTargetType

可能的排除地理位置定位类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
PRESENCE_OR_INTEREST 指定如果用户位于广告客户排除的地理位置或对广告客户排除的地理位置表现出兴趣，则不向该用户展示广告。
PRESENCE 指定如果用户位于广告客户的排除地理位置，则不向其展示广告。

FrequencyCapEntry

此类型没有字段。

一种规则，用于指定在特定时间段内，广告（或一组广告）可向用户展示的次数上限。

SelectiveOptimization

相应广告系列的选择性优化设置，其中包括一组转化操作，用于指导广告系列优化方向。此功能仅适用于将 MULTI_CHANNEL 用作 AdvertisingChannelType 且将 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 用作 AdvertisingChannelSubType 的应用广告系列。

JSON 表示法 
{
  "conversionActions": [
    string
  ]
}
字段
conversionActions[]

string

用于优化相应广告系列的转化操作的所选资源名称集。

OptimizationGoalSetting

相应广告系列的优化目标设置，包括一组优化目标类型。

JSON 表示法 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
字段
optimizationGoalTypes[]

enum (OptimizationGoalType)

优化目标类型列表。

OptimizationGoalType

优化目标的类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用作返回值。表示此版本中的未知值。
CALL_CLICKS 针对来电点击进行优化。“点击致电转化次数”是指用户在看到广告后选择“致电”与商店联系的次数。
DRIVING_DIRECTIONS 以促成行车路线查询为目标进行优化。驾车路线转化是指用户在观看广告后选择“查询路线”以导航到实体店的次数。
APP_PRE_REGISTRATION 以提升预注册量为目标进行优化。预注册转化是指预注册订阅人数，这些用户会在应用发布时收到通知。

TrackingSetting

用于跟踪信息的广告系列级设置。

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

string

用于动态跟踪的网址。

AssetSetType

素材资源组的可能类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
PAGE_FEED 网页素材资源组。
DYNAMIC_EDUCATION 动态教育素材资源集。
MERCHANT_CENTER_FEED Google Merchant Center 资源集。
DYNAMIC_REAL_ESTATE 动态房地产素材资源组。
DYNAMIC_CUSTOM 动态自定义素材资源组。
DYNAMIC_HOTELS_AND_RENTALS 动态酒店及房屋租赁素材资源组。
DYNAMIC_FLIGHTS 动态航班素材资源组。
DYNAMIC_TRAVEL 动态旅行素材资源集。
DYNAMIC_LOCAL 动态本地素材资源集。
DYNAMIC_JOBS 动态职位素材资源集。
LOCATION_SYNC 地址同步级别素材资源集。
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP 商家资料营业地点组素材资源集。
CHAIN_DYNAMIC_LOCATION_GROUP 连锁店营业地点组素材资源集，可用于自有营业地点和关联商户营业地点。
STATIC_LOCATION_GROUP 静态营业地点组素材资源集，可用于自有营业地点和关联商户营业地点。
HOTEL_PROPERTY 酒店房源素材资源集，用于将酒店房源 Feed 与指定旅行目标的效果最大化广告系列相关联。
TRAVEL_FEED 旅游 Feed 素材资源组类型。可以表示酒店 Feed 或“活动”Feed。

ManualCpa

此类型没有字段。

一种人工出价策略，可让广告客户为广告客户指定的操作设置出价。

ManualCpc

基于点击的手动出价，用户按每次点击付费。

JSON 表示法 
{
  "enhancedCpcEnabled": boolean
}
字段
enhancedCpcEnabled

boolean

是否根据转化优化工具数据增强出价。

ManualCpm

此类型没有字段。

人工出价，按展示次数付费，用户为每千次展示付费。

PercentCpc

一种出价策略，其中出价是部分商品或服务的广告价格的一小部分。

JSON 表示法 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
字段
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。这是由广告客户输入的选填字段，并以本地微单位指定。注意：零值的解读方式与未定义 bid_ceiling 相同。
enhancedCpcEnabled

boolean

根据转化可能性，在每次竞价中提高或降低出价。个别出价可能会超过 cpcBidCeilingMicros，但广告系列的平均出价金额不应超过。

TargetCpm

此类型没有字段。

“目标每千次展示费用”是一种自动出价策略，可根据您设置的目标每千次展示费用来设置出价，从而优化效果。

CampaignAsset

广告系列与素材资源之间的关联。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
字段
resourceName

string

广告系列资源的资源名称。CampaignAsset 资源名称采用以下格式：

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}
status

enum (AssetLinkStatus)

广告系列素材资源的状态。
campaign

string

素材资源关联到的广告系列。
asset

string

与广告系列关联的素材资源。

CampaignAssetSet

CampaignAssetSet 是广告系列与素材资源组之间的关联。添加 CampaignAssetSet 会将素材资源组与广告系列相关联。

JSON 表示法 
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
字段
resourceName

string

广告系列素材资源组的资源名称。资产集资产资源名称采用以下格式：

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign

string

相应素材资源集所关联的广告系列。
assetSet

string

与广告系列关联的素材资源集。
status

enum (AssetSetLinkStatus)

广告系列素材资源组素材资源的状态。只读。

CampaignAudienceView

广告系列受众群体视图。包括展示广告网络和 YouTube 广告网络的兴趣和再营销名单，以及搜索广告再营销名单 (RLSA) 的效果数据，按广告系列和受众群体条件汇总。此视图仅包含在广告系列一级添加的受众群体。

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

string

广告系列受众群体视图的资源名称。广告系列受众群体视图资源名称采用以下格式：

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

广告系列定位条件。

JSON 表示法 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
字段
resourceName

string

相应广告系列条件的资源名称。广告系列条件的资源名称采用以下格式：

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}
displayName

string

条件的显示名称。

对于变更，此字段会被忽略。
type

enum (CriterionType)

条件的类型。
status

enum (CampaignCriterionStatus)

条件的状态。
lastModifiedTime

string

上次修改此广告系列条件的日期时间。日期时间采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。
criterionId

string (int64 format)

条件的 ID。

在变更期间，此字段会被忽略。
bidModifier

number

条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。使用 0 可停用设备类型。
negative

boolean

是定位 (false) 还是排除 (true) 条件。

联合字段 criterion。广告系列定位条件。

只能设置一个值。criterion 只能是下列其中一项：
keyword

object (KeywordInfo)

关键字。
location

object (LocationInfo)

位置信息。
device

object (DeviceInfo)

设备。
ageRange

object (AgeRangeInfo)

年龄段。
gender

object (GenderInfo)

性别。
userList

object (UserListInfo)

用户列表。
language

object (LanguageInfo)

语言。
webpage

object (WebpageInfo)

网页。
locationGroup

object (LocationGroupInfo)

营业地点组

CampaignCriterionStatus

CampaignCriterion 可能的状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
ENABLED 广告系列定位条件已启用。
PAUSED 广告系列定位条件已暂停。
REMOVED 广告系列定位条件已移除。

LanguageInfo

语言条件。

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

string

语言常量资源名称。

LocationGroupInfo

通过 Feed 指定的一系列地理位置周围的半径。

JSON 表示法 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
字段
geoTargetConstants[]

string

用于限制 Feed 中地理区域范围的地理位置定位常量。目前仅允许一个地理位置定位常量。
radiusUnits

enum (LocationGroupRadiusUnits)

半径的单位。地理位置定位条件常量支持英里和米。对于 Feed 商品集，支持毫英里和米。此字段是必需的，必须在 CREATE 操作中设置。
feedItemSets[]

string

FeedItemSet，其 FeedItem 已定位。如果指定了多个 ID，则至少出现在一个集合中的所有商品都会成为定位对象。此字段不能与 geoTargetConstants 搭配使用。此字段为可选字段，只能在 CREATE 操作中设置。
radius

string (int64 format)

以指定单位表示的距离，用于指定目标地理位置的周边范围。此字段是必需的，必须在 CREATE 操作中设置。

LocationGroupRadiusUnits

地理位置组中半径距离的单位（例如，英里）

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
METERS 米
MILES 英里
MILLI_MILES Milli Miles

CampaignEffectiveLabel

表示广告系列与有效标签之间的关系。有效标签是指继承或直接分配给相应广告系列的标签。

JSON 表示法 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
字段
resourceName

string

资源的名称。CampaignEffectivelabel 资源名称采用以下格式：customers/{ownerCustomerId}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign

string

有效标签所附加到的广告系列。
label

string

分配给广告系列的有效标签。
ownerCustomerId

string (int64 format)

拥有有效标签的客户的 ID。

CampaignLabel

表示广告系列与标签之间的关系。

JSON 表示法 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
字段
resourceName

string

资源的名称。广告系列标签资源名称采用以下格式：customers/{ownerCustomerId}/campaignLabels/{campaign_id}~{label_id}
campaign

string

标签附加到的广告系列。
label

string

分配给广告系列的标签。
ownerCustomerId

string (int64 format)

拥有相应标签的客户的 ID。

CartDataSalesView

购物车数据销售情况视图。

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

string

购物车数据销售情况视图的资源名称。购物车数据销售情况视图资源名称采用以下格式：customers/{customerId}/cartDataSalesView

受众群体

受众群体是一个效果很好的定位选项，让您可通过组合各种细分受众群属性（例如详细受众特征和兴趣相似的受众群体）得出其交集部分，从而创建出代表目标细分受众群某一部分的受众群体。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
字段
resourceName

string

相应受众群体的资源名称。受众群体名称的格式如下：

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

受众群体的 ID。
name

string

必需。受众群体的名称。在所有受众群体中应该是唯一的。长度不得少于 1 个字符，不得超过 255 个字符。
description

string

相应受众群体的说明。

ConversionAction

转化操作。

JSON 表示法 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
字段
resourceName

string

转化操作的资源名称。转化操作资源名称采用以下格式：

customers/{customerId}/conversionActions/{conversion_action_id}
creationTime

string

Floodlight 活动的创建时间戳，采用 ISO 8601 格式。
status

enum (ConversionActionStatus)

针对转化事件累计的此转化操作的状态。
type

enum (ConversionActionType)

相应转化操作的类型。
category

enum (ConversionActionCategory)

相应转化操作所报告的转化的类别。
valueSettings

object (ValueSettings)

与此转化操作关联的转化事件的价值相关的设置。
attributionModelSettings

object (AttributionModelSettings)

与相应转化操作的归因模型相关的设置。
floodlightSettings

object (FloodlightSettings)

Floodlight 转化类型的 Floodlight 设置。
id

string (int64 format)

转化操作的 ID。
name

string

转化操作的名称。

此字段为必填字段，在创建新转化操作时不应为空。
primaryForGoal

boolean

如果转化操作的 primaryForGoal 位为 false，则无论客户转化目标或广告系列转化目标如何，该转化操作都无法用于所有广告系列的出价。不过，自定义转化目标不会考虑 primaryForGoal，因此，如果广告系列配置的自定义转化目标包含 primaryForGoal = false 的转化操作，该转化操作仍然可用于出价。默认情况下，如果未设置，primaryForGoal 将为 true。在 V9 中，primaryForGoal 只能在创建后通过“更新”操作设置为 false，因为它未声明为可选。
ownerCustomer

string

转化操作所有者客户的资源名称；如果这是系统定义的转化操作，则为 null。
includeInClientAccountConversionsMetric

boolean

相应转化操作是否应纳入“clientAccountConversions”指标中。
includeInConversionsMetric

boolean

相应转化操作是否应纳入到“转化次数”指标中。
clickThroughLookbackWindowDays

string (int64 format)

互动（例如点击）与转化事件之间可能相隔的最长天数。
appId

string

应用转化操作的应用 ID。

ConversionActionStatus

转化操作的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 系统会记录转化。
REMOVED 系统将不会记录转化。
HIDDEN 系统不会记录转化，并且界面中不会显示相应转化操作。

ConversionActionType

转化操作的可能类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AD_CALL 用户点击广告的电话信息附加信息时发生的转化。
CLICK_TO_CALL 用户在移动设备上点击电话号码时发生的转化。
GOOGLE_PLAY_DOWNLOAD 用户从 Google Play 商店下载移动应用时发生的转化。
GOOGLE_PLAY_IN_APP_PURCHASE 用户通过 Android 结算在应用内购买商品时发生的转化。
UPLOAD_CALLS 由广告客户跟踪并上传的来电转化。
UPLOAD_CLICKS 由广告客户跟踪并随归因的点击一起上传的转化。
WEBPAGE 在网页上发生的转化。
WEBSITE_CALL 用户通过广告客户网站上动态生成的电话号码拨打电话时发生的转化。
STORE_SALES_DIRECT_UPLOAD 基于第一方或第三方商家数据上传的实体店销售转化。只有在许可名单中的客户才能使用实体店销售直接上传类型。
STORE_SALES 实体店销售转化，基于第一方或第三方商家数据上传，和/或基于使用支付网络中的卡进行的实体店购物。只有在许可名单中的客户才能使用实体店销售类型。只读。
FIREBASE_ANDROID_FIRST_OPEN 通过 Firebase 跟踪的 Android 应用首次打开转化。
FIREBASE_ANDROID_IN_APP_PURCHASE 通过 Firebase 跟踪的 Android 应用内购买转化。
FIREBASE_ANDROID_CUSTOM 通过 Firebase 跟踪的 Android 应用自定义转化。
FIREBASE_IOS_FIRST_OPEN 通过 Firebase 跟踪的 iOS 应用首次打开转化。
FIREBASE_IOS_IN_APP_PURCHASE 通过 Firebase 跟踪的 iOS 应用内购买转化。
FIREBASE_IOS_CUSTOM 通过 Firebase 跟踪的 iOS 应用自定义转化。
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN 通过第三方应用分析工具跟踪的 Android 应用首次打开转化次数。
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE 通过第三方应用分析工具跟踪的 Android 应用内购买转化。
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM 通过第三方应用分析工具跟踪的 Android 应用自定义转化。
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN 通过第三方应用分析工具跟踪的 iOS 应用首次打开转化。
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE 通过第三方应用分析工具跟踪的 iOS 应用内购买转化。
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM 通过第三方应用分析工具跟踪的 iOS 应用自定义转化。
ANDROID_APP_PRE_REGISTRATION 用户通过 Google Play 商店预注册移动应用时发生的转化。只读。
ANDROID_INSTALLS_ALL_OTHER_APPS 用于跟踪所有 Google Play 下载的转化，这些下载未通过特定于应用的转化类型进行跟踪。只读。
FLOODLIGHT_ACTION 一种 Floodlight 活动，用于统计用户在查看或点击广告客户的某个广告后访问特定网页的次数。只读。
FLOODLIGHT_TRANSACTION 用于跟踪完成的销售次数或购买的商品数量的 Floodlight 活动。还可以捕获每次销售的总金额。只读。
GOOGLE_HOSTED 转化是指用户与广告互动后，通过 Google 的产品和服务跟踪到的本地操作。只读。
LEAD_FORM_SUBMIT 用户提交潜在客户表单时报告的转化。只读。
SALESFORCE

已弃用：Salesforce 集成即将停用，届时将提供更便捷的方式，让您轻松从 Salesforce 导入转化数据。- 请参阅 https://support.google.com/google-ads/answer/14728349
SEARCH_ADS_360 从 Search Ads 360 Floodlight 数据导入的转化。只读。
SMART_CAMPAIGN_AD_CLICKS_TO_CALL 使用智能广告系列自定义条件，跟踪智能广告系列广告中发生的来电转化，而无需设置来电跟踪。只读。
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL 用户点击 Google 地图中的电话元素。仅限智能广告系列。只读。
SMART_CAMPAIGN_MAP_DIRECTIONS 用户在 Google 地图中请求前往某个营业地点的路线。仅限智能广告系列。只读。
SMART_CAMPAIGN_TRACKED_CALLS 使用智能广告系列自定义条件，在设置了来电跟踪功能的智能广告系列广告中发生的来电转化。只读。
STORE_VISITS 用户光顾广告客户的实体零售店时发生的转化。只读。
WEBPAGE_CODELESS 根据网站事件（例如提交表单或加载网页）创建的转化，不使用单独编码的事件代码段。只读。
UNIVERSAL_ANALYTICS_GOAL 来自关联的 Universal Analytics 目标的转化。
UNIVERSAL_ANALYTICS_TRANSACTION 来自已关联的 Universal Analytics 交易的转化。
GOOGLE_ANALYTICS_4_CUSTOM 来自关联的 Google Analytics 4 自定义事件转化的转化。
GOOGLE_ANALYTICS_4_PURCHASE 来自关联的 Google Analytics 4 购买转化。

ConversionActionCategory

与 ConversionAction 相关联的转化类别。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
DEFAULT 默认类别。
PAGE_VIEW 用户访问网页。
PURCHASE 购买、销售或“下单”事件。
SIGNUP 注册用户操作。
LEAD 带来潜在客户的操作。
DOWNLOAD 软件下载操作（例如应用下载）。
ADD_TO_CART 在广告客户网站上将商品添加到购物车或购物袋。
BEGIN_CHECKOUT 用户在广告客户网站上进入结账流程。
SUBSCRIBE_PAID 产品或服务的付费订阅开始时间。
PHONE_CALL_LEAD 表示对广告客户的产品/服务感兴趣的通话。
IMPORTED_LEAD 从外部来源导入 Google Ads 的潜在客户转化。
SUBMIT_LEAD_FORM 在广告客户网站上提交表单，表明对业务感兴趣。
BOOK_APPOINTMENT 与广告客户的商家预约服务。
REQUEST_QUOTE 报价或价格估算请求。
GET_DIRECTIONS 用户搜索广告客户的营业地点，并有意向前往。
OUTBOUND_CLICK 用户点击广告客户合作伙伴的网站。
CONTACT 致电、发送短信、发送电子邮件、聊天或以其他方式与广告客户联系。
ENGAGEMENT 网站互动事件，例如网站停留时间较长或 Google Analytics (GA) 智能目标。旨在用于 Google Analytics、Firebase、Google Analytics Gold 目标导入。
STORE_VISIT 光顾实体店。
STORE_SALE 在实体店发生的销售交易。
QUALIFIED_LEAD 从外部来源导入到 Google Ads 中的潜在客户转化，已由广告客户（营销/销售团队）进一步确认。在从潜在客户到销售的历程中，广告客户会先获得潜在客户，然后通过与消费者联系来采取行动。如果消费者感兴趣并最终可能会购买其产品，广告客户会将此类潜在客户标记为“合格的潜在客户”。
CONVERTED_LEAD 从外部来源导入到 Google Ads 中的潜在客户转化，已进一步完成潜在客户开发广告客户定义的所选阶段。

ValueSettings

与此转化操作关联的转化事件的价值相关的设置。

JSON 表示法 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
字段
defaultValue

number

当针对相应转化操作发送的转化事件包含无效、不允许或缺失的价值时，或者当相应转化操作配置为始终使用默认价值时，要使用的价值。
defaultCurrencyCode

string

当针对相应转化操作发送的转化事件包含无效或缺失的币种代码时，或者当相应转化操作配置为始终使用默认价值时，要使用的币种代码。
alwaysUseDefaultValue

boolean

控制是否使用默认价值和默认币种代码来代替相应转化操作的转化事件中指定的价值和币种代码。

AttributionModelSettings

与相应转化操作的归因模型相关的设置。

JSON 表示法 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
字段
attributionModel

enum (AttributionModel)

相应转化操作的归因模型类型。
dataDrivenModelStatus

enum (DataDrivenModelStatus)

相应转化操作的以数据为依据的归因模型的状态。

AttributionModel

一种归因模型，用于描述如何将特定转化的功劳分配给可能发生的多次先前互动。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
EXTERNAL 使用外部归因模型。
GOOGLE_ADS_LAST_CLICK 将转化的所有功劳归因于促成转化的最后一次点击。
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK 使用 Google 搜索归因模型将转化的全部功劳都归于首次点击。
GOOGLE_SEARCH_ATTRIBUTION_LINEAR 使用 Google 搜索归因将转化功劳平均分配给促成转化的所有点击。
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY 使用 Google 搜索归因模型，以指数方式将更多转化功劳归于最近的点击（半衰期为 1 周）。
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED 将转化功劳的 40% 归因于首次点击和最后一次点击。剩余的 20% 平均分配给所有其他点击。这会使用 Google 搜索归因。
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN 一种灵活的模型，它使用机器学习技术，通过 Google 搜索归因来确定点击之间的适当功劳分配。

DataDrivenModelStatus

枚举以数据为依据的模型的各种状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
AVAILABLE 以数据为依据的模型可用。
STALE 以数据为依据的模型已过时。该应用已至少 7 天未更新。它仍在被使用，但如果 30 天内未更新，则会过期。
EXPIRED 以数据为依据的模型已过期。它已至少 30 天未更新，无法使用。最常见的原因是，在最近 30 天内，事件数量未达到要求。
NEVER_GENERATED 以数据为依据的模型从未生成过。最常见的原因是，在任何 30 天的时间段内，事件数量都从未达到所需数量。

FloodlightSettings

与 Floodlight 转化操作相关的设置。

JSON 表示法 
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
字段
activityGroupTag

string

报告转化次数时用于标识 Floodlight 活动组的字符串。
activityTag

string

报告转化次数时用于标识 Floodlight 活动的字符串。
activityId

string (int64 format)

DoubleClick Campaign Manager (DCM) 中的 Floodlight 活动的 ID。

ConversionCustomVariable

转化自定义变量。如需了解详情，请参阅 https://support.google.com/sa360/answer/13567857 中的“新版 Search Ads 360 中的自定义 Floodlight 指标和维度简介”。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
字段
resourceName

string

转化自定义变量的资源名称。转化自定义变量资源名称采用以下格式：

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}
id

string (int64 format)

转化自定义变量的 ID。
name

string

必需。转化自定义变量的名称。名称应是唯一的。名称的最大长度为 100 个字符。前后不应有任何多余空格。
tag

string

必需。转化自定义变量的标记。标记应是唯一的，并且由字符“u”直接后跟一个小于或等于 100 的数字组成。例如：“u4”。
status

enum (ConversionCustomVariableStatus)

转化自定义变量针对转化事件累计的状态。
ownerCustomer

string

拥有相应转化自定义变量的客户的资源名称。
family

enum (ConversionCustomVariableFamily)

转化自定义变量的系列。
cardinality

enum (ConversionCustomVariableCardinality)

转化自定义变量的基数。
floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Search Ads 360 Floodlight 转化自定义变量的字段。
customColumnIds[]

string (int64 format)

使用相应转化自定义变量的自定义列的 ID。

ConversionCustomVariableStatus

转化自定义变量的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ACTIVATION_NEEDED

转化自定义变量正等待激活，在设置为 ENABLED 之前不会累积统计数据。

此状态不能用于 CREATE 和 UPDATE 请求。
ENABLED 转化自定义变量已启用，并将开始累积统计数据。
PAUSED 转化自定义变量已暂停，在重新设置为 ENABLED 之前不会累积统计数据。

ConversionCustomVariableFamily

转化自定义变量的系列。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
STANDARD 标准转化自定义变量。客户必须先激活，然后才能使用。
FLOODLIGHT 从自定义 Floodlight 变量导入的转化自定义变量。

ConversionCustomVariableCardinality

转化自定义变量的基数。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
BELOW_ALL_LIMITS 转化自定义变量的基数低于所有上限。该变量可用于细分，如果已启用该变量，则新值可能会累积统计数据。
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT 转化自定义变量的基数超过了细分上限，但未超过统计上限。细分功能将被停用，但如果启用了相应变量，系统可以针对新值累积统计数据。
APPROACHES_STATS_LIMIT 转化自定义变量已超出细分限制，并且即将达到统计信息限制（超过 90%）。细分功能将被停用，但如果启用了相应变量，系统可以针对新值累积统计数据。
EXCEEDS_STATS_LIMIT 转化自定义变量已超出细分限制和统计信息限制。细分功能将被停用，只有当现有值不会进一步增加变量的基数时，才能累积已启用变量的统计数据。

FloodlightConversionCustomVariableInfo

Search Ads 360 Floodlight 转化自定义变量的相关信息。

JSON 表示法 
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
字段
floodlightVariableType

enum (FloodlightVariableType)

在 Search Ads 360 中定义的 Floodlight 变量类型。
floodlightVariableDataType

enum (FloodlightVariableDataType)

在 Search Ads 360 中定义的 Floodlight 变量数据类型。

FloodlightVariableType

Floodlight 变量的类型，如 Search Ads 360 中所定义。如需了解详情，请参阅 https://support.google.com/searchads/answer/4397154?hl=en。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
DIMENSION 维度 Floodlight 变量类型。
METRIC 指标 Floodlight 变量类型。
UNSET Floodlight 变量类型未设置。

FloodlightVariableDataType

Floodlight 变量的数据类型，如在 Search Ads 360 中所定义。如需了解详情，请参阅 https://support.google.com/searchads/answer/4397154?hl=en。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NUMBER 表示“数字”类型的 Floodlight 变量。此变量可分配给维度或指标类型的 Floodlight 变量。
STRING 表示“字符串”类型的 Floodlight 变量。此变量可分配给 DIMENSION 类型的 Floodlight 变量。

客户

客户。

JSON 表示法 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
字段
resourceName

string

客户的资源名称。客户资源名称采用以下格式：

customers/{customerId}
conversionTrackingSetting

object (ConversionTrackingSetting)

客户的转化跟踪设置。
accountType

enum (AccountType)

Engine 账号类型，例如 Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track 等。
doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

经理客户的 DoubleClick Campaign Manager (DCM) 设置。
accountStatus

enum (AccountStatus)

账号状态，例如“已启用”“已暂停”“已移除”等。
lastModifiedTime

string

上次修改此客户的日期时间。日期时间采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。
engineId

string

外部引擎账号中的账号的 ID。
status

enum (CustomerStatus)

客户的状态。
creationTime

string

创建此客户时的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。
managerId

string (int64 format)

经理的客户 ID。值为 0 表示客户没有 SA360 经理账号。
managerDescriptiveName

string

经理的描述性名称。
subManagerId

string (int64 format)

子级经理的客户 ID。值为 0 表示客户没有子 SA360 经理账号。
subManagerDescriptiveName

string

子级经理的描述性名称。
associateManagerId

string (int64 format)

副经理的客户 ID。值为 0 表示客户没有 SA360 副经理。
associateManagerDescriptiveName

string

副经理的描述性名称。
accountLevel

enum (AccountLevelType)

客户的账号层级：经理账号、子级经理账号、副经理账号、服务账号。
id

string (int64 format)

客户的 ID。
descriptiveName

string

（可选）客户的非唯一描述性名称。
currencyCode

string

账号采用的币种。支持 ISO 4217 标准中的一部分货币代码。
timeZone

string

客户的当地时区 ID。
trackingUrlTemplate

string

用于根据参数构建跟踪网址的网址模板。
finalUrlSuffix

string

用于将参数附加到最终到达网址的网址模板。
autoTaggingEnabled

boolean

相应客户是否已启用自动标记功能。
manager

boolean

相应客户是否为经理。

ConversionTrackingSetting

与 Search Ads 360 转化跟踪相关的一组客户级设置。

JSON 表示法 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
字段
acceptedCustomerDataTerms

boolean

客户是否已接受客户数据条款。如果使用跨账号转化跟踪，此值会从经理账号继承。此字段为只读字段。如需了解详情，请访问 https://support.google.com/adspolicy/answer/7475709。
conversionTrackingStatus

enum (ConversionTrackingStatus)

转化跟踪状态。它表示客户是否在使用转化跟踪，以及该客户的转化跟踪所有者是谁。如果相应客户使用的是跨账号转化跟踪，则返回的值会因请求的 login-customer-id 而异。
enhancedConversionsForLeadsEnabled

boolean

客户是否已选择启用增强型潜在客户转化。如果使用跨账号转化跟踪，此值会从经理账号继承。此字段为只读字段。
googleAdsConversionCustomer

string

创建和管理转化的客户的资源名称。此字段为只读字段。
conversionTrackingId

string (int64 format)

相应账号所用的转化跟踪 ID。此 ID 不表示客户是否使用转化跟踪（conversionTrackingStatus 表示）。此字段为只读字段。
googleAdsCrossAccountConversionTrackingId

string (int64 format)

客户的经理的转化跟踪 ID。当客户选择启用转化跟踪时，系统会设置此值，并且此值会替换 conversionTrackingId。此字段只能通过 Google Ads 界面进行管理。此字段为只读字段。
crossAccountConversionTrackingId

string (int64 format)

客户的经理的转化跟踪 ID。当客户选择采用跨账号转化跟踪时，系统会设置此值，并且此值会替换 conversionTrackingId。

ConversionTrackingStatus

客户的转化跟踪状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NOT_CONVERSION_TRACKED 客户未使用任何转化跟踪。
CONVERSION_TRACKING_MANAGED_BY_SELF 转化操作由相应客户创建和管理。
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER 转化操作由请求的 login-customer-id 中指定的经理账号创建和管理。
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER 转化操作由与请求的 login-customer-id 中指定的客户或经理不同的经理创建和管理。

AccountType

可能的引擎账号类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
BAIDU 百度账号。
ENGINE_TRACK 引擎跟踪账号。
FACEBOOK Facebook 账号。
FACEBOOK_GATEWAY 通过网关管理的 Facebook 账号。
GOOGLE_ADS Google Ads 账户的效果。
MICROSOFT Microsoft Advertising 账号。
SEARCH_ADS_360 Search Ads 360 经理账号。
YAHOO_JAPAN Yahoo Japan 账号。

DoubleClickCampaignManagerSetting

经理客户的 DoubleClick Campaign Manager (DCM) 设置。

JSON 表示法 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
字段
advertiserId

string (int64 format)

与相应客户相关联的 Campaign Manager 广告客户的 ID。
networkId

string (int64 format)

与相应客户相关联的 Campaign Manager 广告联盟的 ID。
timeZone

string

与相应客户相关联的 Campaign Manager 广告网络时区（采用 IANA 时区数据库格式），例如 America/New_York。

AccountStatus

账号的可能状态。

枚举
UNSPECIFIED 默认值。
UNKNOWN 未知值。
ENABLED 账号可以投放广告。
PAUSED 账号已被用户停用。
SUSPENDED 账号已通过内部流程停用。
REMOVED 账号已永久停用。
DRAFT 账号仍在设置过程中，尚未启用。

CustomerStatus

客户可能的状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 表示有效账号，可以投放广告。
CANCELED 表示已撤消的账号无法投放广告。可由管理员用户重新激活。
SUSPENDED 表示账号已中止，无法投放广告。只能由 Google 支持人员激活。
CLOSED 表示已关闭的账号无法投放广告。测试账号也会处于“已关闭”状态。此状态是永久性的，可能无法重新开启。

AccountLevelType

用于描述可能的账号级别的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
CLIENT_ACCOUNT_FACEBOOK 客户账号 (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS 客户账号 (Google Ads)
CLIENT_ACCOUNT_MICROSOFT 客户账号 (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN 客户账号 (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK 客户账号（引擎跟踪）
MANAGER 顶级经理账号。
SUB_MANAGER 子级经理。
ASSOCIATE_MANAGER 副经理。

CustomerAsset

客户与资源之间的关联。

JSON 表示法 
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
字段
resourceName

string

客户资产的资源名称。CustomerAsset 资源名称采用以下格式：

customers/{customerId}/customerAssets/{assetId}~{fieldType}
asset

string

必需。与客户关联的素材资源。
status

enum (AssetLinkStatus)

客户素材资源的状态。

CustomerAssetSet

CustomerAssetSet 是客户与资产集之间的关联。添加 CustomerAssetSet 会将素材资源集与客户相关联。

JSON 表示法 
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
字段
resourceName

string

客户资产集的资源名称。资产集资产资源名称采用以下格式：

customers/{customerId}/customerAssetSets/{asset_set_id}
assetSet

string

与客户关联的素材资源集。
customer

string

相应素材资源集所关联的客户。
status

enum (AssetSetLinkStatus)

客户素材资源组的素材资源的状态。只读。

AccessibleBiddingStrategy

表示客户拥有并与客户共享的 BiddingStrategies 的视图。

与 BiddingStrategy 不同，此资源不仅包含相应客户拥有的出价策略，还包含相应客户的经理账号拥有的并与相应客户共享的出价策略。此资源不提供指标，仅公开 BiddingStrategy 属性的有限子集。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
字段
resourceName

string

可访问的出价策略的资源名称。AccessibleBiddingStrategy 资源名称采用以下格式：

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}
id

string (int64 format)

出价策略的 ID。
name

string

出价策略的名称。
type

enum (BiddingStrategyType)

出价策略的类型。
ownerCustomerId

string (int64 format)

拥有相应出价策略的客户的 ID。
ownerDescriptiveName

string

拥有相应出价策略的客户的 descriptiveName。

联合字段 scheme。出价方案。

只能设置一个。scheme 只能是下列其中一项：
maximizeConversionValue

object (MaximizeConversionValue)

一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能高的转化价值。
maximizeConversions

object (MaximizeConversions)

一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能多的转化。
targetCpa

object (TargetCpa)

一种出价策略，可设置出价，在将每次转化费用控制在您设定的目标水平的前提下，帮助您争取尽可能多的转化。
targetImpressionShare

object (TargetImpressionShare)

一种自动出价策略，可自动优化以实现所选的展示百分比。
targetRoas

object (TargetRoas)

一种出价策略，可帮助您在达到特定目标广告支出回报率 (ROAS) 平均值的同时，尽可能提高收入。
targetSpend

object (TargetSpend)

一种出价策略，使用该策略，系统会自动为您设置适当的出价，确保在不超出预算的前提下为您争取尽可能多的点击。

MaximizeConversionValue

一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能高的转化价值。

JSON 表示法 
{
  "targetRoas": number
}
字段
targetRoas

number

目标广告支出回报率 (ROAS) 选项。如果设置此选项，出价策略会最大限度地增加收入，同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高，则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率，则出价策略的目标是尽可能为预算实现最高的广告支出回报率。

MaximizeConversions

一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能多的转化。

JSON 表示法 
{
  "targetCpa": string,
  "targetCpaMicros": string
}
字段
targetCpa

string (int64 format)

“目标每次转化费用 (CPA)”选项。这是指您愿意为每次获取支付的平均金额。
targetCpaMicros

string (int64 format)

“目标每次转化费用 (CPA)”选项。这是指您愿意为每次获取支付的平均金额。

TargetCpa

一种自动出价策略，可通过设置出价来帮助您达成所设置的目标每次转化费用，同时争取尽可能多的转化。

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

string (int64 format)

平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。

TargetImpressionShare

一种自动出价策略，可设置出价，使一定百分比的搜索广告展示在首页顶部（或其他目标位置）。

JSON 表示法 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
字段
location

enum (TargetImpressionShareLocation)

搜索结果页上的目标位置。
locationFractionMicros

string (int64 format)

要在定位到的地理位置展示的广告所占的比例（以微为单位）。例如，1% 等于 10,000。
cpcBidCeilingMicros

string (int64 format)

自动出价系统可以指定的最高每次点击费用出价。这是由广告客户输入的必填字段，该字段用于设置上限值，并以本地微单位指定。

TargetRoas

一种自动出价策略，可帮助您在达到特定目标广告支出回报率 (ROAS) 平均值的同时，尽可能提高收入。

JSON 表示法 
{
  "targetRoas": number
}
字段
targetRoas

number

每单位支出所选择的收入（基于转化数据）。

TargetSpend

这是一种自动出价策略，使用该策略，系统会为您设置适当的出价，确保在不超出预算的前提下为您争取尽可能多的点击。

JSON 表示法 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
字段
targetSpendMicros
(deprecated)

string (int64 format)

尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定，则预算会被用作支出目标。 此字段已弃用，不应再使用。如需了解详情，请访问 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。
cpcBidCeilingMicros

string (int64 format)

可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

ManagerLinkStatus

链接的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ACTIVE 表示当前有效的关系
INACTIVE 表示关系已终止
PENDING 表示经理已请求建立关系，但客户尚未接受。
REFUSED 经理账号已请求建立关系，但客户账号已拒绝。
CANCELED 表示经理账号已请求关联，但随后取消了该请求。

CustomerClient

指定客户与客户客户之间的关联。CustomerClient 仅适用于经理客户。包括所有直接客户和间接客户，以及经理账号本身。

JSON 表示法 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
字段
resourceName

string

客户客户端的资源名称。CustomerClient 资源名称采用以下格式：customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

请求客户所拥有的应用于客户端客户的标签的资源名称。标签资源名称采用以下格式：

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

客户客户的状态。只读。
clientCustomer

string

与指定客户相关联的客户客户的资源名称。只读。
hidden

boolean

指定相应账号是否为隐藏账号。

只读。
level

string (int64 format)

给定客户与客户之间的距离。对于自链接，级别值为 0。只读。
timeZone

string

客户端时区的通用区域设置数据资源库 (CLDR) 字符串表示形式，例如 America/Los_Angeles。只读。
testAccount

boolean

标识客户是否为测试账号。只读。
manager

boolean

用于标识客户是否为经理。只读。
descriptiveName

string

客户的描述性名称。只读。
currencyCode

string

客户的币种代码（例如“USD”“EUR”）。只读。
id

string (int64 format)

客户客户的 ID。只读。

DynamicSearchAdsSearchTermView

动态搜索广告搜索字词视图。

JSON 表示法 
{
  "resourceName": string,
  "landingPage": string
}
字段
resourceName

string

动态搜索广告搜索字词视图的资源名称。动态搜索广告搜索字词视图资源名称的格式如下：

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

展示的动态选择的着陆页网址。

此字段为只读字段。

GenderView

性别视图。genderView 资源反映的是实际投放状态，而不是添加了哪些条件。默认情况下，不含性别条件的广告组会向所有性别的用户展示，因此 genderView 中会显示所有性别的统计信息。

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

string

性别视图的资源名称。性别视图资源名称采用以下格式：

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

地理位置定位条件常量。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
字段
resourceName

string

地理位置定位目标常量的资源名称。地理位置定位目标常量资源名称采用以下格式：

geoTargetConstants/{geo_target_constant_id}
status

enum (GeoTargetConstantStatus)

地理位置定位条件常量的状态。
id

string (int64 format)

地理位置定位条件常量的 ID。
name

string

地理位置定位条件常量的英文名称。
countryCode

string

与目标相关联的 ISO-3166-1 alpha-2 国家/地区代码。
targetType

string

地理位置定位条件常量的定位类型。
canonicalName

string

完全限定的英文名称，由目标名称及其父级和国家/地区的名称组成。
parentGeoTarget

string

父地理位置定位目标常量的资源名称。地理位置定位目标常量资源名称采用以下格式：

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

地理位置定位条件常量的可能状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知收到的值。

此值为仅限响应的值。
ENABLED 地理位置定位常量有效。
REMOVAL_PLANNED 地理位置定位常量已过时，将被移除。

KeywordView

关键字视图。

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

string

关键字视图的资源名称。关键字视图资源名称采用以下格式：

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

标签

标签。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
字段
resourceName

string

资源的名称。标签资源名称采用以下格式：customers/{ownerCustomerId}/labels/{label_id}
status

enum (LabelStatus)

标签的状态。只读。
textLabel

object (TextLabel)

一种在彩色背景上显示文字的标签。
id

string (int64 format)

标签的 ID。只读。
name

string

标签的名称。

此字段为必填字段，在创建新标签时不应为空。

此字符串的长度应介于 1 到 80 之间（包括 1 和 80）。

LabelStatus

标签的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 标签已启用。
REMOVED 标签已移除。

TextLabel

一种在彩色背景上显示文字的标签。

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

string

标签的背景颜色（采用十六进制格式）。此字符串必须与正则表达式 '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$' 匹配。注意：对于经理账号，背景颜色可能不可见。
description

string

标签的简短说明。长度不得超过 200 个字符。

LanguageConstant

一种语言。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
字段
resourceName

string

语言常量的资源名称。语言常量资源名称采用以下格式：

languageConstants/{criterionId}
id

string (int64 format)

语言常量的 ID。
code

string

语言代码，例如“en_US”“en_AU”“es”“fr”等。
name

string

语言的英文全名，例如“English (US)”“Spanish”等。
targetable

boolean

相应语言是否可定位。

LocationView

地理位置视图会按地理位置条件汇总广告系列的效果。

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

string

位置视图的资源名称。位置信息视图资源名称采用以下格式：

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

商品出价类别。

JSON 表示法 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
字段
resourceName

string

商品出价类别的资源名称。商品出价类别的资源名称采用以下格式：

productBiddingCategoryConstants/{countryCode}~{level}~{id}
level

enum (ProductBiddingCategoryLevel)

商品出价类别的级别。
status

enum (ProductBiddingCategoryStatus)

商品出价类别的状态。
id

string (int64 format)

商品出价类别的 ID。

此 ID 等同于此文章中所述的 google_product_category ID：https://support.google.com/merchants/answer/6324436。
countryCode

string

商品出价类别的双字母大写国家/地区代码。
productBiddingCategoryConstantParent

string

父级商品出价类别的资源名称。
languageCode

string

商品出价类别的语言代码。
localizedName

string

根据 languageCode 本地化的商品出价类别的显示值。

ProductBiddingCategoryLevel

枚举，用于描述商品出价类别的级别。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
LEVEL1 1 级。
LEVEL2 2 级。
LEVEL3 3 级。
LEVEL4 4 级。
LEVEL5 第 5 级。

ProductBiddingCategoryStatus

用于描述商品出价类别状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ACTIVE 相应类别处于有效状态，可用于出价。
OBSOLETE 相应类别已过时。仅用于生成报告。

ProductGroupView

产品组视图。

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

string

商品组视图的资源名称。产品组视图资源名称采用以下格式：

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

购物广告效果视图。提供在多个产品维度级别汇总的购物广告系列统计信息。来自 Merchant Center 的商品维度值（例如品牌、类别、自定义属性、商品状况和商品类型）将反映相应事件记录时的每个维度的状态。

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

string

购物广告效果视图的资源名称。购物广告效果视图资源名称采用以下格式：customers/{customerId}/shoppingPerformanceView

UserList

用户列表。这是客户可以定位的用户列表。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
字段
resourceName

string

用户列表的资源名称。用户列表资源名称采用以下格式：

customers/{customerId}/userLists/{user_list_id}
type

enum (UserListType)

相应列表的类型。

此字段为只读字段。
id

string (int64 format)

用户列表的 ID。
name

string

相应用户名单的名称。根据其 access_reason，用户列表名称可能不是唯一的（例如，如果 access_reason=SHARED）

UserListType

包含可能的用户列表类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
REMARKETING 以转化类型集合形式表示的 UserList。
LOGICAL 以其他用户名单/兴趣组合形式表示的用户名单。
EXTERNAL_REMARKETING 在 Google Ad Manager 平台中创建的用户名单。
RULE_BASED 与规则关联的 UserList。
SIMILAR 包含与另一个 UserList 中的用户类似的用户。
CRM_BASED 广告客户以电子邮件或其他格式提供的第一方 CRM 数据的 UserList。

UserLocationView

用户位置信息视图。

“用户地理位置”视图包含在国家/地区一级汇总的所有指标，每个国家/地区对应一行。它会按定位到或未定位到的地理位置，报告基于用户实际所在地理位置的指标。如果使用其他细分字段，您可能会获得每个国家/地区的多行数据。

JSON 表示法 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
字段
resourceName

string

用户位置信息视图的资源名称。UserLocation 视图资源名称采用以下格式：

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

国家/地区的条件 ID。
targetingLocation

boolean

指明是否定位了营业地点。

WebpageView

网页浏览量。

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

string

网页视图的资源名称。网页视图资源名称采用以下格式：

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

访问

一次访问。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
字段
resourceName

string

相应访问的资源名称。访问资源名称的格式为：

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}
id

string (int64 format)

相应访问的 ID。
criterionId

string (int64 format)

Search Ads 360 关键字 ID。值为 0 表示关键字未归因。
merchantId

string (int64 format)

包含获得点击的商品的 Search Ads 360 商品目录账号 ID。当您在 Search Ads 360 中关联商品目录账号时，Search Ads 360 会生成此 ID。
adId

string (int64 format)

广告 ID。值为 0 表示广告未归因。
clickId

string

作为点击 ID 网址参数传递到着陆页的每次访问的唯一字符串。
visitDateTime

string

相应访问事件的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。
productId

string

被点击的商品的 ID。
productChannel

enum (ProductChannel)

获得点击的商品的销售渠道：线上或本地。
productLanguageCode

string

为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。
productStoreId

string

获得点击的本地商品目录广告中的商店。此 ID 应与本地商品 Feed 中使用的商店 ID 一致。
productCountryCode

string

为包含获得点击的商品的商品目录 Feed 注册的国家/地区（ISO-3166 格式）。
assetId

string (int64 format)

访问事件期间发生互动的资产的 ID。
assetFieldType

enum (AssetFieldType)

访问事件的素材资源字段类型。

ProductChannel

用于描述商品优惠的本地化设置的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ONLINE 商品在线销售。
LOCAL 商品在本地商店中销售。

转化

转化。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
字段
resourceName

string

相应转化操作的资源名称。转化资源名称采用以下格式：

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}
id

string (int64 format)

转化的 ID
criterionId

string (int64 format)

Search Ads 360 条件 ID。值为 0 表示条件未归因。
merchantId

string (int64 format)

包含获得点击的商品的 Search Ads 360 商品目录账号 ID。当您在 Search Ads 360 中关联商品目录账号时，Search Ads 360 会生成此 ID。
adId

string (int64 format)

广告 ID。值为 0 表示广告未归因。
clickId

string

转化归因于的访问的唯一字符串，该字符串会作为点击 ID 网址参数传递到着陆页。
visitId

string (int64 format)

转化归因于的 Search Ads 360 访问 ID。
advertiserConversionId

string

对于线下转化，此 ID 由广告主提供。如果广告客户未指定此类 ID，Search Ads 360 会生成一个 ID。对于线上转化，这等于 ID 列或 floodlightOrderId 列，具体取决于广告客户的 Floodlight 指令。
productId

string

被点击的商品的 ID。
productChannel

enum (ProductChannel)

获得点击的商品的销售渠道：线上或本地。
productLanguageCode

string

为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。
productStoreId

string

获得点击的本地商品目录广告中的商店。此 ID 应与本地商品 Feed 中使用的商店 ID 一致。
productCountryCode

string

为包含获得点击的商品的商品目录 Feed 注册的国家/地区（ISO-3166 格式）。
attributionType

enum (AttributionType)

转化归因于的原因：访问或关键字+广告。
conversionDateTime

string

转化事件的时间戳。
conversionLastModifiedDateTime

string

转化上次修改的时间戳。
conversionVisitDateTime

string

转化归因于的访问的时间戳。
conversionQuantity

string (int64 format)

转化记录的商品数量，由 qty 网址参数确定。广告主负责动态填充该参数（如转化中售出的商品数量），否则默认为 1。
conversionRevenueMicros

string (int64 format)

转化事件的调整后收入（以微为单位）。此字段始终采用广告投放账号所用的币种。
floodlightOriginalRevenue

string (int64 format)

在修改 Floodlight 货币指令之前，与 Floodlight 事件关联的未更改的原始收入（采用当前报告所用的币种）。
floodlightOrderId

string

广告主为转化提供的 Floodlight 订单 ID。
status

enum (ConversionStatus)

转化的状态，可以是 ENABLED 或 REMOVED。
assetId

string (int64 format)

转化事件期间发生互动的素材资源的 ID。
assetFieldType

enum (AssetFieldType)

转化事件的素材资源字段类型。

AttributionType

SearchAds360 中的转化归因类型

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
VISIT 转化归因于某次访问。
CRITERION_AD 转化归因于条件和广告对。

ConversionStatus

转化的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 相应转化已启用。
REMOVED 相应转化已移除。

指标

指标数据。

JSON 表示法 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
字段
allConversionsValueByConversionDate

number

所有转化的值。 如果选择此列并同时选择日期列，则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/sa360/answer/9250611。
allConversionsByConversionDate

number

转化总次数。包括所有转化，无论 includeInConversionsMetric 的值如何。如果选择此列并同时选择日期列，则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/sa360/answer/9250611。
conversionCustomMetrics[]

object (Value)

转化自定义指标。
conversionsValueByConversionDate

number

按转化日期计算的可出价转化的价值总和。如果同时选择此列和日期列，则日期列中的值表示转化日期。
conversionsByConversionDate

number

可出价转化类型的转化次数（按转化日期）。由于归因模型，可以是小数。如果同时选择此列和日期列，则日期列中的值表示转化日期。
historicalCreativeQualityScore

enum (QualityScoreBucket)

广告素材的历史质量得分。
historicalLandingPageQualityScore

enum (QualityScoreBucket)

历史着陆页体验的质量。
historicalSearchPredictedCtr

enum (QualityScoreBucket)

历史搜索预测点击率 (CTR)。
interactionEventTypes[]

enum (InteractionEventType)

付费和免费互动的类型。
rawEventConversionMetrics[]

object (Value)

原始事件转化指标。
absoluteTopImpressionPercentage

number

“搜索网络绝对页首展示次数份额”是指搜索广告在最显眼的搜索广告位置获得的展示次数所占的百分比。
allConversionsFromInteractionsRate

number

互动带来的所有转化（与浏览型转化不同）次数除以广告互动次数。
allConversionsValue

number

所有转化的值。
allConversions

number

转化总次数。包括所有转化，无论 includeInConversionsMetric 的值如何。
allConversionsValuePerCost

number

所有转化的价值除以广告互动的总费用（例如文字广告的点击费用或视频广告的观看费用）。
allConversionsFromClickToCall

number

用户在广告展示过程中或点击广告后，点击“致电”按钮向相应实体店致电的次数。此数值不考虑致电是否接通，也不考虑通话时长。

此指标仅适用于 Feed 商品。
allConversionsFromDirections

number

用户在点击广告后，点击“查询路线”按钮导航到相应商店的次数。

此指标仅适用于 Feed 商品。
allConversionsFromInteractionsValuePerInteraction

number

互动带来的所有转化的价值除以互动总次数。
allConversionsFromMenu

number

用户在点击广告后，点击链接查看相应实体店的菜单的次数。

此指标仅适用于 Feed 商品。
allConversionsFromOrder

number

用户在点击广告后，在相应商店下单的次数。

此指标仅适用于 Feed 商品。
allConversionsFromOtherEngagement

number

用户在点击广告后发生的其他转化（例如，发布对商店的评价或保存该商店的地理位置）的次数。

此指标仅适用于 Feed 商品。
allConversionsFromStoreVisit

number

用户在点击广告后光顾实体店的次数估算值。

此指标仅适用于 Feed 商品。
visits

number

Search Ads 360 成功记录并转到广告主着陆页的点击次数。
allConversionsFromStoreWebsite

number

用户在点击广告后，转到相应商店网址的次数。

此指标仅适用于 Feed 商品。
averageCost

number

您为每次互动支付的平均金额。此金额是广告的总费用除以互动总次数。
averageCpc

number

所有点击的总费用除以获得的总点击次数。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
averageCpm

number

平均每千次展示费用 (CPM)。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
clicks

string (int64 format)

点击次数。
contentBudgetLostImpressionShare

number

您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意：内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
contentImpressionShare

number

您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意：内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
contentRankLostImpressionShare

number

您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意：内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
conversionsFromInteractionsRate

number

每次符合转化条件的互动带来的平均可出价转化次数（来自互动）。显示的是广告互动促成可出价转化的平均频率。
clientAccountConversionsValue

number

客户账号转化的值。这仅包括 includeInClientAccountConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversionsValuePerCost

number

可出价的转化价值除以符合转化条件的互动的总费用。
conversionsFromInteractionsValuePerInteraction

number

互动带来的转化价值除以广告互动次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
clientAccountConversions

number

客户账号转化次数。这仅包括 includeInClientAccountConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
costMicros

string (int64 format)

在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
costPerAllConversions

number

广告互动费用除以所有转化次数。
costPerConversion

number

每次可出价转化的平均符合转化条件的费用。
costPerCurrentModelAttributedConversion

number

广告互动费用除以当前模型归因转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
crossDeviceConversions

number

转化是指客户在一台设备上点击广告，然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 allConversions 中。
crossDeviceConversionsByConversionDate

number

按转化日期统计的跨设备转化次数。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/sa360/answer/9250611。
crossDeviceConversionsValue

number

跨设备转化的值的总和。
crossDeviceConversionsValueByConversionDate

number

按转化日期计算的跨设备转化价值的总和。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/sa360/answer/9250611。
ctr

number

广告获得的点击次数（点击次数）除以广告展示次数（展示次数）。
conversions

number

转化次数。这仅包括 includeInConversionsMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversionsValue

number

“转化”字段中包含的转化带来的转化价值总和。要使用此指标，您必须为各项转化操作输入转化价值。
averageQualityScore

number

平均质量得分。
historicalQualityScore

string (int64 format)

历史质量得分。
impressions

string (int64 format)

广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。
interactionRate

number

在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。
interactions

string (int64 format)

互动次数。互动是指与某种广告格式关联的主用户操作：对于文字广告和购物广告而言是点击，对于视频广告而言是观看，诸如此类。
invalidClickRate

number

报告期内从总点击次数（过滤后 + 未过滤的点击次数）过滤出的点击次数所占的百分比。
invalidClicks

string (int64 format)

Google 认为不合规定且不向您收费的点击次数。
generalInvalidClickRate

number

从总点击次数（过滤后 + 未过滤的点击次数）中滤除的常规无效点击次数所占的百分比。这些是 Google 认为非法的点击次数，是通过常规滤除方式（即已知无效的数据中心流量、漫游器和“蜘蛛”程序或其他抓取工具、不规则模式等）检测到的。我们不会向您收取这些点击的费用，您的账户统计信息也不会受其影响。如需了解详情，请参阅 https://support.google.com/campaignmanager/answer/6076504 提供的帮助页面。
generalInvalidClicks

string (int64 format)

常规无效点击次数。这些是通过常规滤除方式（例如已知无效的数据中心流量、漫游器和“蜘蛛”程序或其他抓取工具、不规则模式等）检测到的无效点击子集。我们不会向您收取这些点击的费用，您的账户统计信息也不会受其影响。如需了解详情，请参阅 https://support.google.com/campaignmanager/answer/6076504 提供的帮助页面。
mobileFriendlyClicksPercentage

number

适合移动设备的页面的移动点击次数所占的百分比。
searchAbsoluteTopImpressionShare

number

在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情，请参阅 https://support.google.com/sa360/answer/9566729。任何低于 0.1 的值都会报告为 0.0999。
searchBudgetLostAbsoluteTopImpressionShare

number

此数字用于估算您的广告因预算不足而未能在搜索结果中的页首广告中作为头条广告进行展示的频率。注意：搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchBudgetLostImpressionShare

number

您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意：搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchBudgetLostTopImpressionShare

number

此数字用于估算您的广告由于预算低而未在顶部自然搜索结果邻近位置展示的频率。注意：搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchClickShare

number

您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意：搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchExactMatchImpressionShare

number

对于与关键字完全匹配（或是关键字的紧密变体形式）的搜索字词，此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意：搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchImpressionShare

number

您在搜索网络中获得的展示次数除以您有资格获得的估算展示次数。注意：在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchRankLostAbsoluteTopImpressionShare

number

此数字用于估算您的广告因广告评级较低而未能在搜索结果中的页首广告中作为头条广告进行展示的频率。注意：搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchRankLostImpressionShare

number

您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意：搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchRankLostTopImpressionShare

number

此数字用于估算您的广告由于广告评级差而未出现在顶部自然搜索结果邻近位置的频率。注意：搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchTopImpressionShare

number

您在页首广告中实际获得的展示次数除以您有资格在页首广告中获得的估算展示次数所得到的百分比。注意：搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

页首广告通常展示在顶部自然搜索结果上方，但在某些查询中，页首广告可能会展示在顶部自然搜索结果下方。
topImpressionPercentage

number

广告在邻近顶部自然搜索结果的位置展示的次数所占百分比。
valuePerAllConversions

number

所有转化的价值除以所有转化的次数。
valuePerAllConversionsByConversionDate

number

所有转化的价值除以所有转化的次数。如果选择此列并同时选择日期列，则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/sa360/answer/9250611。
valuePerConversion

number

可出价转化的价值除以可出价转化的次数。显示每种可出价的转化的平均价值。
valuePerConversionsByConversionDate

number

按转化日期划分的可出价转化的价值除以按转化日期划分的可出价转化次数。显示每次可出价转化的平均价值（按转化日期）。如果同时选择此列和日期列，则日期列中的值表示转化日期。
clientAccountViewThroughConversions

string (int64 format)

浏览型转化总次数。当客户看到图片或富媒体广告，之后在您的网站上完成转化而不与另一个广告互动（例如，点击）时，就会发生这种情况。
clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

“客户账号交叉销售产品的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。此订单的作为交叉销售产品时的销货成本为 5 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
crossSellCostOfGoodsSoldMicros

string (int64 format)

“作为交叉销售产品时的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。此订单的作为交叉销售产品时的销货成本为 5 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
clientAccountCrossSellGrossProfitMicros

string (int64 format)

“客户账号交叉销售产品的毛利润”是指因广告宣传某产品而售出的其他产品时，所产生的销售收入减去销货成本 (COGS) 后给您带来的利润。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。衬衫的价格为 20 美元，其销货成本价值为 5 美元。在这笔订单中，作为交叉销售产品时的毛利润就是：15 美元 = 20 美元 - 5 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
crossSellGrossProfitMicros

string (int64 format)

“作为交叉销售产品时的毛利润”是指因广告宣传某产品而售出的其他产品时，所产生的销售收入减去销货成本 (COGS) 后给您带来的利润。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。衬衫的价格为 20 美元，其销货成本价值为 5 美元。在这笔订单中，作为交叉销售产品时的毛利润就是：15 美元 = 20 美元 - 5 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
clientAccountCrossSellRevenueMicros

string (int64 format)

“客户账号交叉销售收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的收入就是广告促成的交叉销售所产生的总价值。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为交叉销售产品时的收入为 20 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
crossSellRevenueMicros

string (int64 format)

“作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的收入就是广告促成的交叉销售所产生的总价值。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为交叉销售产品时的收入为 20 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
clientAccountCrossSellUnitsSold

number

“客户账号交叉销售产品的销量”是指通过对其他产品进行广告宣传而售出的产品总数。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。
crossSellUnitsSold

number

“作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。
clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

“客户账号主打产品的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户互动过的广告含有关联产品（详见“购物广告”），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些货品的成本会计入“作为主推产品时的销货成本”。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。在这笔订单中，作为主推产品时的销货成本为 3 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
leadCostOfGoodsSoldMicros

string (int64 format)

“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户互动过的广告含有关联产品（详见“购物广告”），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些货品的成本会计入“作为主推产品时的销货成本”。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。在这笔订单中，作为主推产品时的销货成本为 3 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
clientAccountLeadGrossProfitMicros

string (int64 format)

“客户账号作为主推产品时的毛利润”是指因广告宣传某产品而售出同一产品时，所产生的销售收入减去销货成本 (COGS) 后给您带来的利润。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些销售所产生的收入减去销货成本就是作为主推产品时的毛利润。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的价格为 10 美元，其销货成本价值为 3 美元。在这笔订单中，作为主推产品时的毛利润就是：7 美元 = 10 美元 - 3 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
leadGrossProfitMicros

string (int64 format)

“作为主推产品时的毛利润”是指因广告宣传某产品而售出同一产品时，所产生的销售收入减去销货成本 (COGS) 后给您带来的利润。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些销售所产生的收入减去销货成本就是作为主推产品时的毛利润。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的价格为 10 美元，其销货成本价值为 3 美元。在这笔订单中，作为主推产品时的毛利润就是：7 美元 = 10 美元 - 3 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
clientAccountLeadRevenueMicros

string (int64 format)

“客户账号主推产品的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品一致，那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为主推产品时的收入为 10 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
leadRevenueMicros

string (int64 format)

“作为主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品一致，那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为主推产品时的收入为 10 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 参数
clientAccountLeadUnitsSold

number

“客户账号作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品一致，那么这些售出产品的总数会计入“作为主推产品时的销量”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。
leadUnitsSold

number

“作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式：客户在您网站上完成购买交易后，您需要报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品一致，那么这些售出产品的总数会计入“作为主推产品时的销量”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。
uniqueUsers

string (int64 format)

在所请求的时间段内，看到您广告的唯一身份用户数量。此指标无法进行汇总，只能针对 92 天以内的时间范围进行请求。此指标适用于以下广告系列类型：展示广告系列、视频广告系列、发现广告系列和应用广告系列。
averageImpressionFrequencyPerUser

number

在所请求的时间段内，唯一身份用户看到您广告的平均次数。此指标无法进行汇总，只能针对 92 天以内的时间范围进行请求。此指标适用于以下广告系列类型：展示广告系列、视频广告系列、发现广告系列和应用广告系列。

值

一种通用数据容器。

JSON 表示法 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
字段
联合字段 value。一个值。value 只能是下列其中一项：
booleanValue

boolean

布尔值。
int64Value

string (int64 format)

一个 int64。
floatValue

number

浮点数。
doubleValue

number

双精度型。
stringValue

string

它是一个字符串。

QualityScoreBucket

枚举，列出了可能的质量得分区间。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
BELOW_AVERAGE 广告素材质量低于平均水平。
AVERAGE 广告素材质量一般。
ABOVE_AVERAGE 广告素材的质量高于平均水平。

InteractionEventType

枚举，用于描述可能的付费和免费互动类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
CLICK 点击“前往网站”。在大多数情况下，此互动会导航到外部位置，通常是广告客户的着陆页。这也是点击事件的默认 InteractionEventType。
ENGAGEMENT 用户表达的就地与广告互动的意图。
VIDEO_VIEW 用户观看了视频广告。
NONE 广告转化事件的默认 InteractionEventType。当广告转化行未指明免费互动（例如广告转化）应“升级”并作为核心指标的一部分进行报告时，系统会使用此值。这些只是其他（广告）转化。

细分

仅细分字段。

JSON 表示法 
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
字段
adNetworkType

enum (AdNetworkType)

广告网络类型。
conversionActionCategory

enum (ConversionActionCategory)

转化操作类别。
conversionCustomDimensions[]

object (Value)

转化自定义维度。
dayOfWeek

enum (DayOfWeek)

星期几，例如 MONDAY。
device

enum (Device)

指标应用于的设备。
keyword

object (Keyword)

关键字条件。
productChannel

enum (ProductChannel)

商品的渠道。
productChannelExclusivity

enum (ProductChannelExclusivity)

商品的渠道独占性。
productCondition

enum (ProductCondition)

商品的使用情况。
productSoldCondition

enum (ProductCondition)

所售商品的使用情况。
rawEventConversionDimensions[]

object (Value)

原始事件转化维度。
conversionAction

string

转化操作的资源名称。
conversionActionName

string

转化操作名称。
date

string

指标适用的日期。yyyy-MM-dd 格式，例如 2018-04-17。
geoTargetCity

string

表示城市的地理位置定位目标常量的资源名称。
geoTargetCountry

string

代表国家/地区的地理位置定位目标常量的资源名称。
geoTargetMetro

string

代表都市圈的地理位置定位目标常量的资源名称。
geoTargetRegion

string

代表区域的地理位置定位目标常量的资源名称。
hour

integer

以介于 0 到 23 之间（包括 0 和 23）的数字表示的时段。
month

string

由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。
productBiddingCategoryLevel1

string

商品的出价类别（第 1 级）。
productBiddingCategoryLevel2

string

商品的出价类别（第 2 级）。
productBiddingCategoryLevel3

string

商品的出价类别（第 3 级）。
productBiddingCategoryLevel4

string

商品的出价类别（第 4 级）。
productBiddingCategoryLevel5

string

商品的出价类别（第 5 级）。
productBrand

string

商品的品牌。
productCountry

string

商品目标销售国家/地区的地理位置定位目标常量的资源名称。
productCustomAttribute0

string

商品的自定义属性 0。
productCustomAttribute1

string

商品的自定义属性 1。
productCustomAttribute2

string

商品的自定义属性 2。
productCustomAttribute3

string

商品的自定义属性 3。
productCustomAttribute4

string

商品的自定义属性 4。
productItemId

string

商品的项目 ID。
productLanguage

string

商品语言的语言常量的资源名称。
productSoldBiddingCategoryLevel1

string

所售商品的出价类别（第 1 级）。
productSoldBiddingCategoryLevel2

string

所售商品的出价类别（第 2 级）。
productSoldBiddingCategoryLevel3

string

所售商品的出价类别（第 3 级）。
productSoldBiddingCategoryLevel4

string

所售商品的出价类别（第 4 级）。
productSoldBiddingCategoryLevel5

string

所售商品的出价类别（第 5 级）。
productSoldBrand

string

所售商品的品牌。
productSoldCustomAttribute0

string

所售商品的自定义属性 0。
productSoldCustomAttribute1

string

所售商品的自定义属性 1。
productSoldCustomAttribute2

string

所售商品的自定义属性 2。
productSoldCustomAttribute3

string

所售商品的自定义属性 3。
productSoldCustomAttribute4

string

所售商品的自定义属性 4。
productSoldItemId

string

所售商品的商品 ID。
productSoldTitle

string

所售商品的名称。
productSoldTypeL1

string

所售商品的类型（第 1 级）。
productSoldTypeL2

string

所售商品的类型（第 2 级）。
productSoldTypeL3

string

所售商品的类型（第 3 级）。
productSoldTypeL4

string

所售商品的类型（第 4 级）。
productSoldTypeL5

string

所售商品的类型（第 5 级）。
productStoreId

string

商品的商店 ID。
productTitle

string

商品的名称。
productTypeL1

string

商品的类型（第 1 级）。
productTypeL2

string

商品的类型（第 2 级）。
productTypeL3

string

商品的类型（第 3 级）。
productTypeL4

string

商品的类型（第 4 级）。
productTypeL5

string

商品的类型（第 5 级）。
quarter

string

由一个季度第一天的日期表示的季度。对季度使用日历年，例如 2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。
week

string

定义为星期一到星期日的一周，由星期一的日期表示。格式为 yyyy-MM-dd。
year

integer

年份，格式为 yyyy。
assetInteractionTarget

object (AssetInteractionTarget)

仅与 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标搭配使用。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。当广告本身与其他组成部分（例如站内链接）一起投放时，系统会统计广告所有部分的互动次数（例如点击次数）。如果 interactionOnThisAsset 为 true，则表示互动发生在相应素材资源上；如果 interactionOnThisAsset 为 false，则表示互动不是发生在相应素材资源上，而是发生在投放的广告中包含相应素材资源的其他部分上。

AdNetworkType

列举 Google Ads 网络类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
SEARCH Google 搜索。
SEARCH_PARTNERS 搜索合作伙伴。
CONTENT 展示广告网络。
YOUTUBE_WATCH YouTube 视频
MIXED 跨广告网络。

关键字

关键字条件细分。

JSON 表示法 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
字段
info

object (KeywordInfo)

关键字信息。
adGroupCriterion

string

AdGroupCriterion 资源名称。

ProductChannelExclusivity

用于描述商品优惠的供应情况的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
SINGLE_CHANNEL 商品仅通过一个渠道（实体店或线上）销售，具体取决于其 ProductChannel。
MULTI_CHANNEL 商品与相应的线上或本地商店商品相匹配，表明该商品可通过两种 ShoppingProductChannel 购买。

ProductCondition

用于描述商品优惠状况的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
OLD 商品的使用情况为“旧”。
NEW 商品是全新商品。
REFURBISHED 商品状况为翻新。
USED 商品状况为二手。

AssetInteractionTarget

AssetInteractionTarget 段。

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

string

相应素材资源的资源名称。
interactionOnThisAsset

boolean

仅与 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标搭配使用。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。