npm 包 webdura_node_adwords-es5 使用教程

阅读时长 11 分钟读完

在前端开发中,我们经常需要使用到各种 npm 包来解决问题和提高工作效率。webdura_node_adwords-es5 就是一款用于 Google AdWords API 的 npm 包,本文将会详细介绍如何使用它。

安装

安装 webdura_node_adwords-es5 很简单,只需要打开终端并输入以下命令即可:

此外,还需要在项目中安装如下依赖:

使用

webdura_node_adwords-es5 主要提供了如下功能:

  • 认证并获取 access token
  • 获取所有客户账户的 ID
  • 获取账户下所有广告系列的 ID
  • 获取单个广告系列的详细信息

认证

首先,需要在 Google Developer Console 上创建一个项目并启用 AdWords API 的访问权限。接着,在项目中创建一个 OAuth2 客户端 ID,并将生成的客户端 ID 和客户端密钥添加到你的代码中。代码示例如下:

-- -------------------- ---- -------
----- - ---- - - -------------------------------
----- - ---------- - - ------------------------------------
----- ------------ - ------------------

----- ------------ - --- ----------------------- -------------- --------------

----- -------- - ----- -- -- -
  ----- --- - ------------------------------
    ------------ ----------
    ------ -----------------------------------------
  ---
  ------------------- ----- ---- --- -- --------- --- -------------- -----
  ----- ---- - ----- ------------------ --- ------------- ----- ---
  ----- - ------ - - ----- ----------------------------
  ------ --- -------------------
-

generateAuthUrl 方法中指定了 access_type 参数为 offline,这样我们就能够获取到 refresh token,保证认证信息的可持续性。

获取账户和广告系列 ID

获取账户和广告系列 ID 主要使用如下两个方法:

-- -------------------- ---- -------
----- - --------------- - - ------------------------------------

----- ------- - --- -----------------
  ------------ ----- -----------
  ----------------- -----------
---

----- -------- --------------- -
  ----- --- - ----- ----------------------
  ------ --------------- -- -------------------
-

----- -------- ------------------------- -
  ----- --- - ----- ----------------------
    ------- -
      -------------
      -------
      -------------------------
    --
    ----------- -
      -
        ------ ---------
        --------- ------------
        ------- ------------
      --
      -
        ------ -----------------
        --------- ------------
        ------- ------------
      --
      -
        ------ -------------------------
        --------- ---------
        ------- -----------
      --
    --
  -- - ------------------ --------- ---
  ------ ---------------- -- -------------
-

getAccountsgetCampaigns 方法中,需要传入一个对象,指定相应的参数。比如在 getCampaigns 方法中,我们指定了需要返回广告系列的 ID、名称和广告渠道类型,以及必须在搜索广告中使用的彩色标的物类型。 predicates 则表示需要过滤的条件。具体的字段和运算符可以在 AdWords API 的文档中找到。

获取广告系列详细信息

要获取单个广告系列的详细信息,可以使用如下代码:

-- -------------------- ---- -------
----- - --------------- - - ------------------------------------

----- ---------- - --------------------------

----- ------- - --- -----------------
  ------------ ----- -----------
  ----------------- -----------
---

----- -------- ----------------------- -
  ----- --- - ----- ----------------------
    ------- -
      -------------
      -------
      ---------
      -----------------
      -----------
    --
    ----------- -
      -
        ------ -------------
        --------- ---------
        ------- -------------
      --
    --
  ---
  ------ ---------- - - - ------ - -----
-

fields 中指定需要返回哪些字段,而 predicates 则表示需要过滤的条件。在这个例子中,我们只需要通过广告系列 ID 过滤出单个广告系列,因此只使用了 CampaignId 作为过滤条件。

示例代码

-- -------------------- ---- -------
----- - ---- - - -------------------------------
----- - ----------- --------------- - - ------------------------------------

----- --------- - ------------------------
----- ------------- - ----------------------------
----- ------------ - ----------------------------

----- ---------- - -------------------------
----- ----------- - --------------------------

----- ------------ - --- ---------------------------- -------------- --------------

----- ----------- - -------------- -- -
  ----- -------- - -------------------------------------
      ------ --------------
      ------- ---------------
  ---
  ------ --- ----------------- ------- -- -
    ------------------------------- ------- -- -
        -----------------
        ---------------
    ---
---
-

----- -------- - ----- -- -- -
  ----- --- - ------------------------------
    ------------ ----------
    ------ -----------------------------------------
  ---
  ------------------- ----- ---- --- -- --------- --- -------------- -----
  ----- ---- - ----- ------------------ --- ------------- ----- ---
  ----- - ------ - - ----- ----------------------------
  ------ --- -------------------
-

----- -------- --------------- -
  ----- ------- - --- -----------------
    ------------ ----- -----------
    ----------------- -----------
  ---
  ----- --- - ----- ----------------------
  ------ --------------- -- -------------------
-

----- -------- ------------------------- -
  ----- ------- - --- -----------------
    ------------ ----- -----------
    ----------------- -----------
  ---
  ----- --- - ----- ----------------------
    ------- -
      -------------
      -------
      -------------------------
    --
    ----------- -
      -
        ------ ---------
        --------- ------------
        ------- ------------
      --
      -
        ------ -----------------
        --------- ------------
        ------- ------------
      --
      -
        ------ -------------------------
        --------- ---------
        ------- -----------
      --
    --
  -- - ------------------ --------- ---
  ------ ---------------- -- -------------
-

----- -------- ----------------------- -
  ----- ------- - --- -----------------
    ------------ ----- -----------
    ----------------- -----------
  ---
  ----- --- - ----- ----------------------
    ------- -
      -------------
      -------
      ---------
      -----------------
      -----------
    --
    ----------- -
      -
        ------ -------------
        --------- ---------
        ------- -------------
      --
    --
  ---
  ------ ---------- - - - ------ - -----
-

------ -- -- -
  ----- ---------- - ----- ----------------
  -------------------- ------ ------------

  ----- ----------- - ----- ------------------------------
  --------------------- ------ -------------

  ----- -------- - ----- ----------------------------
  ------------------------ ----------
-----

总结

通过本文,我们了解了如何使用 webdura_node_adwords-es5 包来访问 AdWords API。这对于需要在前端中使用 AdWords API 的开发人员来说非常有帮助。同时,我们也通过示例代码了解了如何使用该包的主要功能。希望这对你有所帮助!

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600562a481e8991b448dfda9

纠错
反馈