데이터 보안을 보장하고, 액세스 제어를 적용하고, 시스템 무결성을 유지하려면 모든 Merchant API 요청을 인증해야 합니다. API는 인증된 ID를 사용하여 호출자가 수행할 수 있는 작업 권한을 결정합니다. 예를 들어 일부 호출자는 제품 데이터에 대한 읽기 전용 액세스 권한을 갖는 반면 다른 호출자는 판매자 센터에서 계정 설정을 수정할 수 있습니다.
이 문서는 Merchant API 시작하기에 관한 여러 편으로 구성된 시리즈의 일부입니다. Merchant API로 인증을 이미 설정한 경우 다음 섹션인 개발자로 등록 으로 건너뛸 수 있습니다.
Merchant API에 대한 요청 승인
Merchant API로 전송되는 모든 요청에는 Google에 애플리케이션을 식별하는 인증 토큰이 포함되어야 합니다. 인증 및 승인을 설정하려면 Merchant 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 액세스 권한을 부여합니다. 다음 단계에 따라 Merchant API용 서비스 계정 승인을 설정하세요.
- Google Cloud 콘솔의 API 및 서비스에서 서비스 계정 사용자 인증 정보 만들기
- 비공개 키 다운로드: 서비스 계정의 비공개 키를 JSON
형식으로 만들고 다운로드합니다. 파일 이름을
service-account.json으로 바꿉니다. - 판매자 센터에 서비스 계정 추가: 고유한 서비스
계정 이메일 주소를 복사하여
sa@project.iam.gserviceaccount.com판매자 센터에 새 사용자로 추가합니다. 자세한 내용은 판매자 센터에서 사용자 추가 또는 삭제 방법을 참고하세요. Admin액세스 권한을 할당합니다. 액세스 수준에 대한 자세한 내용은 판매자 센터에서 사용자 및 액세스 수준 관리를 참고하세요.- 코드 샘플로 인증 설정: 공식 코드 샘플 인증 설정 및 샘플 구성 문서 섹션의 안내를 따릅니다.
서비스 계정 승인에 대한 자세한 내용은 판매자 센터 계정에 대한 액세스 승인 및 서비스 계정 개요를 참고하세요.