本文档中的信息可帮助您排查实现订阅关联时可能遇到的问题。
订阅关联提示卡卡在加载屏幕上
错误示例：
图 1. 订阅关联提示无法加载。
如需解决此问题，请检查以下各项：
- 请务必在发布商中心的发布内容设置中，将网页的来源（包括测试子网域）添加为其他网址。
- 对于“扩展访问权限”或 Reader Revenue Manager Enterprise 实现，请务必将网页的来源（包括测试子网域）添加到您为此类实现配置的 OAuth 2.0 客户端的已获授权的 JavaScript 来源。此操作需要在 Google Cloud 控制台中完成。
无法关联账号
错误示例：
图 2. 账号无法关联问题。
如需解决此问题，请检查以下各项：
- 请务必在发布商中心内接受订阅关联服务条款。为此，请前往订阅关联设置，然后点击签署订阅关联服务条款。
- 如果 Google 账号已关联，您在重新尝试关联订阅时会收到错误消息。您必须先通过 Google 账号中的“订阅”页面解除订阅关联，然后才能重复客户端集成测试。
调用 Subscription Linking API 时出现权限错误
错误示例：
| 代码 | 403
|
| 消息 | 'readerrevenuesubscriptionlinking.readerEntitlements.update'
对资源 'readerrevenuesubscriptionlinking.readerEntitlements.update' 权限遭拒（或者该资源可能不存在）。"
|
如需解决此问题，请检查以下各项：
- 请确保您使用的项目与订阅关联设置中指定的项目相同。在发布商中心设置订阅关联时，请使用项目编号。您可以在项目信息中心中找到项目编号。
- 确保已在项目中启用 Subscription Linking API。
- 在项目 Identity and Access Management (IAM) 中，确保为服务账号授予“订阅关联管理员”角色。请注意，角色更改可能需要一些时间才能在系统中传播。如果您在发出 API 调用时收到 403 错误，即使您确认服务账号具有正确的 IAM 角色，也请等待几分钟，然后再次尝试发出请求。
如果您不确定要使用哪些服务账号，或者它们是否具有必要的 IAM 角色，请使用您为订阅关联设置的项目中的政策分析器。使用以下查询参数创建并运行自定义查询：
参数 1 角色 角色 Subscription Linking Admin 调用 Subscription Linking API 时，请确保使用正确的服务账号密钥。检查服务账号密钥 (JSON 文件) 中的以下属性：
- type：必须为 service_account。
- project_id：必须是订阅关联设置中指定的项目编号的项目 ID。
- client_email：必须是项目 IAM 中分配了 Subscription Linking Admin 角色的服务账号。
如果您通过 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
- ✅ 仅使用已配置的发布内容 ID：
更新使用权时出错：参数无效
错误示例：
| 消息 | 错误：请求包含无效的参数 |
如需解决此问题，请检查以下各项：
- 请确保以正确的格式提供
entitlements对象。请参阅此示例。 - 确保
product_id采用publication_id:product格式。- ✅ 有效示例：
"product_id":"example.com:basic" - ❌ 无效示例：
"product_id":"example.com"
- ✅ 有效示例：
搜索结果中未突出显示文章
如需解决此问题，请检查以下各项：
- 请务必为您的所有文章添加结构化数据。使用富媒体搜索结果测试工具验证结构化数据。
- 请确保在结构化数据中添加有效的
productID，该productID应与您用于更新读者的使用权的一组商品 ID 相对应。 - 在 Search Console 中使用“订阅内容”的富媒体搜索结果报告，查看与结构化数据相关的任何问题。
无法更改“订阅关联”号召性用语消息的语言
订阅关联的号召性用语语言取决于用户的设置。无法全局替换。
语言的确定方式如下：
如果用户使用 Google 账号登录，系统会使用其 Google 账号设置 (https://myaccount.google.com/language) 中设置的主要语言。
如果用户未登录，则语言取决于其浏览器或操作系统的主要语言设置。
订阅关联号召性用语不支持所有语言。 如果不支持用户的主要语言，则号召性用语可能会默认使用英语。