关联用户账号（客户端 JavaScript）

注意： 如果您的发布内容使用“通过 Google 订阅”的其他功能， swg.js 客户端假定发布内容已经过配置，并且 已初始化库，如“通过 Google 订阅”开发者网站中所述。 您可以选择将“通过 Google 订阅”与订阅关联功能搭配使用。

利用订阅关联功能，客户端 JavaScript 是创建 PPID与读者 Google 账号之间的新关联。在已配置的页面上，系统会向读者显示一个对话框，要求他们关联订阅。读者点击“Continue with Google”（使用 Google 账号继续）按钮后，可以选择要关联的账号，完成后会返回到已配置的页面。

您可以使用 swg.js 中的 linkSubscription 方法将 PPID 与读者的账号相关联。用法与之前的账号类似 关联功能（示例）， 但该方法不会传递 promise，而是接受包含 PPID。

代码示例

这些客户端代码示例说明了如何发起链接， 以及（可选）如何使用 swg.js eventManager 来 监听 Analytics 事件并相应地进行路由。

启动“订阅关联”对话框

const result = await subscriptions.linkSubscription({publisherProvidedId:6789})

注意： 请勿无条件地提示用户！您不应针对 已经关联其订阅，因此您应该延迟重新提示那些 近期拒绝了关联订阅。

响应示例

成功关联的账号中的有效响应同时包含关联中使用的 PPID 和布尔值 success 状态。

console.log(result) //{publisherProvidedId: 6789, success: true}

订阅关联不需要使用 第三方 Cookie 或读取者的有效 Google 会话。这种调整方式 使读者可以随时进入链接体验 而不只是在购买后才提供。如果读者未登录 Google 账号，则他们有机会在流程中完成此操作。

完整的客户端示例

<script
  async
  type="application/javascript"
  subscriptions-control="manual"
  src="https://news.google.com/swg/js/v1/swg.js">
</script>

<script>

  function linkSubscription(ppid) {
    self.SWG.push(async (subscriptions) => {
      try {
        const result = await subscriptions.linkSubscription({
          publisherProvidedId: ppid,
        })
        console.log(result)
      } catch(e) {
        console.log(e)
      }
    })
  }

  document.addEventListener('DOMContentLoaded', function () {
    (self.SWG = self.SWG || []).push(subscriptions => {
      subscriptions.init("PUBLICATION_ID");

      //Configure the event manager for analytics integration
      subscriptions.getEventManager().then(manager => {
        manager.registerEventListener((event) => {
            // Add code here to send the event to your analytics
            // sendToAnalytics(event);
          console.log(event);
        });
      });
    });

    document
      .querySelector("SELECTOR")
      .addEventListener('click', function(){
        linkSubscription(PPID)
      })
  });
</script>

创建 OAuth 客户端 ID

虽然订阅关联不需要 OAuth 客户端，但 OAuth 客户端可用于为您的项目编写已获授权网域的许可名单。已获授权的网域是一系列网域，您的客户端 JavaScript 可从中 通过 进行调用。您的出版物可能已在发布商中心内配置了 OAuth 客户端 ID，以便与 swg.js 搭配使用。

• 如果您的订阅关联客户端 JavaScript 调用源自之前验证过的域名，则无需执行任何操作。
• 如果您的 JavaScript 是通过新域名运行的，请遵循 SwG OAuth 客户端 ID 配置说明。

注意：只有在启用“通过 Google 订阅”后再启用订阅功能的出版商才能创建和使用 OAuth 客户端。

测试

如需测试订阅关联的客户端实现，必须从具有已获授权的 JavaScript 源的服务器运行代码。

1. 在生产环境中使用时，已获授权的来源可以来自配置的 OAuth 客户端，或发布内容设置中的已验证网域列表 。
2. 如果要将不可验证的网域（例如 localhost 或非公开服务器）用于开发或预演，则必须在配置的 OAuth 客户端中列出该网域。

注意 ：将网域添加到 OAuth 客户端的“允许的来源”列表可能需要更多时间 超过 30 分钟才可供使用。

要点 ：若要使用同一个订阅账号持续进行测试， 可以通过 Google 的我的账号页面手动解除关联。

排查错误

测试客户端 JavaScript 时最常见的问题是，在尝试运行 JavaScript 时收到 403 - Not Authorized 错误。要解决 那么请确保您是在 或者您是在位于 关联 OAuth 客户端的授权 js 来源。

下一步

恭喜您完成客户端 JavaScript 集成。现在，您可以继续进行服务器端集成。这是同步读者的使用权。当您 实现并使用所需的服务器端 UpdateReaderEntitlements 函数， 可确保系统针对合适的受众 位订阅者。