문제 해결

이 문서의 정보는 구독 연결을 구현하는 동안 발생할 수 있는 문제를 해결하는 데 도움이 됩니다.

팁: JavaScript 콘솔을 열고 swg.js 클라이언트 라이브러리의 오류 메시지를 찾습니다. 이를 통해 구현의 잠재적 문제를 식별할 수 있습니다.

구독 연결 CTA가 로드 화면에서 멈춤

오류 예:

그림 1. 구독 연결 CTA가 로드되지 않습니다.

이 문제를 해결하려면 다음을 확인하세요.

• 테스트 하위 도메인을 포함한 페이지의 출처를 게시자 센터의 간행물 설정에 추가 URL로 추가해야 합니다.
  • URL 상태가 '확인'이 아닌 '확인됨'인지 확인합니다.
• Extended Access 또는 Reader Revenue Manager Enterprise 구현의 경우 테스트 하위 도메인을 포함한 페이지의 원본을 이러한 구현에 대해 구성한 OAuth 2.0 클라이언트의 승인된 JavaScript 원본에 추가해야 합니다. 이 작업은 Google Cloud 콘솔에서 수행해야 합니다.

참고: 최근에 출처를 추가한 경우 이러한 출처가 swg.js 클라이언트 라이브러리에 액세스할 수 있게 되기까지 최대 1시간이 걸릴 수 있습니다.

계정을 연결할 수 없음

오류 예:

그림 2. 계정을 연결할 수 없는 문제

이 문제를 해결하려면 다음을 확인하세요.

• 게시자 센터에서 구독 연결 서비스 약관에 동의해야 합니다. 이렇게 하려면 구독 연결 설정으로 이동하여 구독 연결 서비스 약관 서명을 클릭합니다.
• Google 계정이 이미 연결되어 있는 경우 구독을 다시 연결하려고 하면 오류 메시지가 표시됩니다. 클라이언트 측 통합 테스트를 반복하기 전에 Google 계정의 구독 페이지를 통해 구독을 연결 해제해야 합니다.

정기 결제 연결 API 호출 시 권한 오류

오류 예:

코드	403
메시지	'readerrevenuesubscriptionlinking.readerEntitlements.update' 리소스 '//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements'에 대한 권한이 거부되었습니다 (또는 존재하지 않는 리소스일 수도 있음).'

이 문제를 해결하려면 다음을 확인하세요.

• 구독 연결 설정에 지정된 것과 동일한 프로젝트를 사용해야 합니다. 게시자 센터에서 구독 연결을 설정할 때는 프로젝트 번호를 사용하세요. 프로젝트 대시보드에서 프로젝트 번호를 찾을 수 있습니다.
• 프로젝트에 Subscription Linking API가 사용 설정되어 있는지 확인합니다.
• 프로젝트 Identity and Access Management (IAM)에서 서비스 계정에 구독 연결 관리자 역할이 부여되어 있는지 확인합니다. 시스템을 통해 역할 변경사항이 전파되는 데 시간이 걸릴 수 있습니다. 서비스 계정에 올바른 IAM 역할이 있는지 확인한 후에도 API 호출 시 403 오류가 발생하면 잠시 기다린 후 요청을 다시 시도하세요.

• 사용할 서비스 계정이나 필요한 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)를 통해 액세스 토큰을 획득한 경우 정기 결제 연결 API를 호출할 때 토큰이 유효하고 만료되지 않았는지 확인하세요. 토큰이 만료되면 새 토큰을 획득해야 합니다.

• REST API를 사용하는 경우 구독 연결 설정에서 제공한 게시 ID를 사용해야 합니다. 예를 들어 게시자 ID가 example.com이면 요청 URL에 게시자 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"

검색 결과에 강조 표시된 도움말이 표시되지 않음

이 문제를 해결하려면 다음을 확인하세요.

• 모든 기사에 구조화된 데이터를 추가해야 합니다. 리치 결과 테스트를 사용하여 구조화된 데이터를 검사합니다.
• 독자의 권한을 업데이트하는 데 사용하는 제품 ID 집합에 해당하는 구조화된 데이터에 유효한 productID를 입력해야 합니다.
• Search Console에서 '구독 콘텐츠'의 리치 결과 보고서를 사용하여 구조화된 데이터와 관련된 문제를 확인하세요.

참고: 구독 중인 콘텐츠 기능이 표시될 때는 순위 지정 요소가 적용됩니다. 즉, 특정 검색어에 대한 뉴스 기사가 항상 표시되는 것은 아닙니다.

구독 연결 클릭 유도 문구 메시지 언어를 변경할 수 없음

구독 연결 클릭 유도 문구 언어는 사용자의 설정에 따라 결정됩니다. 전역적으로 재정의할 수 없습니다.

언어는 다음과 같이 결정됩니다.

1. 사용자가 Google 계정으로 로그인한 경우 Google 계정 설정 (https://myaccount.google.com/language)에 설정된 기본 언어가 사용됩니다.

2. 사용자가 로그인하지 않은 경우 언어는 브라우저 또는 운영체제의 기본 언어 설정을 기반으로 합니다.

구독 연결 클릭 유도문안은 일부 언어만 지원합니다. 사용자의 기본 언어가 지원되지 않는 경우 클릭 유도 문구가 기본적으로 영어로 표시될 수 있습니다.