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