疑難排解

這份文件中的資訊可協助您排解在實作訂閱連結時可能遇到的問題。

提示： 開啟 JavaScript 控制台，然後找出 swg.js 用戶端程式庫的錯誤訊息。這有助於您找出導入過程中的潛在問題。

訂閱連結提示卡在載入畫面上

錯誤示例：

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

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

• 請務必在新聞發布者中心的出版品設定中，將網頁的來源 (包括測試子網域) 新增為額外網址。
• 針對 Extended Access 或 Reader Revenue Manager Enterprise 導入作業，請務必將網頁的來源 (包括測試子網域) 新增至您為這類導入作業設定的 OAuth 2.0 用戶端的已授權 JavaScript 來源。這項操作必須在 Google Cloud 控制台中執行。

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

無法連結帳戶

錯誤示例：

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

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

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

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

錯誤示例：

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

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

• 請確認您使用的專案與訂閱連結設定中指定的專案相同。在新聞發布者中心設定訂閱連結時，請使用專案編號。您可以在專案資訊主頁中找到專案編號。
• 確認專案已啟用 Subscription Linking API。
• 在專案的 Identity and Access Management (IAM) 中，請確認服務帳戶已授予「訂閱連結管理員」角色。請注意，透過系統進行的角色變更傳播作業可能需要一些時間。如果在發出 API 呼叫時收到 403 錯誤，即使您已確認服務帳戶具有正確的 IAM 角色，也請稍候片刻，然後再試一次。

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

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

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

  • type：必須為 service_account。
  • project_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. 如果使用者未登入，系統會根據瀏覽器或作業系統的主要語言設定，選擇語言。

訂閱連結的動作代碼不支援所有語言。如果系統不支援使用者的主要語言，則操作提示可能會預設為英文。