常见问题解答

一般性问题

注册

定价与合规

API版本控制

技术问题


一般性问题

什么是AdWords API?

通过AdWords API,开发者可以使用与AdWords服务器直接交互的应用。利用这些应用,广告客户可以更高效地管理大型AdWords帐户和广告系列。要了解有关API定价的详情,请查看AdWords API价目表

如何使用AdWords API?

您可以使用AdWords API来运用或开发一些程序,帮助自己或客户与相关的AdWords帐户更高效地进行交互。以下是您可使用AdWords API进行的部分操作:

  • 自动生成关键字、广告文字、网址和自定义报告
  • 将AdWords数据同其他数据库(例如库存系统)集成到一起
  • 开发其他工具和应用,帮助您更好地管理AdWords帐户

要开始编写程序,您只需拥有开发者令牌,您将在注册时获得此令牌。您的令牌获得批准后,您就可以访问API了。

谁应该注册AdWords API?

API面向通晓技术的大型广告客户与第三方的开发者,包括管理多个客户帐户和/或大型广告系列的SEM(搜索引擎营销商)、代理机构和其他在线营销专业人士。实现AdWords API需要有一定的技术知识和编程技能,因此广告客户最好聘请开发者进行实现,以便获得最佳成效。

如果我没有“我的客户中心”帐户,会出现什么情况?

您需要拥有我的客户中心(MCC)帐户才能申请访问API。如果您还没有MCC帐户,请创建一个。要了解关于“我的客户中心”的详情,请参阅我们的常见问题解答

如果您创建新MCC帐户来申请API令牌,请将全部的现有帐户或您客户的帐户关联至新MCC帐户。这可确保您的申请在最快时间里获得处理。如需具体说明,请访问此链接

为什么需要有“我的客户中心”帐户才能访问AdWords API?

开发者令牌只授予我的客户中心(MCC)帐户。AdWords API的典型用户是管理大量帐户的广告客户和代理机构,他们都已经拥有MCC帐户。

通过AdWords API管理AdWords帐户与通过AdWords界面管理AdWords帐户有区别吗?

AdWords API所提供的AdWords功能与我们通过在线界面提供的功能大体相同。您通过AdWords API做出的任何更改均会影响您的AdWords帐户。二者的区别在于,AdWords API 为开发者和用户提供更多灵活选择,来创建用于管理AdWords帐户的其他应用和工具。具体情况取决于您所使用的客户端软件和您所创建的程序。

我通过AdWords API做出的更改会反映在AdWords实际帐户中吗?

会。您通过AdWords API做出的所有更改均会影响AdWords实际帐户。我们建议,在将应用部署到生产环境中之前先在测试帐户中测试应用。

我可以开发哪些应用?

这完全取决于您的编程技术和广告需求。以下是您可使用AdWords API进行的部分操作:

  • 自动制作广告、广告组和广告系列
  • 自动下载报告以监测效果
  • 将AdWords数据同其他数据库(例如库存系统)集成到一起
  • 开发其他工具和应用,帮助您更好地管理AdWords帐户

参阅更多使用案例

什么是开发者令牌?

开发者令牌是一个由字母、数字和符号组成的具有唯一性的字符串,用于标识您的AdWords API活动。它是用来与AdWords服务器和您客户的AdWords帐户“交流”的密钥。为确保我们能标识您的活动,您应该在所有API请求的标头中加入开发者令牌。

为保护您免受欺诈,请勿与他人共享您的开发者令牌。您可以在AdWords API中心(可通过“我的客户中心”的我的帐户标签访问)里找到您的开发者令牌。

如何使用开发者令牌?

您应该在所有API请求的标头中加入您的开发者令牌,以便我们正确识别您的AdWords帐户活动并对其进行身份验证。如果您使用我们的其中一种客户端库,则可能无需直接对标头进行操作。

我需要聘请人员帮我开发程序。我应该在何处寻找开发者?

首先,您可以在我们的开发者论坛中进行搜索。在这里,您可以找到以前发布的帖子,或是发布您自己的信息。您也可以访问Webmaster World寻求帮助。如有疑问,请通过Google搜索“AdWords API 开发者”。请注意,这些开发者并未得到Google聘用、担保或批准。

在寻找开发者时,您需要仔细调查,并聘用您可以信任的开发者,这点十分重要。Google不会主导您与开发者建立合作伙伴关系的过程。因此,我们建议您在聘用开发者之前,先进行全面的筛选,了解尽可能多的相关信息。

我可以如何使用Google AdWords徽标?

下面列出了将AdWords徽标用于您的API客户端的一些限制。AdWords API条款中授予了您使用徽标的权利,您对徽标的使用需遵循以下限制。

根据AdWords API条款,您可以调整徽标的大小,从而使其适应您的AdWords API客户端应用,只要您保留徽标的宽高比即可。如果您在网页上使用徽标,则徽标每个边与您网页上的其他图形或文本元素之间的间距不得少于徽标高度的1/2。此外,徽标必须单独出现,且不得以任何形式向网页查看者暗示Google认可该网页上提供的任何非Google的产品、服务或信息。

您不得进行(且同意不进行)以下任何操作:

  • 以任何方式更改徽标的宽高比和颜色
  • 将徽标作为最明显的元素显示在您的网页上
  • 在显示徽标时暗示与Google有关系或是Google的联属企业,或得到了Google的赞助或担保。对徽标的使用不能被合理解释为相应内容或数据分析由Google或Google员工撰写,或者代表其观点或意见
  • 按照Google许可授权以外的方式在您的网站上显示徽标
  • 在任何产品、图书或其他材料商显示徽标(除了以上说明中指定的恰当方式)
  • 在包含或显示成人内容、宣传赌博、涉及向未满21周岁的用户销售烟草制品或酒类产品、或以其他形式违反使用法律或Google广告编辑政策相关规定的网站上显示徽标
  • 以Google认为具有误导性、诽谤性、侵权性、藐视性、污蔑性、猥亵性的方式或违反Google相关规定的方式显示徽标
  • 在违反任何法律或法规的网站上显示徽标
  • 对任何Google网页(包括点击Google徽标或Google搜索框后显示的网页)进行加框链接或镜像复制
  • 删除、改变徽标的任何元素或使其变形
  • 所显示的徽标尺寸大于您的名称、产品、服务名称、商标、服务标识、徽标、商户名称或公司名称,或与其相比更突出
  • 将徽标并入您的商户名称、企业名称、域名、产品名称、服务名称、徽标、商业包装、设计、标语或其他商标中
  • 翻译徽标或以其他方式将其本地化为任何其他语言。徽标的所有翻译版本必须由Google提供
  • 在您的任何材料中将徽标显示为设计特征
  • 在您的材料中以任何形式模仿徽标

除了以上所规定的方式,您不得以任何其他方式使用徽标。如果不遵守这些说明,会被认定为违反Google AdWords API协议。

如果我有AdSense或其他Google帐户,我可以注册吗?

可以。AdSense、Gmail 或其他Google服务用户可以注册Google AdWords API计划。我们仅要求您拥有当前AdWords帐户。如果您希望注册AdWords,请访问https://adwords.google.cn

我已经有一个“我的客户中心”帐户。如果我注册,这个帐户会怎样?

在您加入Google AdWords API计划之后,您的“我的客户中心”帐户将会自动更新,但不会有任何变化。您的个人信息以及所关联的客户帐户不会受到影响。唯一的区别是,您将会看到一个新的子标签,名为AdWords API中心,位于我的帐户标签下。点击该子标签可访问您的开发者令牌和API使用信息。

什么是SOAP?

SOAP是指Simple Object Access Protocol(简单对象访问协议)。它可用于信息交换和RPC,通常(也不全是)经由HTTP方式传输。要了解详细信息,请参阅具体规范。AdWords API使用SOAP架构。

什么是WSDL?

WSDL是指Web Service Description Language(网络服务描述语言)。它可提供网络服务的正式描述,类似于CORBA的IDL。您只需通过WSDL文件即可了解如何调用网络服务;工具包可直接从WSDL文件中生成代理代码。

什么是AdWords API邮寄列表?

AdWords API邮寄列表提供产品更新和通知,相关信息直接发送至您的电子邮件收件箱。我们的邮寄列表由Google网上论坛提供支持, 因此您可以通过简单三步注册此服务:

  1. 在AdWords API首页上输入您的电子邮件地址。
  2. 等待确认电子邮件发送至您的收件箱。
  3. 点击电子邮件中包含的验证链接,激活您的邮寄列表订阅。

这样就完成了!您无需在Google网上论坛确认页点击“加入”或“登录”链接。

如果有您可能感兴趣的产品功能通告,我们将向邮寄列表发送电子邮件,但我们不会向您发送任何与API无关的内容 — 您的电子邮件地址受到我们隐私权政策的保护。

查看有关如何退订API邮寄列表的说明。

我如何选择退出AdWords API通告邮寄列表?

您可以通过Google网上论坛取消订阅,从而选择退出AdWords API通知邮寄列表。方法如下:

如果您是已注册的Google网上论坛用户(或者您认为自己可能是):

  1. 前往通告邮寄列表成员页面
  2. 点击“取消订阅”按钮,将您的电子邮件地址从AdWords API通告邮寄列表中移除。

如果您不是Google网上论坛用户,您必须先注册Google网上论坛,然后才能选择退出邮寄列表。方法如下

  1. 注册Google网上论坛帐户(请务必使用您用来注册AdWords API通知邮寄列表的电子邮件地址)。
  2. 前往通告邮寄列表成员页面
  3. 点击“取消订阅”按钮,将您的电子邮件地址从AdWords API通告邮寄列表中移除。

查看有关如何订阅API邮寄列表的说明。

API何时会停机进行定期维护?

我们目前未安排维护计划。所有预期的服务中断都会在AdWords API通告论坛上发布。

在我的AdWords帐户中选择使用两步验证功能后,如何对AdWords工具进行授权?

我们强烈建议您使用OAuth2授权,而不要使用ClientLogin,因为后者现已停用,未来将移除。

如果您仍在使用ClientLogin,但又选择使用两步验证,并且您的Google帐户与其他Google产品(如AdWords API或AdWords编辑器)相关联,则您在使用这些工具登录时,需要输入应用专用密码,而不是您的常规帐户密码。了解如何生成应用专用密码(如需有关在AdWords编辑器中使用应用专用密码的说明,请参阅此文章)。

如果您不想继续使用两步验证功能,请按照这些说明为您的Google帐户停用两步验证。

如果需要帮助,我应该联系谁?

我们建议您仔细浏览AdWords API开发者网站。您在此处可以找到有用的指南、示例代码和参考文档。另外,您也可以加入我们的开发者论坛寻求其他AdWords API开发者的帮助,以及关注我们的Google+信息页以获取最新的API动态。

返回页首


注册

我的“公司类型”是什么?
当您申请AdWords API访问权限时,系统会询问您的公司类型。您有以下几种选择:
  • 广告客户:您只为自己公司的网站、产品或服务管理AdWords广告系列,不为任何其他公司管理AdWords广告系列。
  • 代理机构/搜索引擎营销商 - 您为客户管理AdWords广告系列,并且可以提供与在线营销、网络托管、搜索引擎优化等相关的其他服务。
  • 联属营销企业 - 您加入了其他公司的联属营销计划。您使用AdWords帮助他们在线投放产品广告。
  • AdWords独立开发者 - 您将使用AdWords API来开发与AdWords相关的软件并向其他人提供使用许可。您不为客户管理AdWords广告系列。
“集成服务”这个公司类型哪去了?

“集成服务”公司类型已经与“代理机构/搜索引擎营销商”合并。这对您访问API不会产生任何影响。

注册完之后,我需要什么来开始使用AdWords API?

您只需拥有已获批准的开发者令牌即可开始使用AdWords API。您可在注册AdWords API后获得令牌。

在您注册之后,您的开发者令牌将发送至您的帐户电子邮件地址。获得批准后,此令牌将被激活,您就可以在请求标头中加入此令牌以访问API。您可以在AdWords API中心(可通过“我的客户中心”的我的帐户标签访问)里找到您的令牌。

请参阅我们的常见问题解答,了解有关开发者令牌的详情。

如何更新我的开发者联系电子邮件地址?

要更改/更新您的联系电子邮件地址,请按以下说明操作:

  1. 登录到您的AdWords“我的客户中心”帐户,点击右上方的齿轮图标。
  2. 在下拉菜单中点击帐户设置
  3. 点击左侧导航标签中的AdWords API中心
  4. 在包含“开发者详细信息”的部分中,点击修改
注册后是否马上就可以开始使用API?

在您提供您的开发者和结算信息后,系统就会分配给您一个开发者令牌,但您需要等到令牌获得批准后才能访问API。AdWords API审核小组会在您申请后的一周内与您联系。在此期间,您可以申请测试帐户,以开始开发和测试您的应用。

关于我的应用及其用户,你们都需要哪些信息?

我们需要了解您的应用有什么用(例如自定义报告、帐户管理、出价优化等),以及哪些人会使用应用(例如公司同事、您的客户、广告客户或您要向其出售该应用的代理机构等)。请做详尽说明。向我们提供的应用和用户信息越详细,您获得批准的速度就越快,我们也能更好地了解您的需求,以继续为我们的用户开发最佳操作、资源和支持。我们不会与外部方分享您提供给我们的任何信息。

哪些常见原因会导致开发者令牌无法获得批准?

AdWords API条款及条件就如何正确使用AdWords API提供了详细指南。您必须在结算设置步骤中同意这些条款。如果您过去曾经(或今后打算)以有悖于这些条款的方式使用API,您的令牌可能就不会获得批准。如果您要开发外部工具供您的客户访问,则该工具必须实现我们的最低功能要求

详细了解如何注册AdWords API

返回页首


定价与合规

为什么免费提供AdWords API?

我们对AdWords API的使用收取小额费用,目的是鼓励开发者创建以高效和负责的方式与AdWords平台互动的应用。2010年,我们发布了兑换单元计划,向符合条件的代理机构和搜索引擎营销工具开发者提供免费的AdWords API单元。我们通过此计划获得了积极的反馈,现在希望向所有开发者提供免费使用,以鼓励创新。

AdWords API中有哪些不同的权限级别?

AdWords API权限分为两个级别:

  1. 基本
  2. 标准

访问权限级别只与每日操作数有关;我们仍在令牌一级设置了速率限制,以避免我们的系统承受过多的压力,并确保我们所有的API用户都能获得理想性能。此外,所有用户还必须遵守AdWords条款AdWords API条款最低功能要求(如果有)。不论是基本还是标准权限的访问,都不会产生AdWords API使用费。

基本权限:这是所有已获批准的开发者令牌的默认权限级别。拥有基本权限的开发者每天最多可执行10,000次操作。

标准权限:这是使用量需求更大的用户所需的权限级别。要获取此权限级别,开发者需要向Google提供额外的详细信息,并及时更新这些信息。

违规费用有哪些?金额是如何计算的?

为了确保最佳的广告客户体验和用户体验,我们会监测用户对AdWords API的使用以及他们的应用是否符合AdWords API条款及条件。

如果您的应用不符合规定,系统会对您进行提醒,要求您在规定的时间内进行适当修正。如果您在首次通知中规定的时间段结束时未做出任何修正,我们最多会再延长3个月。在此期间,您每月需要针对首次违规通知前一个月内所进行的每10,000次操作支付10美元的违规费用。之后如果违规情况仍然存在,我们就会撤消您的API权限。

详细参阅操作的计数方式

举个例子,假设您在4月份执行了1,000,000次操作,并且我们发现您的应用不符合AdWords API条款及条件的规定。您就会在5月1日收到一条通知,要求您在30天内对您的应用进行适当更改,使其符合相关规定。如果您在5月31日之前未进行所需的更改,则每月需要支付固定违规费用1,000美元(1,000,000/10,000 x $10),收费期限不超过3个月(6月、7月和8月)或直到您的应用符合相关规定为止(二者取其先)。

我们使用免费的API单元来宣传我们自己的企业。是否仍需要申请标准权限?

每日操作次数超过10,000的所有开发者都需要申请标准权限。基于AdWords支出分配免费API单元的机制将停用。根据您使用AdWords API的历史及您向我们提供的详细信息,我们可能会对您做标准权限预筛选。不过,为了确保您的API权限不受影响,我们建议您申请标准权限

我们已经获准使用兑换单元,并获得了免费的API单元。是否仍需要申请标准权限?

不一定。我们面向代理机构和搜索引擎营销工具开发者提供的兑换单元计划将停止。从2013年3月1日开始,每日操作次数超过10,000的所有开发者都需要标准权限。根据您使用AdWords API的历史及您向我们提供的详细信息,我们可能会对您做标准权限预筛选。不过,为了确保您的API权限不受影响,如果您没有收到我们的邮件,或者您在申请兑换单元时提供的详细信息最近发生了变化,我们建议您申请标准权限

我们可以继续按当前的标准支付AdWords API费用,而不申请标准权限吗?

不能。如果您每天执行或预期执行的操作次数少于10,000,即无需申请标准权限。

AdWords API操作次数是如何计算的?

从2013年3月1日开始,API单元将停用,所有操作都将平等计数。临时报告下载请求和测试帐户执行的任何请求都不会计入基本权限的限额中,也不会用于计算违规费用。在批量mutate作业中,系统会单独统计每次操作。

每种AdWords API操作(如getmutate)都单独计数。例如,一次生成10个结果对象的get操作将只计数一次。对于mutate来说,每转变一个项目即视为一次操作。下表举例说明了新计算机制的工作方式:

API请求 计入每日限额的操作次数
操作:get
计数:53个广告组
服务:AdgroupAdService
1
操作:mutate (ADD)
计数:2个广告组
服务:AdgroupAdService
2
操作:get
计数:100个定位参考提示
服务:TargetingIdeaService
1
操作:HTTP POST
计数:1个报告
服务:临时报告下载
0
操作:mutate (ADD)
计数:10个广告系列
服务:MutateJobService
10
如何查看我的API使用量并确定我是否需要申请标准权限?

在API定价机制停用后,AdWords API InfoService数据中将只包括历史使用数据。因此,您需要在客户端的应用日志上监测API使用情况,以确定您是需要基本权限还是标准权限。

何时需要申请标准权限?

如果您未在2013年2月28日之前申请标准权限,则您拥有的是默认的基本权限。如果您预期未来的使用量会超出基本权限的限额,应提前至少3个星期申请标准权限,并在申请中提供尽可能详细的信息,以确保您的申请及时获得处理。

标准权限申请的审批需要多长时间?

如果您在标准权限申请表上提供的详细信息准确无误,且及时回复后续的澄清性问题,我们会在大约2个星期内完成审核。

标准权限审批延迟或未通过的常见原因有哪些?

审批延迟的常见原因包括:

  • 标准权限申请表上提供的详细信息不完整
  • 与AdWords API开发者令牌关联的MCC帐户中的详细联系信息不准确
  • AdWords API支持小组后续发送的问题和澄清说明未收到回应
  • 未按AdWords API条款及条件的规定使用API
  • 未实现最低功能要求
  • 当前的AdWords API使用量非常低,尚不能作为申请标准权限的理由

何时需要重新申请标准权限?

如果您在原始标准权限申请表中提供的信息发生了变化,或者AdWords API支持小组提出了要求,则您需要使用标准权限申请表更新您的详细信息。

例如,如果您之前只为一个网站投放广告,但现在希望代表多个客户进行投放;或者您的工具之前只提供报告功能,而您现在想要实现广告系列制作和管理,就需要通过标准权限申请表更新相关详细信息。

虽然API可以免费使用,但我们在申请AdWords API令牌时是否仍需提供结算明细?

API令牌申请流程并未更改,因此申请API令牌时仍需提供结算信息和其他详细信息(例如联系信息)。不过,在基本权限或标准权限限制范围内的API使用不需要付费。

返回页首


API版本控制

我如何知道最新的版本号是什么?

版本号是WSDL访问网址的一部分。在开发者指南文档中,“版本说明”和“参考”页面上都显示有版本号。

旧版本的AdWords API WSDL将提供多长时间?

如果某个版本的WSDL被更新版本所取代,我们将继续对旧版本提供为期4个月的支持,为用户迁移至新版本留出时间。在此期间,AdWords API会继续允许开发者访问过去4个月内所发布的任何版本,并对这些版本提供相应的支持。如需版本相关文档,请参阅版本说明停止服务计划

我如何访问旧版本的WSDL?

只有版本还能用,我们就会在WSDL访问网址中提供WSDL版本号。

如果新版本中删除了受支持的旧版本中仍然提供的功能,会出现什么情况?

如果新版本取消或修改了旧版本(仍可使用)的功能,我们会在版本说明中标注这些更改,并在博文中对新发布版本的更新进行说明。我们还会提供迁移指南来协助您升级。

为了让开发者有充裕的时间迁移到新版本,我们会在新版本推出后的4个月内继续提供和更新旧版本及相关文档。

返回页首


技术问题

如何调试和诊断应用中的SOAP消息?

我们建议您使用我们的其中一种客户端库来开发应用,而不要自行构建SOAP。

通过API返回的ID是唯一的吗?

关键字和广告素材的ID仅在其所在的广告组中是唯一的,而广告系列和广告组ID在任何地方都是唯一的。有关详情,请参阅“使用对象”指南

你们使用/支持哪些网络服务技术?

我们使用SOAP 1.1和WSDL 1.1。为了保护用户的隐私,所有消息均通过SSL (https)发送,并且使用内置的密码进行验证。我们目前不使用任何更高级别的WS-*规范。

我们的目标是实现在任何客户开发环境下都能与SOAP工具包协同工作。目前我们提供Java、PHP、Python、.NET、Perl和Ruby格式的客户端库

什么是操作?

操作是指您对AdWords帐户所采取的一次动作。

不管其影响的广告组(或其他对象)有多少,一个get请求计为一次操作。对于每个mutate,其中包含的每次操作都计数一次。类似地,在批量mutate作业中,系统会单独统计每次操作。

有关API操作的详细信息,请访问我们的API价目表

我何时应该重置开发者令牌?

基本上不应该重置。只有在遇到令牌被盗或泄露等非常少见的情况时,您才需要重置开发者令牌。您应像对待帐户登录信息和密码那样确保开发者令牌的安全。

重置开发者令牌后会出现什么情况?

我们将删除相关令牌,并从数据库中将其移除。重置后您就无法刷新您的开发者令牌,因此请谨慎做出重置决定。

在哪里报告错误?

您可以在我们的支持页面上通过电子邮件发送可疑错误给我们。请提供尽可能详尽的信息,包括屏幕截图或错误示例。由于支持仅适用于AdWords API,因此请不要将此电子邮件地址用于报告错误之外的目的。您可以将一般性开发者评论发送到开发者论坛

返回页首

发送以下问题的反馈:

此网页
AdWords API
AdWords API
需要帮助?请访问我们的支持页面