问题排查

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

在加载屏幕上卡住订阅关联提示

错误示例:

正在加载符号

图 1. 无法加载订阅关联提示。

如需解决此问题,请检查以下各项:

  • 请务必在发布商中心的发布内容设置中,将网页的来源(包括测试子网域)添加为其他网址
  • 对于扩展访问权限或读者收益管理工具企业版实现,请务必将页面的来源(包括测试子网域)添加到您为此类实现配置的 OAuth 2.0 客户端的已获授权的 JavaScript 来源中。此操作需要在 Google Cloud 控制台中完成。

无法关联账号

错误示例:

无法关联账号

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

如需解决此问题,请检查以下各项:

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

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

错误示例:

代码 403
消息 拒绝了对资源
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements'
'readerrevenuesubscriptionlinking.readerEntitlements.update' 请求(或者该资源可能不存在)。”

如需解决此问题,请检查以下各项:

  • 请务必使用订阅关联设置中指定的同一 GCP 项目。
  • 确保您的 GCP 项目中已启用 Subscription Linking API
  • 在 GCP IAM 中,确保服务帐号具有 Subscription Linking Admin 角色。
  • 如果您使用 REST API,请务必使用您在订阅关联配置中提供的发布内容 ID。例如,如果您的发布内容 ID 为 example.com,则请求网址必须包含该 ID。
    • ✅ 仅使用已配置的发布内容 ID: publications/example.com/readers/10078823/entitlements
    • ❌ 请勿使用订阅关联配置中指定的出版物 ID:publications/example-staging.com/readers/10078823/entitlements
    • ❌ 请勿在要求中添加出版物商品: publications/example.com:premium/readers/10078823/entitlements

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

错误示例:

消息 错误:请求包含无效参数

如需解决此问题,请检查以下各项:

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

未看到搜索结果中突出显示的报道

如需解决此问题,请检查以下各项: