데이터 보안을 보장하고, 액세스 제어를 시행하고, 시스템 무결성을 유지하려면 모든 Merchant API 요청을 인증해야 합니다. API는 인증된 ID를 사용하여 호출자가 실행할 수 있는 작업을 결정합니다. 예를 들어 일부 호출자는 제품 데이터에 대한 읽기 전용 액세스 권한을 갖는 반면 다른 호출자는 판매자 센터에서 계정 설정을 수정할 수 있습니다.
이 문서는 Merchant API 시작에 관한 여러 파트로 구성된 시리즈의 일부입니다. Merchant API로 인증을 이미 설정한 경우 다음 섹션으로 건너뛰세요. 개발자로 등록
Merchant API에 대한 요청 승인
Merchant API로 전송되는 모든 요청에는 Google에 애플리케이션을 식별하는 승인 토큰이 포함되어야 합니다. 인증 및 승인을 설정하려면 판매자 API를 사용할 방법을 가장 잘 설명하는 사용 사례를 결정하세요.
다른 비즈니스에서 사용할 애플리케이션을 빌드하고 있나요?
예인 경우 OAuth 2.0 승인을 사용합니다. 다음과 같은 경우 OAuth 2.0 승인을 선택하세요.
- 서드 파티 제공업체 또는 대행사: 다른 비즈니스에서 자체 판매자 센터 데이터를 관리하는 데 사용할 SaaS 플랫폼과 같은 애플리케이션을 빌드합니다.
- 여러 외부 계정을 관리해야 함: 여러 클라이언트가 소유한 독립적인 판매자 센터 계정에서 작동하는 단일 애플리케이션이 필요합니다. 클라이언트는 자신의 Google 계정에 로그인하고 동의 화면에서 '허용'을 클릭하여 권한을 부여합니다.
자체 비즈니스를 위한 앱을 빌드하고 있나요?
예인 경우 서비스 계정 승인을 사용하여 Merchant API 액세스 권한을 얻습니다. 다음과 같은 경우 서비스 계정 승인을 선택하세요.
- 자체 내부 애플리케이션을 빌드하는 경우: 자체 비즈니스를 위해 판매자 센터 데이터를 관리하는 도구를 개발하거나 특정 개인 사용자가 아닌 애플리케이션 자체에 속하는 사용자 인증 정보를 원하는 경우입니다.
- 사람의 로그인 없이 자동화가 필요함: 애플리케이션이 자동 인벤토리 업데이트 또는 'cron' 작업과 같은 백그라운드 작업을 실행합니다.
OAuth 2.0 승인
여러 클라이언트 계정을 관리하는 서드 파티 제공업체 또는 대행사인 경우 애플리케이션에서 OAuth 2.0을 사용하여 요청을 승인해야 합니다. 다음 단계에 따라 Merchant API용 OAuth 2.0을 설정하세요.
- Google Cloud 콘솔의 API 및 서비스에서 OAuth 2.0 사용자 인증 정보 만들기
- OAuth2 클라이언트 사용자 인증 정보를
client-secrets.json와 같은 파일에 다운로드합니다. - 이메일 계정을 판매자 센터에 사용자로 추가: 요청을 승인하는 데 사용하는 Google 계정이 판매자 센터에 사용자로 있는지 확인합니다. 자세한 내용은 판매자 센터에서 사용자를 추가하거나 삭제하는 방법을 참고하세요.
- 등록을 실행할 수 있도록
Admin역할을 할당합니다. 역할에 대한 자세한 내용은 판매자 센터에서 사용자 및 액세스 수준 관리를 참고하세요. - 코드 샘플로 인증 설정: 공식 코드 샘플 인증 및 샘플 구성 설정 문서 섹션의 안내를 따릅니다.
OAuth 2.0 승인에 대한 자세한 내용은 서드 파티 앱의 판매자 센터 계정 액세스 승인 및 OAuth 2.0을 사용하여 Google API에 액세스하기를 참고하세요.
서비스 계정 승인
서비스 계정을 사용하여 자체 판매자 센터 계정에 대한 Merchant API 액세스를 승인합니다. 판매자 API의 서비스 계정 승인을 설정하려면 다음 단계를 따르세요.
- Google Cloud 콘솔의 API 및 서비스에서 서비스 계정 사용자 인증 정보를 만듭니다.
- 비공개 키 다운로드: 서비스 계정의 JSON 형식 비공개 키를 만들고 다운로드합니다. 파일 이름을
service-account.json로 바꿉니다. - 판매자 센터에 서비스 계정 추가:
sa@project.iam.gserviceaccount.com와 같은 고유한 서비스 계정 이메일 주소를 복사하여 판매자 센터에 새 사용자로 추가합니다. 자세한 내용은 판매자 센터에서 사용자를 추가하거나 삭제하는 방법을 참고하세요. Admin액세스 권한을 할당합니다. 액세스 수준에 대한 자세한 내용은 판매자 센터에서 사용자 및 액세스 수준 관리하기를 참고하세요.- 코드 샘플로 인증 설정: 공식 코드 샘플 인증 및 샘플 구성 설정 문서 섹션의 안내를 따릅니다.
서비스 계정 승인에 대한 자세한 내용은 판매자 센터 계정 액세스 권한 부여 및 서비스 계정 개요를 참고하세요.