在前端开发中,我们经常需要使用到各种 npm 包来解决问题和提高工作效率。webdura_node_adwords-es5 就是一款用于 Google AdWords API 的 npm 包,本文将会详细介绍如何使用它。
安装
安装 webdura_node_adwords-es5 很简单,只需要打开终端并输入以下命令即可:
npm install webdura_node_adwords-es5 --save
此外,还需要在项目中安装如下依赖:
npm install google-auth-library npm install googleapis
使用
webdura_node_adwords-es5 主要提供了如下功能:
- 认证并获取 access token
- 获取所有客户账户的 ID
- 获取账户下所有广告系列的 ID
- 获取单个广告系列的详细信息
认证
首先,需要在 Google Developer Console 上创建一个项目并启用 AdWords API 的访问权限。接着,在项目中创建一个 OAuth2 客户端 ID,并将生成的客户端 ID 和客户端密钥添加到你的代码中。代码示例如下:
-- -------------------- ---- ------- ----- - ---- - - ------------------------------- ----- - ---------- - - ------------------------------------ ----- ------------ - ------------------ ----- ------------ - --- ----------------------- -------------- -------------- ----- -------- - ----- -- -- - ----- --- - ------------------------------ ------------ ---------- ------ ----------------------------------------- --- ------------------- ----- ---- --- -- --------- --- -------------- ----- ----- ---- - ----- ------------------ --- ------------- ----- --- ----- - ------ - - ----- ---------------------------- ------ --- ------------------- -
在 generateAuthUrl
方法中指定了 access_type
参数为 offline
,这样我们就能够获取到 refresh token,保证认证信息的可持续性。
获取账户和广告系列 ID
获取账户和广告系列 ID 主要使用如下两个方法:
-- -------------------- ---- ------- ----- - --------------- - - ------------------------------------ ----- ------- - --- ----------------- ------------ ----- ----------- ----------------- ----------- --- ----- -------- --------------- - ----- --- - ----- ---------------------- ------ --------------- -- ------------------- - ----- -------- ------------------------- - ----- --- - ----- ---------------------- ------- - ------------- ------- ------------------------- -- ----------- - - ------ --------- --------- ------------ ------- ------------ -- - ------ ----------------- --------- ------------ ------- ------------ -- - ------ ------------------------- --------- --------- ------- ----------- -- -- -- - ------------------ --------- --- ------ ---------------- -- ------------- -
在 getAccounts
和 getCampaigns
方法中,需要传入一个对象,指定相应的参数。比如在 getCampaigns
方法中,我们指定了需要返回广告系列的 ID、名称和广告渠道类型,以及必须在搜索广告中使用的彩色标的物类型。 predicates
则表示需要过滤的条件。具体的字段和运算符可以在 AdWords API 的文档中找到。
获取广告系列详细信息
要获取单个广告系列的详细信息,可以使用如下代码:
-- -------------------- ---- ------- ----- - --------------- - - ------------------------------------ ----- ---------- - -------------------------- ----- ------- - --- ----------------- ------------ ----- ----------- ----------------- ----------- --- ----- -------- ----------------------- - ----- --- - ----- ---------------------- ------- - ------------- ------- --------- ----------------- ----------- -- ----------- - - ------ ------------- --------- --------- ------- ------------- -- -- --- ------ ---------- - - - ------ - ----- -
在 fields
中指定需要返回哪些字段,而 predicates
则表示需要过滤的条件。在这个例子中,我们只需要通过广告系列 ID 过滤出单个广告系列,因此只使用了 CampaignId
作为过滤条件。
示例代码
-- -------------------- ---- ------- ----- - ---- - - ------------------------------- ----- - ----------- --------------- - - ------------------------------------ ----- --------- - ------------------------ ----- ------------- - ---------------------------- ----- ------------ - ---------------------------- ----- ---------- - ------------------------- ----- ----------- - -------------------------- ----- ------------ - --- ---------------------------- -------------- -------------- ----- ----------- - -------------- -- - ----- -------- - ------------------------------------- ------ -------------- ------- --------------- --- ------ --- ----------------- ------- -- - ------------------------------- ------- -- - ----------------- --------------- --- --- - ----- -------- - ----- -- -- - ----- --- - ------------------------------ ------------ ---------- ------ ----------------------------------------- --- ------------------- ----- ---- --- -- --------- --- -------------- ----- ----- ---- - ----- ------------------ --- ------------- ----- --- ----- - ------ - - ----- ---------------------------- ------ --- ------------------- - ----- -------- --------------- - ----- ------- - --- ----------------- ------------ ----- ----------- ----------------- ----------- --- ----- --- - ----- ---------------------- ------ --------------- -- ------------------- - ----- -------- ------------------------- - ----- ------- - --- ----------------- ------------ ----- ----------- ----------------- ----------- --- ----- --- - ----- ---------------------- ------- - ------------- ------- ------------------------- -- ----------- - - ------ --------- --------- ------------ ------- ------------ -- - ------ ----------------- --------- ------------ ------- ------------ -- - ------ ------------------------- --------- --------- ------- ----------- -- -- -- - ------------------ --------- --- ------ ---------------- -- ------------- - ----- -------- ----------------------- - ----- ------- - --- ----------------- ------------ ----- ----------- ----------------- ----------- --- ----- --- - ----- ---------------------- ------- - ------------- ------- --------- ----------------- ----------- -- ----------- - - ------ ------------- --------- --------- ------- ------------- -- -- --- ------ ---------- - - - ------ - ----- - ------ -- -- - ----- ---------- - ----- ---------------- -------------------- ------ ------------ ----- ----------- - ----- ------------------------------ --------------------- ------ ------------- ----- -------- - ----- ---------------------------- ------------------------ ---------- -----
总结
通过本文,我们了解了如何使用 webdura_node_adwords-es5 包来访问 AdWords API。这对于需要在前端中使用 AdWords API 的开发人员来说非常有帮助。同时,我们也通过示例代码了解了如何使用该包的主要功能。希望这对你有所帮助!
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600562a481e8991b448dfda9