Merchant API를 효과적으로 사용하려면 등록, 인증, 승인 개념을 이해하는 것이 중요합니다. 이러한 키는 판매자 센터 데이터에 대한 안전하고 올바른 액세스를 보장하는 데 서로 다른 목적으로 사용됩니다.
용어
등록, 인증, 승인은 서로 관련이 있지만 각각 고유한 의미와 목적이 있습니다.
- 인증: 이 프로세스에서 서비스는 API 요청을 하는 사용자 또는 애플리케이션의 ID를 확인합니다. Merchant API는 OAuth 2.0과 같은 표준 Google 메커니즘을 사용합니다. 자세한 내용은 요청 인증 및 내 계정으로 인증을 참고하세요.
- 승인: 이 프로세스는 인증된 사용자 또는 애플리케이션이 판매자 센터 계정을 사용하여 수행할 수 있는 작업을 결정합니다. 판매자 센터 계정 내에서 인증된 사용자에게 부여된 역할과 권한을 기반으로 '무엇을 할 수 있나요?'라는 질문에 답변합니다. 예를 들어 사용자가 제품 데이터를 읽을 권한은 있지만 계정 설정을 수정할 권한은 없을 수 있습니다.
- 등록: Merchant API와 관련하여 Google에서 관리하는 판매자 계정에 관한 중요한 서비스 공지를 보낼 수 있도록 하는 일회성 설정 프로세스입니다. 등록하면 개발자 이메일 주소가 기본 판매자 센터 계정에 추가되고 인증에 사용하는 Google Cloud 프로젝트 ID에 연결됩니다. 이 연결을 통해 애플리케이션은 관리하는 모든 판매자 계정에 대한 서비스 공지를 수신할 수 있습니다. 자세한 내용은 Google Cloud 프로젝트 만들기를 참고하세요.
등록
등록 절차는 애플리케이션이 Merchant API를 사용할 수 있도록 하는 데 중요합니다. 다음 사항에 유의하시기 바랍니다.
기본 요건
Merchant API를 사용하려면 다음이 필요합니다.
- 판매자 센터 계정: 기존 판매자 센터 계정이 필요합니다.
- 관리자 액세스: 등록 호출을 시작하는 데 사용하는 Google 사용자 계정에 등록하려는 판매자 센터 계정에 대한 관리자 권한이 있어야 합니다.
- Google Cloud 프로젝트: 애플리케이션이 Google Cloud 프로젝트와 연결되어 있어야 합니다. 이 프로젝트는 애플리케이션이 인증하는 데 필요한 사용자 인증 정보 (예: OAuth 2.0 클라이언트 ID)를 제공합니다.
공유 Google Cloud 프로젝트를 등록할 수 없는 이유
Google OAuth Playground 및 API 탐색기와 같은 도구는 공유된 Google 소유 Google Cloud 프로젝트를 사용합니다. 다음과 같은 이유로 공유 프로젝트에 등록할 수 없습니다.
- 테스트 및 탐색용이며 프로덕션 애플리케이션 ID용이 아닙니다.
- 등록하면 공유 도구와 특정 판매자 센터 데이터 간에 연결이 설정되어 원치 않는 커뮤니케이션이 발생할 수 있습니다.
Google에서 전송하는 Merchant API 통신이 실제 사용량과 관련이 있도록 애플리케이션에 전용 Google Cloud 프로젝트가 필요합니다.
하지만 OAuth Playground 및 API 탐색기 웹 앱을 사용하여 실험 및 비프로덕션 사용 사례에 Merchant API를 사용할 수 있습니다.
Google Cloud 프로젝트 ID 찾기
프로젝트 ID와 프로젝트 번호는 Google Cloud 콘솔에서 확인할 수 있습니다. 자세한 내용은 프로젝트 이름, 번호, ID 찾기를 참고하세요.
등록 호출
Accounts 하위 API 내에서 registerGcp 메서드를 사용하여 등록합니다. 이 호출은 Google Cloud 프로젝트 번호를 판매자 센터 계정과 연결합니다.
이 과정에서 API를 호출하는 데 사용하는 개별 사용자와 연결된 이메일 주소를 제공해야 합니다. 이 이메일은 판매자 센터 계정에 대한 관리 액세스 권한이 있는 사용자의 이메일이어야 합니다.
이메일 필드 정보
효과적인 커뮤니케이션이 중요합니다. Google에서는 중요한 업데이트, 필수 서비스 공지 (MSA), 개발자 설문조사, 판매자 API와 관련된 기타 기회를 전송합니다. 적절한 연락처 관리를 통해 이러한 정보가 적절한 사용자에게 전달됩니다.
- 목적: Google은 이 이메일 주소를 API 관련 커뮤니케이션의 기본 연락처로 사용합니다.
- 이메일 주소: API 통합을 담당하는 개인 개발자 또는 주요 기술 담당자의 이메일 주소여야 합니다.
- 권장사항:
- 권장: 개인의 회사 이메일 주소를 사용합니다.
- 사용하면 안 됨: 일반 그룹 별칭 또는 서비스 계정 이메일을 사용합니다. Google은 사람 수신자를 대상으로 커뮤니케이션을 제공합니다.
연락처 관리를 위한 users 리소스
등록 호출의 이메일 주소는 초기 연락처를 설정하지만 연락처와 권한을 관리하는 더 강력한 방법은 Merchant API accounts.users 리소스 또는 판매자 센터 UI의 사용자 관리 설정을 사용하는 것입니다. 판매자 센터 사용에 관한 자세한 내용은 계정의 사용자 관리를 참고하세요.
다음과 같이 이러한 기능을 활용하세요.
- 모든 개발자 추가: API 통합을 담당하는 개발자를 판매자 센터 계정의 사용자로 추가합니다.
API_DEVELOPER역할 할당: 표준 역할 (관리자, 표준) 외에도 사용자에게API_DEVELOPER역할을 할당할 수 있습니다. 특히 API 관련 커뮤니케이션을 수신해야 하는 사용자에게 이 역할을 할당합니다. 다른 역할과 결합할 수 있습니다.- 혜택:
- 명확한 분리: API 연락처 관리를 일회성 등록에서 분리합니다.
- 유연성: 팀 구성원이 변경되면 연락처를 업데이트합니다.
- 타겟팅된 커뮤니케이션: API 관련 소식이 관련 사용자에게 전달됩니다.
등록 중에 이메일 주소를 제공한 경우에도 API_DEVELOPER 역할이 있는 사용자를 추가하여 API 연락처를 관리하는 것이 좋습니다.
참조
자세한 내용은 다음을 참조하세요.