问题排查

本文档中的信息可帮助您排查在实现订阅关联时可能遇到的问题。

提示： 打开 JavaScript 控制台，查找来自 swg.js 客户端库的错误消息。这有助于您发现实现中的潜在问题。

订阅关联 CTA 卡在加载界面

错误示例：

图 1. 订阅关联 CTA 不会加载。

如需解决此问题，请检查以下各项：

• 请务必在发布商中心的出版物设置中，将网页来源（包括测试子网域）添加为其他网址。
  • 确保网址的状态为“已验证”，而不是“验证”。
• 对于扩展访问权限或 Reader Revenue Manager Enterprise 实现，请务必将网页的来源（包括测试子网域）添加到您为此类实现配置的 OAuth 2.0 客户端的已获授权的 JavaScript 来源中。此操作需要在 Google Cloud 控制台中完成。

注意： 如果您最近添加了来源，那么这些来源最长可能需要 1 小时才能访问 swg.js 客户端库。

无法关联账号

错误示例：

图 2. 账号无法关联问题。

如需解决此问题，请检查以下各项：

• 请务必在发布商中心内接受订阅关联服务条款。为此，请前往订阅关联设置，然后点击签署订阅关联服务条款。
• 如果 Google 账号已关联，您在重新尝试关联订阅时会收到错误消息。您必须先通过 Google 账号中的订阅页面解除订阅关联，然后才能重复进行客户端集成测试。

调用 Subscription Linking API 时出现权限错误

错误示例：

代码	403
消息	'readerrevenuesubscriptionlinking.readerEntitlements.update' 对资源 '//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' 的权限遭拒（或者该资源可能不存在）。"

如需解决此问题，请检查以下各项：

• 确保您使用的项目与订阅关联设置中指定的项目相同。 在发布商中心内设置订阅关联时，请使用项目编号。您可以在项目信息中心内找到项目编号。
• 确保已在项目中启用订阅关联 API。
• 在项目 Identity and Access Management (IAM) 中，确保服务账号被授予 Subscription Linking Admin 角色。请注意，角色更改在系统中的传播可能需要一段时间。如果您在发出 API 调用时收到 403 错误，即使您已确认服务账号拥有正确的 IAM 角色，也请等待片刻，然后再次尝试发出请求。

• 如果您不确定要使用哪些服务账号，或者不确定这些服务账号是否具有必要的 IAM 角色，请使用您为订阅关联设置的项目中的政策分析器。创建并运行自定义查询，并使用以下查询参数：

  参数 1	角色
  角色	Subscription Linking Admin

• 请确保在调用 Subscription Linking API 时使用正确的服务账号密钥。检查服务账号密钥（JSON 文件）中的以下属性：

  • type：必须为 service_account。
  • project_id：必须是订阅关联设置中指定的项目编号的项目 ID。
    注意： 项目 ID 和项目编号 是两种不同的标识符，您可以在项目信息中心中找到它们。
  • client_email：必须是项目 IAM 中分配有订阅关联管理员角色的同一服务账号。

• 如果您是通过 Google OAuth 2.0 令牌端点 (https://oauth2.googleapis.com/token) 获取的访问令牌，请确保在调用订阅关联 API 时，该令牌有效且未过期。如果令牌过期，您必须获取新令牌。

• 如果您使用 REST API，请确保使用您在订阅关联设置中提供的发布 ID。例如，如果您的发布商 ID 为 example.com，则请求网址必须包含该 ID。

  • ✅ 仅使用已配置的发布 ID： publications/example.com/readers/10078823/entitlements
  • ❌ 请勿使用订阅关联配置中指定的发布 ID 以外的发布 ID： publications/example-staging.com/readers/10078823/entitlements
  • ❌ 请勿在请求中添加发布商品： publications/example.com:premium/readers/10078823/entitlements

注意： IAM 中的权限更改可能需要几分钟或更长时间才能生效。如需了解详情，请参阅访问权限更改传播。

更新授权时出现参数无效错误

错误示例：

消息	错误：请求包含无效的实参

如需解决此问题，请检查以下各项：

• 请确保您提供的 entitlements 对象格式正确。 请参阅此示例。
• 确保 product_id 的格式为 publication_id:product。
  • ✅ 有效示例："product_id":"example.com:basic"
  • ❌ 无效示例："product_id":"example.com"

未看到搜索结果中突出显示的文章

如需解决此问题，请检查以下各项：

• 请务必为所有文章添加结构化数据。使用富媒体搜索结果测试工具验证结构化数据。
• 确保在与您用于更新读者的授权的一组商品 ID 对应的结构化数据中放置有效的 productID。
• 在 Search Console 中使用“订阅内容”的富媒体搜索结果报告，查看与结构化数据相关的任何问题。

注意： 在显示订阅内容功能时，我们会考虑排名因素。这意味着，我们无法保证您一定能看到自己撰写的新闻报道。

无法更改订阅关联号召性用语的语言

“订阅关联”号召性用语的语言由用户设置决定。无法全局替换。

语言的确定方式如下：

1. 如果用户已登录 Google 账号，系统会使用其 Google 账号设置 (https://myaccount.google.com/language) 中设置的主要语言。

2. 如果用户未登录，则语言取决于其浏览器或操作系统的主语言设置。

订阅关联号召性用语不支持所有语言。 如果不支持用户的主要语言，则行动号召可能会默认为英语。