疑難排解

本文中的資訊有助於排解您在實作訂閱連結時可能遇到的問題。

訂閱連結提示停滯在載入畫面中

錯誤範例:

正在載入符號

圖 1 無法載入訂閱連結提示。

如要解決這個問題,請檢查下列事項:

  • 請務必在新聞發布者中心的出版品設定中,將網頁來源 (包括測試子網域) 新增為其他網址
  • 對於 Extended Access 或 Reader Revenue Manager Enterprise 實作作業,請確認您已將網頁來源 (包括測試子網域) 加進您為這類實作設定的 OAuth 2.0 用戶端的已授權 JavaScript 來源。您必須在 Google Cloud 控制台中完成這項操作。

無法連結帳戶

錯誤範例:

無法連結帳戶

圖 2. 無法連結帳戶的問題。

如要解決這個問題,請檢查下列事項:

  • 請務必前往新聞發布者中心接受《訂閱連結服務條款》。如要這麼做,請前往「訂閱連結」設定,然後按一下「簽署訂閱連結服務條款」
  • 如果已連結 Google 帳戶,您會在嘗試連結訂閱項目時收到錯誤訊息。您必須先透過 Google 帳戶的訂閱頁面取消連結訂閱項目,才能重複進行用戶端整合測試。

呼叫 Subscription Links API 時發生權限錯誤

錯誤範例:

程式碼 403
訊息 資源
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements'
'readerrevenuesubscriptionlinking.readerEntitlements.update' 遭拒 (或不存在)。」

如要解決這個問題,請檢查下列事項:

  • 請確認您使用的 GCP 專案與訂閱連結設定中指定的相同。
  • 請確認 GCP 專案已啟用 Subscription Links API
  • 在 GCP IAM 中,確認服務帳戶具備訂閱連結管理員角色。
  • 如果您使用 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"

未顯示在搜尋結果中醒目顯示的文章

如要解決這個問題,請檢查下列事項: