トラブルシューティング

このドキュメントでは、Subscription Linking を実装する際に発生する可能性のある問題のトラブルシューティングに役立つ情報を提供します。

読み込み中の画面で Subscription Linking のメッセージが表示されたまま先に進まない

エラーの例:

読み込み中を示すシンボル

図 1. Subscription Linking のメッセージが読み込まれない。

この問題を解決するには、以下の点を確認してください。

パブリッシャーセンターのパブリケーションの設定で、ページの生成元（テストサブドメインを含む）を追加の URL として追加するようにしてください。
拡張アクセスの実装や Reader Revenue Manager Enterprise の実装の場合は、その実装用に構成した OAuth 2.0 クライアントの承認済みの JavaScript 生成元にページの生成元（テストサブドメインを含む）を追加するようにしてください。この設定は Google Cloud コンソールで行う必要があります。

エラーの例:

アカウントをリンクできませんでした

図 2. 「アカウントをリンクできませんでした」という問題。

この問題を解決するには、以下の点を確認してください。

パブリッシャーセンターで Subscription Linking の利用規約に同意する必要があります。そのためには、Subscription Linking の設定にアクセスし、[Subscription Linking の利用規約に同意する] をクリックします。
Google アカウントがすでにリンクされている場合、定期購読を再度リンクしようとすると、エラーメッセージが表示されます。Google アカウントの定期購読ページで定期購読のリンクを解除してから、クライアント側の統合テストを繰り返し行う必要があります。

エラーの例:

コード	`403`
メッセージ	`'readerrevenuesubscriptionlinking.readerEntitlements.update'` がリソース `'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements'` で拒否されました（または存在しません）

この問題を解決するには、以下の点を確認してください。

Subscription Linking の設定で指定したものと同じ GCP プロジェクトを使用する必要があります。
GCP プロジェクトで Subscription Linking API を有効にする必要があります。
GCP IAM で、サービスアカウントに「Subscription Linking 管理者」ロールがあることが必要です。
REST API を使用する場合は、Subscription Linking の設定で指定したパブリケーション ID を使用する必要があります。たとえば、パブリケーション ID が example.com の場合、これがリクエスト URL に含まれていなければなりません。
- ✅ 構成済みのパブリケーション ID のみを使用する必要があります: publications/example.com/readers/10078823/entitlements
- ❌ Subscription Linking の設定で指定されたもの以外のパブリケーション 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"

この問題を解決するには、以下の点を確認してください。