疑難排解

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

提示： 開啟 JavaScript 控制台，找出 swg.js 用戶端程式庫的錯誤訊息。這有助於找出實作時的潛在問題。

訂閱連結行動號召停留在載入畫面

錯誤示例：

圖 1. 訂閱連結 CTA 無法載入。

如要解決這個問題，請檢查下列事項：

• 請務必在新聞發布者中心的出版品設定中，將網頁來源 (包括測試子網域) 新增為額外網址。
  • 確認網址狀態為「已驗證」，而非「驗證」。
• 如果是導入 Extended Access 或 Reader Revenue Manager Enterprise，請務必將網頁來源 (包括測試子網域) 新增至為這類導入項目設定的 OAuth 2.0 用戶端已授權 JavaScript 來源。這項操作必須在 Google Cloud 控制台中進行。

注意： 如果您最近新增來源，這些來源最多可能要過一小時，才能存取 swg.js 用戶端程式庫。

無法連結帳戶

錯誤示例：

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

如要解決這個問題，請檢查下列事項：

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

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

錯誤示例：

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

如要解決這個問題，請檢查下列事項：

• 請務必使用與「訂閱連結設定」中指定的專案相同的專案。在新聞發布者中心設定訂閱連結時，請使用專案編號。您可以在專案資訊主頁中找到專案編號。
• 確認專案已啟用 Subscription Linking API。
• 在專案的身分與存取權管理 (IAM) 中，確認服務帳戶已獲授予「訂閱項目連結管理員」角色。請注意，系統可能需要一段時間，才能將角色變更傳播到整個系統。如果您在發出 API 呼叫時收到 403 錯誤，即使已確認服務帳戶具備正確的 IAM 角色，請稍候片刻再重新發出要求。

• 如果不確定要使用哪些服務帳戶，或這些帳戶是否具備必要的 IAM 角色，請使用為訂閱項目連結設定的專案中的政策分析器。使用下列查詢參數建立及執行自訂查詢：

  參數 1	角色
  角色	訂閱連結管理員

• 呼叫 Subscription Linking API 時，請務必使用正確的服務帳戶金鑰。檢查服務帳戶金鑰 (JSON 檔案) 中的下列屬性：

  • 類型：必須為 service_account。
  • project_id：必須是訂閱項目連結設定中指定的專案編號的專案 ID。
    注意： 專案 ID 和專案編號是兩個不同的 ID，可在專案資訊主頁中找到。
  • client_email：必須與專案 IAM 中指派「訂閱項目連結管理員」角色的服務帳戶相同。

• 如果您是透過 Google OAuth 2.0 權杖端點 (https://oauth2.googleapis.com/token) 取得存取權杖，請務必在呼叫 Subscription Linking 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"

搜尋結果中未顯示精選文章

如要解決這個問題，請檢查下列事項：

• 請務必在所有文章中加入結構化資料。使用複合式搜尋結果測試驗證結構化資料。
• 請確認你在結構化資料中放入有效的 productID，對應一組用來更新讀者權利的產品 ID。
• 使用 Search Console 的「已訂閱內容」複合式搜尋結果報告，查看與結構化資料相關的問題。

注意： 系統顯示「訂閱內容」功能時，會考量排名因素。也就是說，即使搜尋特定字詞，也不保證一定會看到你的新聞報導。

無法變更訂閱連結行動號召訊息的語言

系統會根據使用者的設定，決定「訂閱連結」行動號召的語言。無法全域覆寫。

系統會依下列方式判斷語言：

1. 如果使用者已登入 Google 帳戶，系統會使用 Google 帳戶設定 (https://myaccount.google.com/language) 中設定的主要語言。

2. 如果使用者未登入，系統會根據瀏覽器或作業系統的主要語言設定來判斷語言。

訂閱連結行動號召不支援所有語言。 如果系統不支援使用者的主要語言，行動號召可能會預設為英文。