Package google.ads.searchads360.v0.resources

string

可访问的出价策略的资源名称。AccessibleBiddingStrategy 资源名称的格式为：

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

int64

出价策略的 ID。

string

出价策略的名称。

BiddingStrategyType

出价策略的类型。

int64

拥有出价策略的客户的 ID。

string

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

MaximizeConversionValue

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

MaximizeConversions

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

TargetCpa

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

TargetImpressionShare

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

TargetRoas

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

TargetSpend

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

double

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

int64

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

int64

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

int64

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

TargetImpressionShareLocation

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

int64

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

int64

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

double

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

int64

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

int64

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

string

广告的资源名称。广告资源名称的格式为：

customers/{customer_id}/ads/{ad_id}

string

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

AdType

广告的类型。

int64

广告的 ID。

string

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

string

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

SearchAds360TextAdInfo

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

SearchAds360ExpandedTextAdInfo

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

SearchAds360ResponsiveSearchAdInfo

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

SearchAds360ProductAdInfo

与商品广告相关的详细信息。

SearchAds360ExpandedDynamicSearchAdInfo

与加大型动态搜索广告相关的详细信息。

string

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

customers/{customer_id}/adGroups/{ad_group_id}

AdGroupStatus

广告组的状态。

AdGroupType

广告组的类型。

AdGroupAdRotationMode

广告组的广告轮播模式。

string

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

TargetingSetting

用于定位相关功能的设置。

string

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

string

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

string

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

string

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

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

string

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

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

string

广告组中的广告和关键字的语言。此字段仅适用于 Microsoft Advertising 账号。更多详情：https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

string

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

int64

广告组的 ID。

string

广告组的名称。

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

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

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

int64

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

AdGroupEngineStatus

广告组的引擎状态。

string

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

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

AdGroupAdStatus

广告的状态。

Ad

广告。

string

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

string

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

string

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

string

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

AdGroupAdEngineStatus

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

string

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

string

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

string

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

string

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

int64

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

string

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

string

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

string

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

int64

标签所属客户的 ID。

string

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

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

string

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

string

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

AssetLinkStatus

广告组素材资源的状态。

string

广告组素材资源组的资源名称。广告组素材资源组资源名称的格式为：

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

string

此素材资源集关联到的广告组。

string

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

AssetSetLinkStatus

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

string

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

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

string

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

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

double

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

DeviceInfo

设备条件。

string

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

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

string

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

AdGroupCriterionStatus

条件的状态。

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

QualityInfo

关于标准质量的信息。

CriterionType

条件的类型。

string

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

string

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

PositionEstimates

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

string

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

string

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

string

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

int64

条件的 ID。

string

条件所属的广告组。

bool

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

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

double

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

int64

每次点击费用出价。

int64

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

AdGroupCriterionEngineStatus

广告组条件的引擎状态。

string

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

string

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

KeywordInfo

关键字。

ListingGroupInfo

商品信息组。

AgeRangeInfo

年龄段。

GenderInfo

性别。

UserListInfo

用户名单。

WebpageInfo

网页

LocationInfo

位置信息。

int64

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

int32

质量得分。

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

string

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

string

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

string

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

int64

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

string

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

string

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

string

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

int64

标签所属客户的 ID。

string

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

string

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

string

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

int64

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

string

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

string

标签附加到的广告组。

string

分配给广告组的标签。

int64

标签所属客户的 ID。

string

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

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

string

资源的资源名称。资产资源名称的格式为：

customers/{customer_id}/assets/{asset_id}

AssetType

资源的类型。

string

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

AssetStatus

素材资源的状态。

string

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

string

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

int64

资产的 ID。

string

资产的可选名称。

string

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

AssetEngineStatus

素材资源的引擎状态。

YoutubeVideoAsset

YouTube 视频素材资源。

ImageAsset

图片素材资源。

TextAsset

文字素材资源。

UnifiedCalloutAsset

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

UnifiedSitelinkAsset

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

UnifiedPageFeedAsset

统一的页面 Feed 素材资源。

MobileAppAsset

移动应用素材资源。

UnifiedCallAsset

统一的电话素材资源。

CallToActionAsset

号召性用语素材资源。

UnifiedLocationAsset

统一的地址素材资源。

string

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

customers/{customer_id}/assetGroups/{asset_group_id}

int64

素材资源组的 ID。

string

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

string

必需。素材资源组的名称。必需。长度不得低于 1 且不得高于 128。在广告系列中，此维度必须是唯一的。

string

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

string

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

AssetGroupStatus

素材资源组的状态。

string

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

string

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

AdStrength

此素材资源组的总体广告效力。

string

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

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

string

此素材资源组素材资源要关联的素材资源组。

string

此素材资源组素材资源所关联的素材资源。

AssetFieldType

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

AssetLinkStatus

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

AssetUsage

投放的素材资源。

string

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

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

string

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

int64

ListingGroupFilter 的 ID。

ListingGroupFilterType

商品信息组过滤条件节点的类型。

ListingGroupFilterVertical

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

ListingGroupFilterDimension

用于对其父级进行细分的维度值。根组为未定义。

string

父级产品信息组细分的资源名称。对于根产品信息组过滤条件节点，值为 null。

ListingGroupFilterDimensionPath

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

string

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

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

string

此素材资源组信号所属的素材资源组。

AudienceInfo

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

string

素材资源组顶级组合视图的资源名称。素材资源组热门组合视图资源名称采用以下格式：“customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}”

AssetGroupAssetCombinationData

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

int64

素材资源组的 ID。

string

资产集的资源名称。资产集资源名称的格式为：

customers/{customer_id}/assetSets/{asset_set_id}

string

资产集资产的资源名称。资产集资产资源名称的格式为：

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

string

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

string

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

AssetSetAssetStatus

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

string

受众群体的资源名称。受众群体名称采用以下格式：

customers/{customer_id}/audiences/{audience_id}

int64

受众群体的 ID。

string

必需。受众群体的名称。它在所有受众群体中都应是唯一的。其长度下限为 1，上限为 255。

string

此受众群体的说明。

string

出价策略的资源名称。出价策略资源名称的格式为：

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

BiddingStrategyStatus

出价策略的状态。

此字段为只读字段。

BiddingStrategyType

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

此字段为只读字段。

string

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

对于经理客户中的出价策略，您可以在创建时设置此币种，默认值为经理客户的币种。对于服务客户，无法设置此字段；服务客户中的所有策略都会隐式使用服务客户的币种。在所有情况下，effective_currency_code 字段都会返回策略使用的币种。

int64

出价策略的 ID。

string

出价策略的名称。同一账号内的所有出价策略都必须具有辨识度的名称。

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

string

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

对于经理客户中的出价策略，此字段是广告客户在创建策略时设置的货币。对于为客户提供服务，这是客户的 currency_code。

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

此字段为只读字段。

int64

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

此字段为只读字段。

int64

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

此字段为只读字段。

EnhancedCpc

此出价策略会针对更有可能带来转化的点击提高出价，并针对不太可能带来转化的点击降低出价。

MaximizeConversionValue

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

MaximizeConversions

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

TargetCpa

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

TargetImpressionShare

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

TargetOutrankShare

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

TargetRoas

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

TargetSpend

这种出价策略会为您设置出价，帮助您在预算范围内争取尽可能多的点击。

string

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

customers/{customer_id}/campaigns/{campaign_id}

CampaignStatus

广告系列的状态。

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

CampaignServingStatus

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

BiddingStrategySystemStatus

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

AdServingOptimizationStatus

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

AdvertisingChannelType

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

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

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

AdvertisingChannelSubType

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

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

CustomParameter

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

RealTimeBiddingSetting

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

NetworkSettings

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

DynamicSearchAdsSetting

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

ShoppingSetting

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

GeoTargetTypeSetting

广告的地理位置定位设置。

string

附加到此广告系列的有效标签的资源名称。有效标签是指继承或直接分配给该广告系列的标签。

string

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

BiddingStrategyType

出价策略的类型。

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

此字段为只读字段。

string

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

FrequencyCapEntry

用于限制每位用户看到此广告系列的广告的频率的列表。

SelectiveOptimization

此广告系列的选择性优化设置，其中包含一组要针对此广告系列进行优化的转化操作。此功能仅适用于使用 MULTI_CHANNEL 作为 AdvertisingChannelType 且使用 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 作为 AdvertisingChannelSubType 的应用广告系列。

OptimizationGoalSetting

此广告系列的优化目标设置，其中包含一组优化目标类型。

TrackingSetting

针对跟踪信息的广告系列级设置。

string

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

AssetFieldType

应从此广告系列中排除的素材资源字段类型。此广告系列不会从上级继承使用这些字段类型的素材资源关联。

string

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

string

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

string

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

int64

广告系列的 ID。

string

广告系列的名称。

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

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

string

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

string

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

string

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

string

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

string

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

bool

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

string

广告系列使用的组合出价策略的资源名称。

ManualCpa

标准的“每次转化费用人工出价”策略。允许广告客户针对广告客户指定的操作设置出价的人工出价策略。仅适用于本地生活服务广告系列。

ManualCpc

标准的每次点击费用人工出价策略。基于点击的人工出价，此类出价中用户按点击次数付费。

ManualCpm

标准的“每千次展示费用人工出价”策略。基于展示的人工出价，此类出价中用户按每千次展示付费。

MaximizeConversions

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

MaximizeConversionValue

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

TargetCpa

标准的“目标每次转化费用”出价策略，可自动设置适当的出价，帮助您以自己设定的目标每次转化费用 (CPA) 争取到尽可能多的转化。

TargetImpressionShare

“目标展示次数份额”出价策略。一种自动出价策略，可通过设置出价实现指定百分比的展示次数。

TargetRoas

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

TargetSpend

标准的“目标支出”出价策略，会自动设置适当的出价，帮助您在不超出预算的前提下争取尽可能多的点击。

PercentCpc

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

TargetCpm

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

string

必需。此设置所代表的互联网域名，例如“google.com”或“www.google.com”。

string

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

bool

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

PositiveGeoTargetType

此特定广告系列中用于正向地理位置定位的设置。

NegativeGeoTargetType

此特定广告系列中用于排除性地理位置定位的设置。

bool

广告是否将随 Google.com 搜索结果一起投放。

bool

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

bool

广告是否将在 Google 展示广告网络中的指定展示位置投放。您可以使用展示位置条件指定展示位置。

bool

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

OptimizationGoalType

优化目标类型列表。

string

为优化此广告系列而选择的一组转化操作资源名称。

string

要添加到广告系列中的商品的 Feed 标签。只能设置 feed_label 或 sales_country 之一。如果将 feed_label 字段用作 sales_country 字段的替代项，则该字段接受采用相同格式的国家/地区代码，例如“XX”。否则，可以是 Google Merchant Center 中用于 Feed 标签的任何字符串。

bool

是否定位到车辆商品目录广告资源。

int64

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

string

要纳入广告系列的商品的销售国家/地区。

int32

广告系列的优先级。数值越高，相应广告系列的优先级就越高，反之越低。对于购物广告系列，此字段为必填字段，值介于 0 到 2 之间（包括这两个数值）。对于智能购物广告系列，此字段是选填字段，但如果设置了此字段，则必须等于 3。

bool

是否包含本地商品。

string

用于动态跟踪的网址。

string

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

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

AssetLinkStatus

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

string

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

string

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

string

广告系列素材资源组的资源名称。资产集资产资源名称的格式为：

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

string

此素材资源集所关联的广告系列。

string

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

AssetSetLinkStatus

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

string

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

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

string

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

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

BudgetDeliveryMethod

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

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

BudgetPeriod

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

int64

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

string

广告系列条件的资源名称。广告系列条件资源名称的格式如下：

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

string

条件的显示名称。

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

CriterionType

条件的类型。

CampaignCriterionStatus

条件的状态。

string

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

int64

条件的 ID。

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

float

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

bool

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

KeywordInfo

关键字。

LocationInfo

位置信息。

DeviceInfo

设备。

AgeRangeInfo

年龄段。

GenderInfo

性别。

UserListInfo

用户列表。

LanguageInfo

语言。

WebpageInfo

网页。

LocationGroupInfo

营业地点组

string

资源的名称。广告系列有效标签资源名称的格式为：customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}

string

附加了有效标签的广告系列。

string

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

int64

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

string

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

string

标签附加到的广告系列。

string

分配给广告系列的标签。

int64

标签所属客户的 ID。

string

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

string

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

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

int64

转化的 ID

int64

Search Ads 360 条件 ID。值为 0 表示条件未归因。

int64

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

int64

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

string

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

int64

转化归因于的 Search Ads 360 访问 ID。

string

对于线下转化，此 ID 由广告主提供。如果广告客户未指定此类 ID，Search Ads 360 会生成一个 ID。对于线上转化，这等于 ID 列或 floodlight_order_id 列，具体取决于广告客户的 Floodlight 指令。

string

点击的商品的 ID。

ProductChannel

获得点击的商品的销售渠道：线上或本地。

string

为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。

string

获得点击的本地商品目录广告中的商店。此 ID 应与本地商品 Feed 中使用的商店 ID 一致。

string

为包含获得点击的商品的商品目录 Feed 注册的国家/地区（ISO-3166 格式）。

AttributionType

转化归因于的原因：访问或关键字+广告。

string

转化事件的时间戳。

string

转化上次修改的时间戳。

string

转化归因于的访问的时间戳。

int64

转化记录的商品数量，由 qty 网址参数确定。广告主负责动态填充该参数（如转化中售出的商品数量），否则默认为 1。

int64

转化事件的调整后收入（以微为单位）。此字段始终采用广告投放账号所用的币种。

int64

在修改 Floodlight 货币指令之前，与 Floodlight 事件关联的未更改的原始收入（采用当前报告所用的币种）。

string

广告主为转化提供的 Floodlight 订单 ID。

ConversionStatus

转化的状态，“已启用”或“已移除”。

int64

转化事件期间互动过的素材资源的 ID。

AssetFieldType

转化事件的素材资源字段类型。

string

转化操作的资源名称。转化操作资源名称的格式如下：

customers/{customer_id}/conversionActions/{conversion_action_id}

string

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

ConversionActionStatus

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

ConversionActionType

此转化操作的类型。

ConversionActionCategory

为此转化操作报告的转化类别。

ValueSettings

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

AttributionModelSettings

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

FloodlightSettings

适用于 Floodlight 转化类型的 Floodlight 设置。

int64

转化操作的 ID。

string

转化操作的名称。

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

bool

如果转化操作的 primary_for_goal 位为 false，则无论客户转化目标或广告系列转化目标如何，所有广告系列都无法针对该转化操作出价。不过，自定义转化目标不遵循 primary_for_goal，因此，如果广告系列的自定义转化目标配置了 primary_for_goal = false 转化操作，则该转化操作仍可出价。默认情况下，如果未设置 primary_for_goal，则其值为 true。在 V9 中，primary_for_goal 只能在创建后通过“更新”操作设置为 false，因为它未声明为可选。

string

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

bool

此转化操作是否应纳入到“client_account_conversions”指标中。

bool

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

int64

互动（例如点击）和转化事件之间可能相隔的天数上限。

string

应用转化操作的应用 ID。

AttributionModel

此转化操作的归因模型类型。

DataDrivenModelStatus

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

string

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

string

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

int64

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

double

当为此转化操作发送的转化事件包含无效、被禁止或缺失的价值，或者此转化操作配置为始终使用默认价值时，要使用的值。

string

当为此转化操作发送的转化事件的币种代码无效或缺失，或者此转化操作配置为始终使用默认值时，要使用的币种代码。

bool

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

string

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

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

int64

转化自定义变量的 ID。

string

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

string

必需。转化自定义变量的代码。代码应是唯一的，由字符“u”和一个小于或等于 100 的数字组成。例如“u4”。

ConversionCustomVariableStatus

用于统计转化事件的转化自定义变量的状态。

string

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

ConversionCustomVariableFamily

转化自定义变量的系列。

ConversionCustomVariableCardinality

转化自定义变量的基数。

FloodlightConversionCustomVariableInfo

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

int64

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

FloodlightVariableType

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

FloodlightVariableDataType

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

bool

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

ConversionTrackingStatus

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

bool

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

string

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

int64

此账号使用的转化跟踪 ID。此 ID 不会指明客户是否使用了转化跟踪（conversion_tracking_status 使用了转化跟踪）。此字段为只读字段。

int64

客户的经理的转化跟踪 ID。客户选择启用转化跟踪时会设置此 ID，它会替换 conversion_tracking_id。此字段只能通过 Google Ads 界面进行管理。此字段为只读字段。

int64

客户的经理的转化跟踪 ID。客户选择启用跨账号转化跟踪后，系统会设置此 ID，并覆盖 conversion_tracking_id。

string

自定义列的资源名称。自定义列资源名称的格式为：

customers/{customer_id}/customColumns/{custom_column_id}

int64

自定义列的 ID。

string

自定义列的用户定义名称。

string

自定义列的用户定义说明。

CustomColumnValueType

自定义列的结果值的类型。

bool

如果自定义列引用一个或多个属性，则为 true。

bool

如果自定义列引用一个或多个指标，则为 true。

bool

如果自定义列可用于 SearchAds360Service.Search 和 SearchAds360Service.SearchStream 的查询，则为 true。

string

此自定义列引用的系统列的列表。例如，“展示次数和点击次数总和”自定义列引用了 {"metrics.clicks", "metrics.impressions"} 这一系统列。

CustomColumnRenderType

如何解读自定义列的结果值。

string

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

customers/{customer_id}

ConversionTrackingSetting

客户的转化跟踪设置。

AccountType

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

DoubleClickCampaignManagerSetting

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

AccountStatus

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

string

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

string

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

CustomerStatus

客户的状态。

string

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

int64

客户的 ID。

string

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

string

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

string

客户的当地时区 ID。

string

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

string

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

bool

是否为客户启用了自动标记功能。

bool

客户是否为经理。

string

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

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

string

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

AssetLinkStatus

客户素材资源的状态。

string

客户素材资源集的资源名称。资产集资产资源名称的格式为：

customers/{customer_id}/customerAssetSets/{asset_set_id}

string

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

string

此素材资源集所关联的客户。

AssetSetLinkStatus

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

string

客户客户的资源名称。CustomerClient 资源名称的格式为：customers/{customer_id}/customerClients/{client_customer_id}

string

请求方客户拥有的标签的资源名称，这些标签会应用于客户客户。标签资源名称采用以下格式：

customers/{customer_id}/labels/{label_id}

CustomerStatus

客户客户的状态。只读。

string

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

bool

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

只读。

int64

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

string

客户端时区的通用区域设置数据库 (CLDR) 字符串表示法，例如 America/Los_Angeles。只读。

bool

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

bool

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

string

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

string

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

int64

客户的 ID。只读。

string

资源的名称。CustomerManagerLink 资源名称的格式为：customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}

ManagerLinkStatus

客户与经理之间的关联状态。

string

与该客户相关联的经理账号。

int64

客户-经理关联的 ID。此字段为只读字段。

string

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

int64

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

int64

与此客户相关联的 Campaign Manager 广告网络的 ID。

string

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

string

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

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

string

展示的动态着陆页网址。

此字段为只读字段。

string

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

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

string

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

geoTargetConstants/{geo_target_constant_id}

GeoTargetConstantStatus

地理位置定位常量状态。

int64

地理位置定位目标常量的 ID。

string

地理位置定位目标常量的英语名称。

string

与目标关联的 ISO 3166-1 alpha-2 国家/地区代码。

string

地理位置定位目标常量目标类型。

string

完全限定的英文名称，由定位的名称及其父级和国家/地区的名称组成。

string

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

geoTargetConstants/{parent_geo_target_constant_id}

string

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

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

string

资源的名称。标签资源名称采用以下格式：customers/{customer_id}/labels/{label_id}

LabelStatus

标签的状态。只读。

TextLabel

一种在彩色背景上显示文本的标签。

int64

标签的 ID。只读。

string

标签的名称。

此字段为必填字段，在创建新标签时不应为空。

此字符串的长度应介于 1 到 80 之间（包括 1 和 80）。

string

语言常量的资源名称。语言常量资源名称采用以下格式：

languageConstants/{criterion_id}

int64

语言常量的 ID。

string

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

string

语言的英语全名，例如“英语（美国）”“西班牙语”等。

bool

相应语言是否可定位。

ProductBiddingCategory

商品报价的出价类别。

ProductBrand

商品的品牌。

ProductChannel

商品的本地性。

ProductCondition

商品的使用情况。

ProductCustomAttribute

商品的属性。

ProductItemId

商品优惠的商品 ID。

ProductType

商品优惠的类型。

ListingGroupFilterBiddingCategoryLevel

表示类目中类别的级别。

int64

商品出价类别的 ID。

此 ID 相当于本文中所述的 google_product_category ID：https://support.google.com/merchants/answer/6324436

string

商品品牌的字符串值。

ListingGroupFilterProductChannel

相应地区的值。

ListingGroupFilterProductCondition

条件的值。

ListingGroupFilterCustomAttributeIndex

表示自定义属性的索引。

string

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

string

ID 的值。

ListingGroupFilterProductTypeLevel

类型的级别。

string

类型的值。

ListingGroupFilterDimension

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

string

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

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

string

商品出价类别的资源名称。商品出价类别资源名称的格式为：

productBiddingCategoryConstants/{country_code}~{level}~{id}

ProductBiddingCategoryLevel

产品出价类别的级别。

ProductBiddingCategoryStatus

商品出价类别的状态。

int64

产品出价类别的 ID。

此 ID 相当于本文中所述的 google_product_category ID：https://support.google.com/merchants/answer/6324436。

string

商品出价类别的双字母大写国家/地区代码。

string

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

string

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

string

商品出价类别的显示值，已根据 language_code 进行本地化。

string

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

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

string

工件的资源名称。工件资源名称的格式为：

SearchAds360Fields/{name}

SearchAds360FieldCategory

工件所属的类别。

string

可通过所述工件选择的所有资源、细分和指标的名称。

string

可通过所述工件选择的所有资源的名称。当这些资源包含在搜索查询中时，其中的字段不会细分指标。

此字段仅针对类别为 RESOURCE 的工件进行设置。

string

此字段列出了在 FROM 子句中使用所述工件时可通过该工件选择的所有指标的名称。它仅针对类别为 RESOURCE 的工件进行设置。

string

此字段列出了在搜索查询中包含细分指标以及在 FROM 子句中使用所述工件时，所有工件（无论是细分还是其他资源）的名称。它仅针对类别为 RESOURCE 的工件进行设置。

string

如果工件是类型为 ENUM 的字段，则可以假定的工件值。

此字段仅针对类别为“SEGMENT”或“ATTRIBUTE”的工件进行设置。

SearchAds360FieldDataType

此字段用于确定可以在 WHERE 子句中与工件搭配使用的运算符。

string

工件的名称。

bool

工件是否可以在搜索查询的 SELECT 子句中使用。

bool

工件是否可以在搜索查询的 WHERE 子句中使用。

bool

工件是否可以在搜索查询的 ORDER BY 子句中使用。

string

描述工件数据类型的 proto 的网址。

bool

字段工件是否重复。

string

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

string

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

customers/{customer_id}/userLists/{user_list_id}

UserListType

此列表的类型。

此字段为只读字段。

int64

用户列表的 ID。

string

此用户名单的名称。用户名单名称可能不具有唯一性，具体取决于其 access_reason（例如，如果 access_reason=SHARED）

string

用户位置信息视图的资源名称。UserLocation 视图资源名称采用以下格式：

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

int64

国家/地区的条件 ID。

bool

指明是否定位到地理位置。

string

访问的资源名称。访问资源名称的格式为：

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

int64

访问的 ID。

int64

Search Ads 360 关键字 ID。值为 0 表示关键字未归因。

int64

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

int64

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

string

作为点击 ID 网址参数传递到着陆页的每次访问的唯一字符串。

string

访问事件的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。

string

点击的商品的 ID。

ProductChannel

获得点击的商品的销售渠道：线上或本地。

string

为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。

string

获得点击的本地商品目录广告中的商店。此 ID 应与本地商品 Feed 中使用的商店 ID 一致。

string

为包含获得点击的商品的商品目录 Feed 注册的国家/地区（ISO-3166 格式）。

int64

在访问事件期间互动过的素材资源的 ID。

AssetFieldType

访问事件的素材资源字段类型。

string

网页视图的资源名称。网页视图资源名称采用以下格式：

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}