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)
  },
  "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)
  },
  "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)

查询中引用的广告组条件标签。
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)

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

自定义列。

AdGroup

广告组。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    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

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

每次点击费用出价上限。
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 的所有值，并根据您在其他 TargetingDimensions 中的定位展示广告。如果值为 true，则表示这些条件将仅应用出价调节系数，而不会影响定位。值为 false 表示这些条件将限制定位以及应用出价调节系数。

TargetingDimension

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

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
KEYWORD 关键字条件，例如“火星游轮”。“KEYWORD”可用作自定义出价维度。关键字始终是定位维度，因此不能通过 TargetRestriction 设置为目标“ALL”维度。
AUDIENCE 受众群体条件，包括用户名单、用户兴趣、自定义的兴趣相似细分受众群和自定义的有购买意向的受众群体。
TOPIC 用于定位内容类别的主题条件，例如“category::动物>宠物”。用于展示广告和视频定位。
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 视频发现广告。

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 表示法 
{
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
字段
path1

string

附加到自动生成的显示网址中的文字，其中含有分隔符。
path2

string

附加到路径 1 并带有分隔符的文本。
adTrackingId

string (int64 format)

广告的跟踪 ID。

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
}
字段
resourceName

string

广告组广告标签的资源名称。广告组广告标签资源名称的格式为：customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

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

string

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

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 将素材资源集与广告组相关联。

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

广告组条件。adGroup 标准报告仅返回明确添加到广告组的标准。

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 实体，请改用“adGroupcriteria.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)

有效每次点击费用出价。
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

CocoaPods 的可能状态。

枚举
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 自定义的意向受众群体。
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

枚举 CocoaPods 引擎状态。

枚举
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

通过此参数定义的标准的名称。name 值将用于确定、排序和过滤此类参数的条件。

此字段对 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
}
字段
resourceName

string

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

string

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

string

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

AdGroupLabel

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

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

string

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

string

标签附加到的广告组。
label

string

分配给广告组的标签。

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)

统一的地址素材资源。

AssetType

描述可能的资产类型的枚举。

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

ImageDimension

特定尺寸的图片的元数据，可以是原始图片，也可以是调整大小后的图片。

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

string (int64 format)

图片的高度。
widthPixels

string (int64 format)

图片的宽度。
url

string

可返回具有指定高度和宽度的图片的网址。

TextAsset

文字素材资源。

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

string

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

UnifiedCalloutAsset

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

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

string

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

string

此资源生效且可开始投放的开始日期，格式为 yyyy-MM-dd。
endDate

string

此素材资源有效且仍在投放的最后日期，格式为 yyyy-MM-dd。
adScheduleTargets[]

object (AdScheduleInfo)

一个不重叠的投放时间列表，用于指定素材资源可投放的所有时间间隔。每天最多可以设置 6 个时间表，总共 42 个。
useSearcherTimeZone

boolean

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

AdScheduleInfo

表示 AdSchedule 标准。

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

同一天最多只能添加 6 个 AdSchedule。

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

enum (MinuteOfHour)

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

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

enum (MinuteOfHour)

此投放时间结束的小时之后的分钟数。该时间表不包含结束分钟。

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

enum (DayOfWeek)

投放时间是星期几。

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

integer

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

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

integer

24 小时制的整点结束时间；24 表示一天结束。此字段必须介于 0 和 24 之间（含 0 和 24）。

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

MinuteOfHour

一刻钟的枚举。例如：“FIFTEEN”

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

DayOfWeek

枚举星期几，例如“Monday”。

枚举
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!Japan 字段。
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，例如“com.android.ebay”（对于 Android）或“12345689”（对于 iOS）。
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 号召性用语类型是 order 现在。
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)

素材资源在素材资源组中的展示位置的说明。例如：标题、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 [Google 商品类别] ID，如 https://support.google.com/merchants/answer/6324436 中所述

ListingGroupFilterBiddingCategoryLevel

产品信息组过滤条件出价类别的级别。

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

ProductBrand

商品的品牌。

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

string

产品品牌的字符串值。

ProductChannel

商品优惠的地域性。

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

enum (ListingGroupFilterProductChannel)

市行政区的值。

ListingGroupFilterProductChannel

用于描述商品优惠市行政区的枚举。

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

ProductCondition

商品的使用情况。

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

enum (ListingGroupFilterProductCondition)

条件的值。

ListingGroupFilterProductCondition

描述商品优惠条件的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NEW 商品使用情况为全新。
REFURBISHED 商品使用情况为翻新。
USED 使用产品条件。

ProductCustomAttribute

商品优惠的自定义属性。

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

enum (ListingGroupFilterCustomAttributeIndex)

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

string

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

ListingGroupFilterCustomAttributeIndex

客户属性的索引。

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

ProductItemId

商品优惠的商品 ID。

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

string

ID 的值。

ProductType

商品优惠的类型。

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

enum (ListingGroupFilterProductTypeLevel)

类型的级别。
value

string

类型的值。

ListingGroupFilterProductTypeLevel

描述商品优惠级别的枚举。

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

ListingGroupFilterDimensionPath

用于定义产品信息组过滤器的维度的路径。

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

object (ListingGroupFilterDimension)

维度从产品信息组过滤器层次结构（不包括根节点）到此产品信息组过滤器的完整路径。

AssetGroupTopCombinationView

广告组广告素材资源组合使用情况视图。

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

string

素材资源组顶部组合视图的资源名称。AssetGroup 顶部组合视图资源名称的格式如下："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 该素材资源用在了长标题中（在 MultiAsset 自适应 Ad 中使用）。
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)

一种出价策略，根据广告主的出价应高于特定竞争对手的出价所占的目标比例来设置出价。此字段已弃用。无法使用此字段创建新的出价策略，或向广告系列附加使用此字段的出价策略。允许对已填充此架构的策略执行 mutate 操作。
targetRoas

object (TargetRoas)

一种出价策略，可帮助您最大限度地提高收入，同时确保平均达到特定目标广告支出回报率 (ROAS)。
targetSpend

object (TargetSpend)

一种出价策略，用于为您设置适当的出价，在不超出预算的前提下为您争取尽可能多的点击。

BiddingStrategyStatus

BidStrategy 的可能状态。

枚举
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 “目标每次转化费用”是一种自动出价策略，可为您设置合适的出价来帮助您争取尽可能多的转化，同时将每次转化费用控制在您设定的目标水平。
TARGET_CPM “目标每千次展示费用”是一种自动出价策略，可为您设置合适的出价来帮助您争取尽可能多的展示次数，同时确保将每千次展示费用 (CPM) 控制在您设定的目标水平。
TARGET_IMPRESSION_SHARE 一种自动出价策略，它会设置出价，使特定百分比的搜索广告展示在首页（或其他定位到的地理位置）的顶部。
TARGET_OUTRANK_SHARE “排名胜出率目标”是一种自动出价策略，会根据广告主在竞价中超出特定竞争对手所占的目标比例来设置出价。此枚举值已弃用。
TARGET_ROAS “目标广告支出回报率”是一种自动出价策略，可帮助您尽可能提高收入，同时确保平均达到特定目标广告支出回报率 (ROAS)。
TARGET_SPEND “目标支出”是一种自动出价策略，使用该策略，系统会自动为您设置适当的出价，助您在不超出预算的前提下为您争取尽可能多的点击。

EnhancedCpc

此类型没有任何字段。

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

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

MaximizeConversionValue

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

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

string (int64 format)

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

string (int64 format)

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

number

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

MaximizeConversions

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

目标每次转化费用 (CPA) 选项。这是您愿意为每次转化操作支付的平均金额，以出价策略币种的微单位指定。如果设置了该出价策略，则该出价策略会在不超出目标每次转化费用的前提下争取尽可能多的转化。如果未设置目标 CPA，则出价策略会在给定的预算范围内，争取尽可能低的 CPA。

TargetCpa

一种自动出价策略，可为您设置合适的出价来帮助您争取尽可能多的转化，同时将每次转化费用控制在您设定的目标水平。

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

TargetImpressionShare

一种自动出价策略，它会设置出价，使特定百分比的搜索广告展示在首页（或其他定位到的地理位置）的顶部。

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

enum (TargetImpressionShareLocation)

搜索结果页上的定位到的地理位置。
locationFractionMicros

string (int64 format)

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

string (int64 format)

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

TargetImpressionShareLocation

描述可能目标的枚举。

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

TargetOutrankShare

一种自动出价策略，会根据广告主在竞价中超出特定竞争对手所占的目标比例来设置出价。此策略已弃用。

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

string (Int64Value format)

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

TargetRoas

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

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

number

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

string (int64 format)

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

string (int64 format)

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

TargetSpend

这是一种自动出价策略，可为您设置适当的出价，助您在不超出预算的前提下为您争取尽可能多的点击。

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

string (int64 format)

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

string (int64 format)

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

CampaignBudget

广告系列预算。

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

string

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

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

enum (BudgetDeliveryMethod)

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

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

enum (BudgetPeriod)

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

string (int64 format)

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

BudgetDeliveryMethod

预算的可能投放方式。

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

BudgetPeriod

预算的可能周期。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
DAILY 每日预算。
FIXED_DAILY 固定每日预算。
CUSTOM_PERIOD 自定义预算可与 total_amount 一起使用，以指定有效期预算限制。

广告系列

广告系列。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "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)

广告地理位置定位设置。
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”格式。v1 中将弃用 createTime。请改用 createTime。
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

BidStrategy 的可能系统状态。

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

AdServingOptimizationStatus

描述可能的服务状态的枚举。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知的值。

这是一个仅用于响应的值。
OPTIMIZE 已根据广告系列的点击率优化广告投放。
CONVERSION_OPTIMIZE 系统会根据广告系列的点击率 * 转化次数来优化广告投放。如果广告系列未采用转化优化工具出价策略，则默认为“优化”。
ROTATE 广告会在 90 天内均匀轮播，然后针对点击进行优化。
ROTATE_INDEFINITELY 更均匀地展示效果欠佳的广告和效果较好的广告，不进行优化。
UNAVAILABLE 广告投放优化状态未知。

AdvertisingChannelType

描述各种广告渠道类型的枚举。

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

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 搜索、YouTube 和 Google 展示广告网络等多个 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 “旅游活动”广告系列

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 展示广告网络中的指定展示位置投放。展示位置是使用“展示位置”条件指定的。
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 之间（含 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_曲目相同。
enhancedCpcEnabled

boolean

根据发生转化的可能性上下调整每次竞价的出价。各个出价可以超过 cpcBidCeilingMicros，但广告系列的平均出价金额不应超过 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

Campaigncriteria 的可能状态。

枚举
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

已定位 FeedItem 的 FeedItemSet。如果指定了多个 ID，则系统会定位出现在至少一个 ID 集中的所有项。此字段无法与 geoTargetConstants 一起使用。这是可选内容，只能在 CREATE 操作中设置。
radius

string (int64 format)

以单位为单位的距离，用于指定定位到的地理位置的半径范围。这是必填字段，必须在 CREATE 操作中设置。

LocationGroupRadiusUnits

营业地点组中的半径距离单位（例如 MILES）

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

CampaignLabel

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

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

string

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

string

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

string

分配给广告系列的标签。

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

是否应将此转化操作纳入到“clientAccount 转化次数”指标中。
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) 智能目标。适用于 Google Analytics（分析）、Firebase、Google Analytics（分析）黄金级目标导入。
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 表示“数字”类型的 Floodlight 变量。此变量可能会分配给类型为“DIMENSION”或“METRIC”的 Floodlight 变量。
STRING 表示“字符串”类型的 Floodlight 变量。可将此变量分配给“DIMENSION”类型的 Floodlight 变量。

客户

客户。

JSON 表示法 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "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。此值在客户选择启用跨帐号转化跟踪时设置，并会替换 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 相反，该资源还包含该客户拥有的策略以及归该客户的经理所有并已共享给该客户的策略。该资源不提供指标，仅公开了一部分 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)

一种出价策略，可帮助您最大限度地提高收入，同时确保平均达到特定目标广告支出回报率 (ROAS)。
targetSpend

object (TargetSpend)

一种出价策略，用于为您设置适当的出价，在不超出预算的前提下为您争取尽可能多的点击。

MaximizeConversionValue

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

JSON 表示法 
{
  "targetRoas": number
}
字段
targetRoas

number

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

MaximizeConversions

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

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

string (int64 format)

目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。
targetCpaMicros

string (int64 format)

目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。

TargetCpa

一种自动出价策略，可为您设置合适的出价来帮助您争取尽可能多的转化，同时将每次转化费用控制在您设定的目标水平。

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

string (int64 format)

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

TargetImpressionShare

一种自动出价策略，它会设置出价，使特定百分比的搜索广告展示在首页（或其他定位到的地理位置）的顶部。

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

enum (TargetImpressionShareLocation)

搜索结果页上的定位到的地理位置。
locationFractionMicros

string (int64 format)

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

string (int64 format)

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

TargetRoas

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

JSON 表示法 
{
  "targetRoas": number
}
字段
targetRoas

number

所选单位支出的收入（基于转化数据）。

TargetSpend

这是一种自动出价策略，可为您设置适当的出价，助您在不超出预算的前提下为您争取尽可能多的点击。

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

string (int64 format)

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

string (int64 format)

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

ManagerLinkStatus

链接的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ACTIVE 表示当前有效的关系
INACTIVE 表示已终止的关系
PENDING 表示经理已请求建立关系，但客户尚未接受。
REFUSED 经理提出关系请求，但客户拒绝。
CANCELED 表示经理已请求建立关系，但经理将其取消。

CustomerClient

指定客户与现有客户之间的关联。只有经理客户才能拥有 CustomerClient。包括所有直接和间接客户以及经理本身。

JSON 表示法 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
字段
resourceName

string

客户客户端的资源名称。CustomerClient 资源名称采用以下格式：customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

发出请求的客户所拥有的标签（应用于该客户）的资源名称。标签资源名称采用以下形式：

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

该客户的状态。只读。
clientCustomer

string

与指定客户相关联的客户-客户的资源名称。只读。
hidden

boolean

指定此账号是否为隐藏账号。

只读。
level

string (int64 format)

给定客户与客户之间的距离。对于自链接，级别值为 0。只读。
timeZone

string

客户端时区的通用语言区域数据存储库 (CLDR) 字符串表示，例如，America/Los_Angeles。只读。
testAccount

boolean

指明该客户是否为测试账号。只读。
manager

boolean

指明客户是否为经理。只读。
descriptiveName

string

客户的描述性名称。只读。
currencyCode

string

客户的货币代码（例如“USD”“EUR”）。只读。
id

string (int64 format)

客户客户的 ID。只读。

DynamicSearchAdsSearchTermView

动态搜索广告搜索字词视图。

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

string

动态搜索广告搜索字词视图的资源名称。动态搜索广告搜索字词视图资源名称的格式如下：

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

针对展示动态选择的着陆页网址。

此字段为只读字段。

GenderView

性别视图。genderView 资源反映的是有效投放状态，而不是添加的条件。默认情况下，未设置性别条件的广告组会面向所有性别显示，因此所有性别都会显示在 genderView 中以及统计信息中。

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

string

性别视图的资源名称。性别视图资源名称采用以下格式：

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

GeoTargetConstant

地理位置定位常量。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
字段
resourceName

string

地理位置定位常量的资源名称。地理位置定位常量资源名称采用以下形式：

geoTargetConstants/{geo_target_constant_id}
status

enum (GeoTargetConstantStatus)

地理位置定位常量状态。
id

string (int64 format)

地理位置定位常量的 ID。
name

string

地理位置定位常量英文名称。
countryCode

string

与定位条件相关联的 ISO-3166-1 alpha-2 国家/地区代码。
targetType

string

地理位置定位常量定位类型。
canonicalName

string

完全限定英文名称，包括定位目标的名称及其父级和国家/地区的名称。
parentGeoTarget

string

父级地理位置定位常量的资源名称。地理位置定位常量资源名称采用以下形式：

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

地理位置定位常量的可能状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知的值。

这是一个仅用于响应的值。
ENABLED 地理位置定位常量有效。
REMOVAL_PLANNED 地理位置定位常量已过时，将被移除。

KeywordView

关键字视图。

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

string

关键字视图的资源名称。关键字视图资源名称采用以下格式：

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

唱片公司

一个标签。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
字段
resourceName

string

资源的名称。标签资源名称采用以下形式：customers/{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

标签的背景颜色（采用 RGB 格式）。此字符串必须与正则表达式“^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$”匹配。注意：经理帐号的背景颜色可能不可见。
description

string

标签的简短说明。长度不得超过 200 个字符。

LanguageConstant

语言。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
字段
resourceName

string

语言常量的资源名称。语言常量资源名称的格式如下：

languageConstants/{criterionId}
id

string (int64 format)

语言常量的 ID。
code

string

语言代码，例如“en_US”“en_AU”“es”“fr”等。
name

string

语言的英文全称，例如“English (US)”“Spanish”等。
targetable

boolean

语言是否可定位。

LocationView

地理位置视图按地理位置条件总结广告系列的效果。

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

string

营业地点视图的资源名称。营业地点视图资源名称采用以下格式：

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

ProductBiddingCategoryConstant

产品出价类别。

JSON 表示法 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
字段
resourceName

string

产品出价类别的资源名称。产品出价类别资源名称采用以下格式：

productBiddingCategoryConstants/{countryCode}~{level}~{id}
level

enum (ProductBiddingCategoryLevel)

产品出价类别的级别。
status

enum (ProductBiddingCategoryStatus)

产品出价类别的状态。
id

string (int64 format)

产品出价类别的 ID。

此 ID 相当于 google_product_category [Google 商品类别] ID，如 https://support.google.com/merchants/answer/6324436 一文中所述。
countryCode

string

产品出价类别的双字母国家/地区代码。
productBiddingCategoryConstantParent

string

父级产品出价类别的资源名称。
languageCode

string

产品出价类别的语言代码。
localizedName

string

根据 languageCode 进行本地化的产品出价类别的显示值。

ProductBiddingCategoryLevel

描述产品出价类别级别的枚举。

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

ProductBiddingCategoryStatus

描述产品出价类别状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ACTIVE 该类别处于有效状态，可以用于出价。
OBSOLETE 该类别已过时。仅用于报告目的。

ProductGroupView

产品组视图。

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

string

产品组视图的资源名称。产品组视图资源名称采用以下格式：

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

ShoppingPerformanceView

购物效果视图。提供在多个产品维度级别汇总的购物广告系列统计信息。Merchant Center 中的产品维度值（例如品牌、类别、自定义属性、产品使用情况和产品类型）反映的是每个维度在系统记录相应事件的日期和时间的状态。

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

string

购物效果视图的资源名称。购物效果视图资源名称采用以下格式：customers/{customerId}/shoppingPerformanceView

UserList

用户列表。这是客户可能定位到的用户的列表。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
字段
resourceName

string

用户列表的资源名称。用户名单资源名称采用以下形式：

customers/{customerId}/userLists/{user_list_id}
type

enum (UserListType)

此列表的类型。

此字段为只读字段。
id

string (int64 format)

用户列表的 ID。
name

string

此用户列表的名称。根据 access_reason，用户名单名称可能不是唯一的（例如，如果 access_reason=SHARED）

UserListType

包含可能的用户名单类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
REMARKETING 表示为转化类型集合的 UserList。
LOGICAL 表示为其他用户列表/兴趣组合的用户名单。
EXTERNAL_REMARKETING 在 Google Ad Manager 平台中创建的 UserList。
RULE_BASED 与规则相关联的 UserList。
SIMILAR 具有与其他 UserList 的用户类似的用户的用户名单。
CRM_BASED 广告客户以电子邮件或其他格式提供的第一方 CRM 数据的用户名单。

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

获得点击的本地商品目录广告中的商店。这应与本地商品 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)

包含获得点击的商品的 SearchAds360 商品目录账号 ID。当您在 SearchAds360 中关联商品目录账号时，SearchAds360 会生成此 ID。
adId

string (int64 format)

广告 ID。值为 0 表示广告未归因。
clickId

string

转化归因于的访问的唯一字符串，该字符串会作为点击 ID 网址参数传递到着陆页。
visitId

string (int64 format)

转化归因于的 SearchAds360 访问 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

获得点击的本地商品目录广告中的商店。这应与本地商品 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)

转化的状态，“已启用”或“已移除”。
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,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": 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

转化总次数。此指标会纳入所有转化次数，而不考虑 includeInConversionMetric 的值。如果选择了此列和日期，日期列中的值表示转化日期。有关 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

转化总次数。此指标会纳入所有转化次数，而不考虑 includeInConversionMetric 的值。
allConversionsValuePerCost

number

所有转化的价值除以广告互动（例如文字广告获得的点击或视频广告获得的观看）的总费用。
allConversionsFromClickToCall

number

用户在点击广告后，或是在点击广告后，点击“致电”按钮向商店致电的次数。此数值不考虑通话是否接通或通话时长。

此指标仅适用于 Feed 项。
allConversionsFromDirections

number

用户在点击广告后，点击“查询路线”按钮导航到相应商店的次数。

此指标仅适用于 Feed 项。
allConversionsFromInteractionsValuePerInteraction

number

互动带来的所有转化的价值除以总互动次数。
allConversionsFromMenu

number

用户在点击广告后，点击链接查看商店菜单的次数。

此指标仅适用于 Feed 项。
allConversionsFromOrder

number

用户在点击广告后在商店下单的次数。

此指标仅适用于 Feed 项。
allConversionsFromOtherEngagement

number

用户点击广告后发生的其他转化（例如，发布对商店的评价或保存该商店的营业地点）的次数。

此指标仅适用于 Feed 项。
allConversionsFromStoreVisit

number

用户在点击广告后光顾相应实体店的次数的估算值。

此指标仅适用于 Feed 项。
visits

number

Search Ads 360 已成功记录并转发到广告客户着陆页的点击。
allConversionsFromStoreWebsite

number

用户在点击广告后转到相应商店网址的次数。

此指标仅适用于 Feed 项。
averageCost

number

您为每次互动支付的平均金额。此金额是广告的总费用除以互动总次数。
averageCpc

number

所有点击的总费用除以获得的总点击次数。该指标是一个货币价值，默认以客户的币种返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数
averageCpm

number

平均每千次展示费用 (CPM)。该指标是一个货币价值，默认以客户的币种返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数
clicks

string (int64 format)

点击次数。
contentBudgetLostImpressionShare

number

您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意：内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
contentImpressionShare

number

您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意：内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
contentRankLostImpressionShare

number

您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意：内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
conversionsFromInteractionsRate

number

每次符合转化条件的互动带来的平均可出价转化次数（来自互动）。显示广告互动带来转化的平均频率。
clientAccountConversionsValue

number

客户账号转化的值。这只包括 includeInClientAccountConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversionsValuePerCost

number

可出价转化的价值除以符合转化条件的互动的总费用。
conversionsFromInteractionsValuePerInteraction

number

互动带来的转化价值除以广告互动次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
clientAccountConversions

number

客户帐号转化次数。这只包括 includeInClientAccountConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
costMicros

string (int64 format)

在此期间您的每次点击费用 (CPC) 和每千次展示费用 (CPM) 的总和。该指标是一个货币价值，默认以客户的币种返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数
costPerAllConversions

number

广告互动费用除以所有转化次数。
costPerConversion

number

符合转化条件的平均每次可出价转化费用。
costPerCurrentModelAttributedConversion

number

广告互动费用除以当前模型归因转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
crossDeviceConversions

number

转化是指客户在一台设备上点击广告，然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 allConversion 中。
crossDeviceConversionsValue

number

跨设备转化的值的总和。
ctr

number

广告获得的点击次数（点击次数）除以广告展示次数（展示次数）。
conversions

number

转化次数。这只包括 includeInConversionMetric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
conversionsValue

number

“转化”字段中包含的转化带来的转化价值总和。只有在您为各项转化操作输入了价值的情况下，这项指标才能派上用场。
historicalQualityScore

string (int64 format)

历史质量得分。
impressions

string (int64 format)

广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。
interactionRate

number

在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。
interactions

string (int64 format)

互动次数。互动是指与某种广告格式关联的主用户操作：对于文字广告和购物广告而言是点击，对于视频广告而言是观看，诸如此类。
invalidClickRate

number

报告期内从总点击次数（过滤后 + 未过滤的点击次数）过滤出的点击次数所占的百分比。
invalidClicks

string (int64 format)

Google 认为不合规定且不向您收费的点击次数。
mobileFriendlyClicksPercentage

number

适合移动设备的页面的移动点击次数所占的百分比。
searchAbsoluteTopImpressionShare

number

在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情，请参阅 https://support.google.com/sa360/answer/9566729。任何低于 0.1 的值都会报告为 0.0999。
searchBudgetLostAbsoluteTopImpressionShare

number

此指标表示您的广告因预算不足而不是搜索结果中排名靠前的广告中作为首条广告的频率。注意：搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchBudgetLostImpressionShare

number

您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意：搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchBudgetLostTopImpressionShare

number

此指标表示您的广告因预算不足而未能在热门自然搜索结果旁边展示的频率。注意：搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchClickShare

number

您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意：搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchExactMatchImpressionShare

number

对于与关键字完全匹配（或是关键字的紧密变体形式）的搜索字词，此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意：搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchImpressionShare

number

您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意：在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
searchRankLostAbsoluteTopImpressionShare

number

该指标用于估算您的广告因广告评级较低而并非搜索结果中效果最好的广告中的首条广告的频率。注意：搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchRankLostImpressionShare

number

您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意：搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchRankLostTopImpressionShare

number

此指标表示您的广告因广告评级较低而未能在热门自然搜索结果旁边展示的频率。注意：搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
searchTopImpressionShare

number

您在热门广告中实际获得的展示次数与您有资格获得的估算展示次数之比。注意：搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。

页首广告通常展示在顶部自然搜索结果上方，但在某些查询中，页首广告可能会展示在顶部自然搜索结果下方。
topImpressionPercentage

number

在顶部自然搜索结果旁边展示的广告展示次数所占的百分比。
valuePerAllConversions

number

所有转化的价值除以所有转化的次数。
valuePerAllConversionsByConversionDate

number

所有转化的价值除以所有转化次数。如果选择了此列和日期，日期列中的值表示转化日期。有关 by_conversion_date 列的详细信息，请访问 https://support.google.com/sa360/answer/9250611。
valuePerConversion

number

可出价转化的价值除以可出价转化次数。显示每次可出价转化的平均价值。
valuePerConversionsByConversionDate

number

按转化日期的可出价转化价值除以可出价转化次数除以转化日期。显示每次可出价转化的平均价值（按转化日期）。如果选择了此列和日期，日期列中的值表示转化日期。
clientAccountViewThroughConversions

string (int64 format)

浏览型转化的总次数。当客户看到图片或富媒体广告，之后在您的网站上完成转化而不与另一个广告互动（例如，点击）时，就会发生这种情况。
clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

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

number

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

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

number

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

值

通用数据容器。

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,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
字段
adNetworkType

enum (AdNetworkType)

广告网络类型。
conversionActionCategory

enum (ConversionActionCategory)

转化操作类别。
conversionCustomDimensions[]

object (Value)

转化自定义维度。
dayOfWeek

enum (DayOfWeek)

星期几，例如 MONDAY。
device

enum (Device)

应用指标的设备。
keyword

object (Keyword)

关键字条件。
productChannel

enum (ProductChannel)

商品的渠道。
productChannelExclusivity

enum (ProductChannelExclusivity)

商品的渠道独占性。
productCondition

enum (ProductCondition)

商品的使用情况。
productSoldCondition

enum (ProductCondition)

所售产品的使用情况。
rawEventConversionDimensions[]

object (Value)

原始事件转化维度。
conversionAction

string

转化操作的资源名称。
conversionActionName

string

转化操作名称。
date

string

指标适用的日期。yyyy-MM-dd 格式，例如 2018-04-17。
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 年第二季度从 2018-04-01 开始。格式为 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 商品与其对应的网店或本地实体店相匹配，表示其在这两个 ShoppingProductChannels 中均有售。

ProductCondition

描述商品优惠条件的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
OLD 商品使用情况是旧的。
NEW 商品使用情况为全新。
REFURBISHED 商品使用情况为翻新。
USED 使用产品条件。

AssetInteractionTarget

AssetInteractionTarget 细分。

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

string

资产资源名称。
interactionOnThisAsset

boolean

仅用于 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标。指明互动指标是发生在素材资源本身上，还是发生在其他素材资源或广告单元上。