SearchAds360Row

查询返回的行。

JSON 表示法 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "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)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
字段
adGroup

object (AdGroup)

查询中引用的广告组。
adGroupAd

object (AdGroupAd)

查询中引用的广告。
adGroupAdLabel

object (AdGroupAdLabel)

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

object (AdGroupAsset)

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

object (AdGroupAssetSet)

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

object (AdGroupAudienceView)

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

object (AdGroupBidModifier)

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

object (AdGroupCriterion)

查询中引用的条件。
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)

查询中引用的用户列表。
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,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
字段
resourceName

string

广告组的资源名称。广告组资源名称的格式如下：

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

enum (AdGroupStatus)

广告组的状态。
type

enum (AdGroupType)

广告组的类型。
adRotationMode

enum (AdGroupAdRotationMode)

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

string

创建此广告组时的时间戳。时间戳采用客户的时区，并采用“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）。
cpcBidMicros

string (int64 format)

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

enum (AdGroupEngineStatus)

广告组的引擎状态。

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

指示是将您的广告限制为仅根据您为此 targetingDimension 选择的条件进行展示，还是定位到此 targetingDimension 的所有值，并根据您在其他 targetingDimension 中的定位条件展示广告。如果值为 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
  ],
  "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

附加到此广告组广告的标签的资源名称。
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

AdGroupAd 的可能状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

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

这是仅限响应的值。
ENABLED 广告组广告已启用。
PAUSED 广告组中的广告已暂停。
REMOVED 该广告组的广告会被移除。

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

使用分隔符附加到路径 1 的文本。
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

使用分隔符附加到路径 1 的文本。
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 由于广告组暂停，广告素材也已暂停。

AdGroupAdLabel

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

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

string

广告组广告标签的资源名称。广告组广告标签资源名称采用以下格式：customers/{customerId}/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
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "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

广告组条件所附标签的资源名称。
positionEstimates

object (PositionEstimates)

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

string

广告的所有跨网域重定向之后可能存在的最终到达网址列表。
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 由于账号处于暂停状态，因此此条件也已暂停。

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 参数网站条件等于被比较的网站条件。
CONTAINS 实参网站条件是被比较的网站条件的一部分。

LocationInfo

地理位置条件。

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

string

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

AdGroupCriterionLabel

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

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

string

广告组条件标签的资源名称。广告组条件标签资源名称采用以下格式：customers/{customerId}/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/{customerId}/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/{customerId}/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
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": 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

所有跨网域重定向之后可能存在的最终到达网址列表。
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

用于构建跟踪网址的网址模板。
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

下一个 ID = 11

枚举
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 MIME 类型为 image/jpeg。
IMAGE_GIF 图片/gif 的 MIME 类型。
IMAGE_PNG MIME 类型为 image/png。
FLASH MIME 类型为 application/x-shockwave-flash。
TEXT_HTML text/html MIME 类型。
PDF MIME 类型为 application/pdf。
MSWORD application/msword MIME 类型。
MSEXCEL MIME 类型为 application/vnd.ms-excel。
RTF MIME 类型为 application/rtf。
AUDIO_WAV MIME 类型为 audio/wav。
AUDIO_MP3 MIME 类型为 audio/mp3。
HTML5_AD_ZIP MIME 类型为 application/x-html5-ad-zip。

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 之间（包括这两个数值）。

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

integer

结束时间（采用 24 小时制）；24 表示一天结束。此字段必须介于 0 到 24 之间（包括这两个数值）。

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

MinuteOfHour

枚举了四分之一小时。例如："FIFTEEN"

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
ZERO 整点过后零分钟。
FIFTEEN 整点过后十五分钟。
THIRTY 整点过后三十分钟。
FORTY_FIVE 整点过后四十五分钟。

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 App Store 的移动应用供应商。
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 该素材资源已关联，用作指定旅行目标的效果最大化广告系列中的酒店房源。

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

素材资源组“效果最佳的组合”视图的资源名称。素材资源组热门组合视图资源名称采用以下格式：“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 该素材资源会用作潜在客户表单。

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)

一种出价策略，可为您设置合适的出价，在不超出您设置的目标每次转化费用 (CPA) 的前提下，帮您获得尽可能多的转化。
targetImpressionShare

object (TargetImpressionShare)

一种出价策略，可自动针对所选的展示次数百分比进行优化。
targetOutrankShare

object (TargetOutrankShare)

此出价策略会根据广告客户应在竞价中胜过特定竞争对手的目标百分比来设置出价。该字段已弃用。使用此字段创建新的出价策略或将包含此字段的出价策略附加到广告系列将会失败。允许对已填充此架构的策略进行突变。
targetRoas

object (TargetRoas)

这种出价策略有助于您在尽可能提高收入的同时，尽可能使平均广告支出回报率等于您设置的目标回报率。
targetSpend

object (TargetSpend)

一种出价策略，会设置您的出价来帮助您在不超出预算的前提下争取尽可能多的点击。

BiddingStrategyStatus

BiddingStrategy 的可能状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

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

这是仅限响应的值。
ENABLED 出价策略已启用。
REMOVED 该出价策略会被移除。

BiddingStrategyType

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

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
COMMISSION 佣金是一种自动出价策略，广告客户需要支付转化价值的一定比例。
ENHANCED_CPC 智能点击付费是一种出价策略，会针对更有可能促成转化的点击提高出价，并针对不太可能促成转化的点击降低出价。
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

此类型没有字段。

这是一种自动出价策略，会针对更有可能带来转化的点击提高出价，并针对不太可能带来转化的点击降低出价。

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

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) 选项。这是您愿意为每次转化操作支付的平均金额，以出价策略所用币种的微单位指定。如果设置了此出价策略，系统会在不超出目标每次转化费用的前提下，争取尽可能多的转化。如果未设置目标 CPA，出价策略会致力于在指定预算范围内实现尽可能低的 CPA。

TargetCpa

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

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,
  "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”格式。
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 或商家数据 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）和/或 SSC 的再营销名单。
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.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 Play、YouTube 和 Google 展示广告网络等 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 社交广告系列。

CustomParameter

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

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

string

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

string

要替换的值。

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 展示广告网络中的指定展示位置投放。展示位置使用 Placement 条件指定。
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，该 FeedLabel 字段接受相同格式的国家/地区代码，例如：“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

用于动态跟踪的网址。

ManualCpa

此类型没有字段。

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

ManualCpc

按点击次数手动出价，用户按点击次数付费。

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

boolean

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

ManualCpm

此类型没有字段。

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

PercentCpc

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

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

string (int64 format)

可通过出价策略设置的出价上限。这是一个可选字段，由广告客户输入并以本地微单位指定。注意：零值的解释方式与未定义 bid_floor 的解释方式相同。
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 英里

CampaignEffectiveLabel

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

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

string

资源的名称。广告系列有效标签资源名称的格式为：customers/{customerId}/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/{customerId}/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 的转化。只读。
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) 智能目标。适用于 GA、Firebase、GA 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

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

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

转化自定义变量正在等待启用，只有在设为“启用”后才会累积统计信息。

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

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 表示“Number”类型的 Floodlight 变量。此变量可分配给 DIMENSION 或 METRIC 类型的 Floodlight 变量。
STRING 表示“字符串”类型的 Floodlight 变量。此变量可分配给维度类型的 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,
  "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”格式。
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。客户选择启用转化跟踪时，系统会设置此 ID，并将其替换为 conversionTrackingId。此字段只能通过 Google Ads 界面进行管理。此字段为只读字段。
crossAccountConversionTrackingId

string (int64 format)

客户经理的转化跟踪 ID。客户选择启用跨账号转化跟踪后，系统会设置此 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 表示已关闭的账号无法投放广告。测试账号的状态也会变为“已关闭”。状态为永久性，且无法重新打开。

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

表示由客户拥有并与客户共享的出价策略的视图。

与 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

拥有该出价策略的客户的描述性名称。

联合字段 scheme。出价方案。

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

object (MaximizeConversionValue)

这是一种自动出价策略，可帮助您在预算范围内为广告系列争取尽可能高的转化价值。
maximizeConversions

object (MaximizeConversions)

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

object (TargetCpa)

一种出价策略，可为您设置合适的出价，在不超出您设置的目标每次转化费用 (CPA) 的前提下，帮您获得尽可能多的转化。
targetImpressionShare

object (TargetImpressionShare)

一种出价策略，可自动根据所选百分比的展示次数进行优化。
targetRoas

object (TargetRoas)

这种出价策略有助于您在尽可能提高收入的同时，尽可能使平均广告支出回报率等于您设置的目标回报率。
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

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

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/{customerId}/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

语言的全称（英语），例如“英语（美国）”“西班牙语”等。
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 相当于 https://support.google.com/merchants/answer/6324436 一文中所述的 google_product_category ID。
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 表示为其他用户列表/兴趣组合的 UserList。
EXTERNAL_REMARKETING 在 Google Ad Manager 平台中创建的 UserList。
RULE_BASED 与规则关联的 UserList。
SIMILAR 包含与另一个 UserList 中的用户相似的用户的 UserList。
CRM_BASED 广告客户以电子邮件或其他格式提供的第一方 CRM 数据的 UserList。

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
}
字段
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)。此指标是一个货币值，默认以客户的币种返回。如需了解 metrics_currency 参数，请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
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) 之和。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
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 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币价值，默认情况下以客户的货币返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellCostOfGoodsSoldMicros

string (int64 format)

“作为交叉销售产品时的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。在这笔订单中，作为交叉销售产品时的销货成本为 5 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellGrossProfitMicros

string (int64 format)

“客户账号作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后，因广告宣传某产品而售出的其他产品给您带来的利润。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（参见购物广告），此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。衬衫的价格为 20 美元，其销货成本价值为 5 美元。在这笔订单中，作为交叉销售产品时的毛利润就是：15 美元 = 20 美元 - 5 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需了解 metrics_currency 参数，请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellGrossProfitMicros

string (int64 format)

“作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后，因广告宣传某产品而售出的其他产品给您带来的利润。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。衬衫的价格为 20 美元，其销货成本价值为 5 美元。在这笔订单中，作为交叉销售产品时的毛利润就是：15 美元 = 20 美元 - 5 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellRevenueMicros

string (int64 format)

“客户账号作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售所产生的总价值。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为交叉销售产品时的收入为 20 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需了解 metrics_currency 参数，请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellRevenueMicros

string (int64 format)

“作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（参见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售所产生的总价值。示例：某个用户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为交叉销售产品时的收入为 20 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币值，默认以客户的币种返回。如需了解 metrics_currency 参数，请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellUnitsSold

number

“客户账号作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。
crossSellUnitsSold

number

“作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。
clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些货品的成本会计入“作为主推产品时的销货成本”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。在这笔订单中，作为主推产品时的销货成本为 3 美元。该指标仅在您报告含购物车数据的转化的情况下可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadCostOfGoodsSoldMicros

string (int64 format)

“作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些货品的成本会计入“作为主推产品时的销货成本”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。在这笔订单中，作为主推产品时的销货成本为 3 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
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 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币价值，默认情况下以客户的货币返回。如需了解 metrics_currency 参数，请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadUnitsSold

number

客户账号中“作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（参见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些售出产品的总数会计入“作为主推产品时的销量”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。
leadUnitsSold

number

“作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些售出产品的总数会计入“作为主推产品时的销量”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。

值

通用数据容器。

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)

星期几，例如星期一。
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 跨广告网络。

Keyword

关键字条件细分。

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 指标。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。