最低功能要求

版本号：2022-10-06

最低功能要求 (RMF) 是指某些工具开发者在使用 Google Ads API 时必须提供的特性及其他功能。如下文所述，最低功能要求规则分为三类：创建功能、管理功能和报告功能。您是否需要遵守这些规则取决于您使用 Google Ads API 的方式（“RMF 适用”表示您需遵循最低功能要求）：

创建功能 管理功能 报告功能
全方位服务工具
  • 广告客户、代理机构和其他第三方使用您的工具 全面管理其 Google Ads 帐号
 RMF 适用 RMF 适用 RMF 适用
仅用于报告
  • 最终广告客户只能使用报告信息中心
 RMF 不适用 RMF 不适用 RMF 适用
仅限内部使用
  • 仅供单个广告客户或代理机构使用；不允许第三方访问工具（这意味着只有您自己在使用工具）
 RMF 不适用 RMF 不适用 RMF 不适用

如果您的工具提供非常有限且专业的功能，并且不能用于创建和管理广告系列、广告组和广告，则可能不符合全方位服务工具的条件。在这种情况下，创建和管理方面的最低功能要求均不适用。如果您不确定最低功能要求是否适用于您的工具，请与 Google Ads API 合规性审查团队联系。Google Ads API 合规性审查团队将确定您的工具是否属于全方位服务工具。如果您的工具的功能发生显著变化，则可能需要重新评估该工具。

请注意，最低功能要求仅适用于拥有标准权限的开发者令牌。

针对重大更新的一次性延期

由于 API 工具可能会定期执行大范围的技术升级，为此，如果特定工具至少连续 2 年都在每个截止日期前达到了最低功能要求，则可以申请 6 个月的延期，以便在其平台中实施此类升级。延期申请获得批准后，我们在延期的这段时间内不会再对相关工具进行最低功能要求合规审核。延长期结束时，该工具必须完全符合在延长期最后一天或之前到期的所有最低功能要求。延期结束后到期的所有最低功能要求仍将于下表中指定的日期到期。

API 工具每四年最多只能获得一次延期（第二次延期必须在第一次延期结束至少 4 年后开始）。

如果您希望为自己的工具申请延期，请通过 https://support.google.com/adspolicy/contact/contact_ads_api 与我们联系并提交申请表单。您的申请必须由贵公司的高管（首席执行官、首席技术官或高级副总裁）签署并提交。请注意，我们不保证您的申请一定会获得批准。

针对仅限购物广告系列、仅限应用宣传广告以及仅适用于酒店的 API 工具的要求

如果您的工具仅用于制作和管理以下某种广告系列类型，那么您只需实现 Google Ads API 创建和管理功能以及适用于相应广告系列类型的 RMF 中的报告即可。

仅用于报告的 Google Ads API 客户端须满足的要求

为了满足最低功能要求，仅用于报告的 Google Ads API 客户端必须为报告界面中显示的 Google Ads 层级结构的每一级都显示报告功能。Google Ads 层级结构中的层级可以是帐号层级、广告系列层级、广告组层级、广告或关键字层级。例如，如果仅用于报告的 Google Ads 客户端显示了广告组，就必须实现以下标记为“必选”的所有“广告组”一级的报告功能。

仅用于报告的 Google Ads API 客户端可以选择在报告界面中不显示 Google Ads 层级结构的特定层级。例如，如果仅用于报告的 Google Ads API 客户端在其界面中未显示任何广告组效果数据，则不需要实现任何“广告组”层级的报告最低功能要求。

上述政策同样适用于其他所有报告类型（尽管这些报告类型并非 Google Ads 层级结构的组成部分）。如果您选择实现上述任何报告，则必须显示针对各报告的所有必选字段。

为了满足最低功能要求，Google Ads API 客户端必须为每个报告显示对象/字段/指南列中标为必选的所有列。其他所有指标列必须作为候选内容提供，由 Google Ads API 客户端用户自行取舍。Google Ads 报告数据应该醒目地显示，方便最终用户访问。

可下载的报告

如果您的工具提供下载选项（例如 CSV），而不是在界面中显示报告功能，则必须突出显示下载链接并直观地加以标记。下载的文件必须包含所有必选的报告字段并带有清楚的标记。

报告日期范围

我们建议您允许用户按日期范围过滤报告数据。如果您的工具不支持自定义日期范围，则至少应该为每个必选报告字段提供最近 30 天的数据。

提供创建功能或管理功能的API客户端须满足的要求

为了符合最低功能要求，提供全方位服务的 Google Ads API 客户端必须实现下表中所有必需的创建和管理功能，并为以下每种报告显示报告功能。 此外，您必须采取合理措施，确保最终广告客户能够轻松访问和使用各项功能（根据这些功能的使用情况来衡量）。

针对提供规划服务的 API 客户端的要求

如果 Google Ads API 客户端提供了与 KeywordPlanIdeaService 或 KeywordPlanService 相关的任何功能，则必须完全实现下表中标为“必选”的相应创建功能、管理功能和报告功能。

关于提供推荐服务的 API 客户端的要求

所有 API 客户端都可以使用 GoogleAdsService 和 RecommendationService 来检索建议。

RecommendationService.ApplyRecommendation() 和 RecommendationService.DismissRecommendation() 的使用仅限于以下类型的 Google Ads API 客户端：

  • 全方位服务工具
  • 仅供内部使用的工具
  • 仅适用于购物广告系列、效果最大化广告系列 / 仅限智能购物广告系列、仅限应用宣传广告以及仅适用于酒店的 API 工具
  • 提供广告系列管理功能的特殊用途工具

如果 Google Ads API 客户端提供使用 RecommendationService 采纳或拒绝建议的功能，则必须满足以下要求：

  1. 该工具必须完全实现其工具类别所需的创建功能、管理功能和报告功能。
  2. 向最终用户显示的所有 Google Ads 建议都必须在该工具的界面中显示为“Google Ads 建议”。
  3. 最终用户必须能够查看和采纳 Google Ads API 客户端显示的所有 Google Ads 建议。

与出价调整相关的要求

所有提供创建或管理功能的 API 客户端都必须满足与出价调整相关的以下要求：

  1. 最终用户必须能够输入允许的值范围内的所有值。
  2. 最终用户必须能够在 Google Ads API 客户端设置出价调整之前，先行查看和修改出价调整。
  3. 出价调整只能用于调整出价，不能用于启用或模拟其他功能，例如定位或排除。

功能实现

除非下文另有规定，否则，当且仅当所有可用子功能和参数也一并实现时，相应功能才算实现。API 参考文档记录了可用的参数和子功能。例如，“选择加入/退出投放网络”功能表示支持加入/退出 Google 搜索、搜索网络合作伙伴和展示广告网络。此外，如果您在 Google Ads API 客户端中实现了与 Google 非必需功能类似的功能，则必须在 Google Ads API 客户端中也实现这项类似的 Google 功能。例如，如果您在 Google Ads API 客户端中实现了自己的“关键字提示”，您也必须在 Google Ads API 客户端中实现 Google 的“关键字提示”功能。

为了符合最低功能要求，任何新的必需功能必须在截止日期（显示在每项功能旁边，格式为：到期日：YYYY-MM-DD）之前添加。没有指定截止日期的所有最低功能要求都会过期。另外，如果您要对 Google Ads API 客户端进行实质性更改，我们要求您至少在更改生效的两周之前，使用工具更改表单向 Google Ads API 客户端发送建议更改的屏幕截图和/或原型。为明确起见，特此说明：在这两周时间过去之后，您无需等待 Google 的答复，这些实质性更改便会生效。

全方位工具功能列表

商品编号 功能 对象/字段/指南 要求

创建功能
C.10 制作广告系列 campaign 必需
C.20 启用地理位置定位 地理位置定位 必需。 如果只有一个国家/地区与用户群相关，可以选择向用户公开。
C.30 启用语言定位 campaign_criterion.language
language_constant		 必需。如果只有一种语言与用户群相关，可以选择向用户显示。
C.65 创建网站 / 来电转化并生成代码段 转化跟踪 必须至少选择一种转化跟踪。
C.75 宣传信息素材资源 宣传信息 Feed 占位符
附加信息设置服务
Feed 服务
 必需。只需要在账号级别支持该功能。
C.96 设置出价选项：目标每次转化费用（“组合”和“标准”） campaign.target_cpa（标准）
bidding_strategy.target_cpa（组合）		 必需。“组合”和“标准”策略均需在广告系列一级支持。
C.97 设置出价选项：目标广告支出回报率（“组合”和“标准”） campaign.target_roas（标准）
bidding_strategy.target_roas（组合）		 必需。“组合”和“标准”策略均需在广告系列一级支持。
C.98 设置出价选项：尽可能提高转化次数（标准） campaign.maximize_conversions（标准） 必需
C.120 设置预算 campaign_budget 必需
C.190 制作广告组 ad_group 必需。可选：能够创建多个广告组。
C.260 添加关键字 ad_group_criterion.keyword 必需
C.270 添加广告系列否定关键字 campaign_criterion.negative 必需
C.300 设置关键字匹配类型 ad_group_criterion.keyword
 .match_type		 必需

管理功能

M.10 修改广告系列设置 campaign.*setting 必需。只需在更改时创建时所需的设置即可。
M.96 修改出价选项：目标每次转化费用（“组合”和“标准”） campaign.target_cpa（标准）
bidding_strategy.target_cpa（组合）		 必需。“组合”和“标准”策略均需在广告系列一级支持。
M.97 修改出价选项：目标广告支出回报率（组合和标准） campaign.target_roas（标准）
bidding_strategy.target_roas（组合） 		必需。“组合”和“标准”策略均需在广告系列一级支持。
M.98 修改出价选项：尽可能提高转化次数（标准） campaign.maximize_conversions（标准） 必需
M.110 暂停/启用/移除广告系列 campaign.status 必需
M.130 暂停/启用/移除广告 ad_group_ad.status 必需
M.140 暂停/启用/移除关键字 ad_group_criterion.status 必需

报告功能

R.10 客户 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions 		必需
R.20 广告系列 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
 必需
campaign.status 如果要显示已暂停、有效以及已移除状态的广告系列，则为必选。
如果只显示有效的广告系列，则为可选。
R.40 广告组广告 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions 		必需
ad_group_ad.status 如果要显示已暂停、有效以及已移除状态的广告，则为必选。
如果只显示有效的广告，则为可选。
R.50 关键字视图 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
ad_group_criterion
 .position_estimates
 .first_page_cpc_micros
ad_group_criterion
 .position_estimates
 .first_position_cpc_micros 		必需
ad_group_criterion.status 如果要显示已暂停、有效以及已移除状态的关键字，则为必选。
如果只显示有效的关键字，则为可选。
R.70 搜索字词视图 search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions 		必需
R.100 动态搜索广告搜索字词视图 dynamic_search_ads_search_term_view.search_term
metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions 		仅在实施动态搜索广告时才需要。
R.130 出价策略 bidding_strategy.type
metrics.clicks
metrics.cost_micros
metrics.cost_per_conversion
metrics.impressions
metrics.average_cpc
metrics.conversions 		必需
bidding_strategy.status 如果要显示已暂停、有效以及已移除状态的策略，则为必选。
如果只显示有效的策略，则为可选。

应用广告系列工具功能列表

商品编号 功能 对象/字段/指南 要求

创建功能
C.20 启用地理位置定位 地理位置定位 必需。 如果只有一个国家/地区与用户群相关，可以选择向用户公开。
C.30 启用语言定位 campaign_criterion.language
language_constant		 必需。如果只有一种语言与用户群相关，可以选择向用户显示。
C.65 创建网站 / 来电转化并生成代码段 转化跟踪 必须至少选择一种转化跟踪。
C.96 设置出价选项：目标每次转化费用（“组合”和“标准”） campaign.target_cpa（标准）
bidding_strategy.target_cpa（组合）		 必需。“组合”和“标准”策略均需在广告系列一级支持。
设置出价选项：预注册 以吸引用户预注册为目标的应用广告 对于预注册应用广告系列，必须填写此字段。
C.190 制作广告组 ad_group 必需。可选：能够创建多个广告组。
向广告组添加素材资源 ad_group 必需：文字素材资源。图片和视频素材资源的可选标记。
C.601 创建安装或再互动 应用广告系列   必需：应用安装广告系列或应用广告系列再互动（但不能同时采取这两种措施）。
C.602 启用应用广告系列设置 AppCampaignSetting 必需：能够选择要宣传的应用或添加以吸引用户互动为目标的深层链接。

管理功能
M.601 暂停 / 启用 / 移除应用广告系列 campaign.status 必需
M.602 修改应用广告系列设置 campaign.*setting 必需

报告功能
R.10 账号效果 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions 		必需
R.20 广告系列效果 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
 如果要显示已暂停、有效以及已移除状态的广告系列，则为必选。
如果只显示有效的广告系列，则为可选。

酒店专用工具功能列表

商品编号 功能 对象/字段/指南 要求

创建功能
C.11 制作酒店广告系列 酒店广告系列 必需
C.12 为酒店广告系列设置 Hotel Center 标识符 HotelSettingInfo 必需
C.20 启用地理位置定位 地理位置定位 必需：如果只有一个国家/地区与用户群相关，则向用户显示可选。
C.30 启用语言定位 campaign_criterion.language
language_constant		 必需。如果只有一种语言与用户群相关，可以选择向用户显示。
C.65 创建网站 / 来电转化并生成代码段 转化跟踪 必须至少选择一种转化跟踪。
C.120 设置预算 campaign_budget 必需
  设置出价策略 酒店出价 可选，允许用户选择特定出价策略并设置目标。
C.190 制作酒店广告组 ad_group 必需。可选：能够创建多个广告组。
C.526 添加第一个（根）分区的酒店组分区 酒店信息组 投放酒店广告系列所必需的标记，但不要求用户展示。

管理功能
M.10 修改广告系列设置 campaign.*setting 必需
M.110 暂停/启用/移除广告系列 campaign.status 必需
M.161 细分（添加酒店组划分） 酒店信息组 必需
M.191 排除酒店组 AdGroupCriterion 必需

报告功能
R.10 账号效果 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions 		必需
R.20 广告系列效果 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
 如果要显示已暂停、有效以及已移除状态的广告系列，则为必选。
如果只显示有效的广告系列，则为可选。
R.111 “酒店效果视图”报告 hotel_performance_view 必需

效果最大化广告系列功能列表

商品编号 功能 对象/字段/指南 要求

创建功能
C.10 制作广告系列 campaign 必需。可选：可以制作多个广告系列。
C.20 启用地理位置定位 地理位置定位 必需。 如果只有一个国家/地区与用户群相关，可以选择向用户公开。
C.30 启用语言定位 campaign_criterion.language
language_constant		 必需。如果只有一种语言与用户群相关，可以选择向用户显示。
C.65 创建网站 / 来电转化并生成代码段 转化跟踪 必须至少选择一种转化跟踪。
C.120 设置预算 campaign_budget 必需
  设置出价策略   可选，允许用户选择特定出价策略并设置目标。

管理功能
M.10 修改广告系列设置 campaign.*setting 必需。只需在更改时创建时所需的设置即可。
M.110 暂停/启用/移除广告系列 campaign.status 必需

报告功能
R.10 客户 metrics.clicks
metrics.cost_micros
metrics.conversions
 必需。如果只显示一个广告系列，则为可选。
R.20 广告系列 metrics.clicks
metrics.cost_micros
metrics.conversions
 必需

智能广告系列功能列表

下表列出了投放智能广告系列所需的最基本功能。如果您的工具实现了智能广告系列，您必须至少实现这组功能。如果您的工具不实现智能广告系列，则不需要这些功能。

商品编号 功能 对象/字段/指南 要求

创建功能
C.10 制作智能广告系列 智能广告系列 必需
  添加关键字主题 KeywordThemeInfo 对于广告系列制作过程而言是必需的，但对于向用户公开则是可选的。
C.20 启用地理位置定位 地理位置定位 对于广告系列制作过程而言是必需的，但对于向用户公开则是可选的。
C.70 地址素材资源 地址素材资源 仅在与商家资料集成时才需要。
C.120 设置预算 campaign_budget 必需
C.200 添加广告 制作广告 对于广告系列制作过程而言是必需的，但对于向用户公开则是可选的。

管理功能
M.10 修改广告系列设置（向广告客户显示的所有广告系列制作设置） campaign.*setting 必需
M.110 暂停/启用/移除广告系列 campaign.status 必需
M.130 暂停/启用/移除广告 ad_group_ad.status 必需
  设置 / 修改广告系列投放时间 ad_schedule 必需
  移除 / 添加关键字主题 KeywordThemeInfo 对于广告系列制作过程而言是必需的，但对于向用户公开则是可选的。
  添加/移除否定关键字主题 KeywordThemeInfo 对于广告系列制作过程而言是必需的，但对于向用户公开则是可选的。

报告功能
R.20 广告系列效果 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
 如果要显示已暂停、有效以及已移除状态的广告系列，则为必选。 如果只显示有效的广告系列，则为可选。
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS 		仅在与商家资料集成时才需要。
R.70 智能广告系列搜索字词视图 metrics.clicks
metrics.cost_micros
 必需

标准购物广告系列工具功能列表

商品编号 功能 对象/字段/指南 要求

创建功能
C.10 制作广告系列 campaign 必需
C.20 启用地理位置定位 地理位置定位 必需。 如果只有一个国家/地区与用户群相关，可以选择向用户公开。
C.65 创建网站 / 来电转化并生成代码段 转化跟踪 必须至少选择一种转化跟踪。
C.97 设置出价选项：目标广告支出回报率（“组合”和“标准”） campaign.target_roas（标准）
bidding_strategy.target_roas（组合）		 必需。“组合”和“标准”策略均需在广告系列一级支持。
C.120 设置预算 campaign_budget 必需
C.190 制作广告组 ad_group 必需。可选：能够创建多个广告组。
C.270 添加广告系列否定关键字 campaign_criterion.negative 必需
C.300 设置关键字匹配类型 ad_group_criterion.keyword
 .match_type		 必需
C.505 设置商家 ID   必需
C.506 设置销售国家/地区   必需
C.510 设置产品目录过滤条件   必需
C.520 制作产品广告   必需
C.525 添加首个（根）产品划分   必需
C.530 制作本地商品目录广告   必需

管理功能
M.10 修改广告系列设置 campaign.*setting 必需。只需在更改时创建时所需的设置即可。
M.97 修改出价选项：目标广告支出回报率（组合和标准） campaign.target_roas（标准）
bidding_strategy.target_roas（组合） 		必需。“组合”和“标准”策略均需在广告系列一级支持。
M.110 暂停/启用/移除广告系列 campaign.status 必需
M.150 修改产品目录过滤条件   必需
M.160 细分（添加产品划分）   必需
M.170 删除产品划分   必需
M.190 排除产品划分   必需

报告功能
R.10 客户 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
 必需。如果只显示一个广告系列，则为可选。
R.20 广告系列 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
 必需
R.70 搜索字词视图 search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions 		必需
R.110 购物效果报告 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
 仅在实施动态搜索广告时才需要。
R.120 产品划分 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
 必需。如果商品未细分，则为可选属性
R.130 出价策略效果   必需。如果商品未细分，则为可选属性