当前位置:首页 > 内容营销 > 正文

AWR 中的开发人员 API v2

AWR 中的开发人员 API v2

AWR Cloud Developer API 版本 2 旨在帮助您提高生产力并专注于重要的事情。 新功能和改进的现有功能。...

我们发布了 AWR Developer API 版本 2!

因为你们中的一些人已经期待了一段时间,我想我会写一篇文章来告诉你们一些关于新功能的信息。

首先,如果您仍在使用 v1,请不要担心。 开发者 API 的第一个版本不会停产,因此您可以像以前一样继续使用它。

尽管如此,我还是鼓励您在进行切换之前查看 v2 并了解更多详细信息。

AWR Developer API 的第 2 版旨在帮助您提高生产力并专注于重要的事情:您的应用程序。 我们添加了许多新功能并改进了现有功能,我们认为您会对其新的灵活性和容量感到非常满意。

一些新开发的调用和操作是基于您的建议和反馈。 在我详细介绍这些新功能是什么之前,我要代表团队感谢您抽出时间将它们发送进来。我相信你们中的一些人会在下面的段落中认识到自己的想法。

因此,您将在新版本中找到以下内容:

对 Search Console 和可见性数据的新调用

通过新版本的 API,我们旨在扩展为您的项目提供的数据。 除了关键字排名位置,现在您可以自动从 Google Search Console 帐户获取信息,以及 AWR 根据您跟踪的关键字和搜索引擎计算的可见性值。

历史 Search Console 数据

如您所知,该应用程序可以在超过 90 天标准的时间范围内向您显示 Google 关键字数据。 从您在 AWR 项目和 Search Console 帐户之间建立连接的那一刻起,您的数据就会被存储。 导出将包括所选设备和时间范围的展示次数、点击次数、平均排名点击率

要获取历史 Search Console 数据,可以使用以下调用:

  • action=gwt_export:这会安排将数据导出到 CSV 并返回导出的获取链接。
  • action=get_gwt:调用开始导出文件下载。

能见度数据

现在,您可以轻松地将 AWR 中的 Visibility 值导出到您自己的仪表板中——不再需要复制计算公式。 可以使用新的 API 调用直接检索值。

导出文件将包含我们文档中解释的可见性值,该值是针对目标日期项目中监控的主网站和竞争对手网站计算得出的。

这些是获取可见性数据的新调用:

  • action=visibility_export:这会安排将数据导出到 CSV 并返回导出的获取链接。
  • action=get_visibility:调用开始导出文件下载。

按需估算和请求排名更新

由于按需更新请求功能对我们所有的用户都非常重要和有用,因此我们希望通过新版本的 API 创造更多的可用性。 我们添加了两个新调用,这些调用在之前版本的 API 中非常需要。

估算资源消耗

首先是[estimate on demand]调用,它可以帮助您查看按需更新将从您的配额中消耗多少资源。 这使您可以在实际请求数据刷新之前查看是否仍有足够的资源。

手动请求排名

现在,您可以请求应用程序的按需排名数据。 调用简单明了: [按需] - 它会推送您项目的实际排名更新。

如您所知,按需更新有两种类型,具体取决于预计完成时间:

  • 慢(排名在 7 天内交付)
  • 快速(24小时内有数据可用)

批量删除项目

现在您可以从您的帐户中批量删除项目,因此清理工作应该会更快更整洁。 当您运行季节性 SEO 活动或用于营销潜在客户的临时活动时,这会很有帮助。 因此,在完成这些项目并导出数据后,您可以一次性将它们全部删除。

以下是 v2 中批量项目删除的样子:

 key="inputs" value={"projects":[ {"name" : "project1"}, {"name" : "project2"}, {"name" : "project3"} ... ]}

您收到的回复将包括呼叫中项目的列表,以及每个项目的相关状态:

  • 0 – 对于已成功从帐户中删除的项目
  • 15 – 对于账户中已经不可用的项目

支持响应呼叫

API v2 为您提供了接收 JSON 响应而不是纯文本的可能性。 但简而言之,您可以在 v2 文档的响应消息部分找到可用的响应代码的完整列表。

在那里,您还可以找到有关新 API 版本中集成的新调用的更多技术细节。

现有报告的新列

以下是将包含在您的 API 中的一些新数据列:

  • 对于[出口排名] - 添加了一个名为“当前访问次数”的新列。 这反映了与导出中每个关键字相关的 Google Analytics 自然访问的价值。 UI 中的通讯员视图是 Rankings – Keyword Rankings。
  • 对于[topsites export] - 添加了“页面”列。 这显示了 SERP 页面,其中找到了显示结果的排名 URL。 UI 中对应的视图是排名 - 网站排名 - 热门站点。

支持向新/现有关键字添加/删除关键字组

此功能在使用[更新项目]调用时可用。 根据经验,该调用可帮助您更改项目中输入的属性,但不会更改输入本身。

让我们举一个例子,其中关键字“key_example”属于两个关键字组:“group_example”和“group_example2”。 要从第一个组中删除此关键字,并将其分配给第二个组,调用将如下所示:

 inputs= { "keywords":[ {"name":"key_example","operation":2,"kw_groups":"group_example2"} ], }

因此,在更新关键字的此属性时,只会保留或添加提供的组。

v2 中的其他更改

我们想在这个版本的 API 中添加很多新东西,但我们首先想专注于像您这样的用户要求的功能 - 同时添加一些我们自己的想法。 要全面了解改进,您必须试用 API。 但您可能想立即了解以下其他一些变化:

编码导出内容

API v2 的功能也得到了改进。

如果您正在跟踪的网站包含带有空格字符的 URL,您可能需要在导出到 CSV 调用(export_rankingexport_topsites) 中添加&encodedurl=true 。 这将确保在导出文件中对 URL 进行良好编码。 例如,像“http://www.test.com/url space”这样的 URL 将在单元格中导出为 http://www.test.com/url%20space。

单元格值内的引号被转义

现在所有字段都用引号括起来,并根据标准 CSV 规范用逗号分隔。 字段中的引号字符使用前面的引号进行转义。 例如, 8” bar 在 CSV 单元格中被编码为“8” bar

除其他详细信息外,我们还在[导出排名]调用中添加了一个新的可选参数,用于 CSV/JSON 文件格式。 如果导出调用中未提供格式,则默认情况下将文件生成为 CSV。

我们真的希望您会对这些新的改进感到高兴。

API v2 适用于从 Agency 开始的月度计划以及所有年度计划。 请记住,您仍然可以像以前一样使用 v1,但我们建议您在准备好后切换到 v2。 您可以随时联系我们的支持团队,他们将很乐意以任何方式为您提供帮助。

现在,交给你:

您如何看待新的改进? 您希望在 V2 中看到我们没有包含的任何内容吗?

我很想听听您对此的想法并获得您的反馈!

,

最新文章