Merchant API를 사용하려면 판매자 센터 계정이 있어야 합니다. 판매자 센터 UI를 사용하여 만들 수 있습니다.
여러 계정을 관리해야 하는 경우 Merchant API를 사용하여 하위 계정을 만들 수 있습니다.
나중에 설명하는 대로 판매자 센터 UI 또는 API를 통해 계정을 구성할 수 있습니다.
판매자 센터 서비스 약관 동의
모든 판매자는 판매자 센터 서비스 약관에 동의해야 합니다. 판매자 계정의 서비스 약관에 동의하는 방법은 다음과 같습니다.
accounts.termsOfServiceAgreementStates.retrieveForApplication
를 호출하여 계정에 필요한 서비스 약관을 확인합니다.다음은 샘플 요청입니다.
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates:retrieveForApplication
다음은 호출에 성공했을 때의 샘플 응답입니다.
{ "name": "accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates/MERCHANT_CENTER-{COUNTRY}", "regionCode": {COUNTRY}, "termsOfServiceKind": "MERCHANT_CENTER", "accepted": { "termsOfService": "termsOfService/{VERSION}", "acceptedBy": "accounts/{ACCOUNT_ID}" } }
termsOfService.accept
를 호출하여 서비스 약관에 동의합니다.다음은 샘플 요청입니다.
GET https://merchantapi.googleapis.com/accounts/v1beta/{name=termsOfService/{VERSION}}:accept
성공한 경우 응답 본문은 비어 있습니다.
판매자에게 이용약관을 표시하고 동의하도록 요청하는 UI를 빌드하는 것이 좋습니다.
비즈니스의
regionCode
와 함께termsOfService.retrieveLatest
를 사용하여 판매자가 수락해야 하는 서비스 약관을 찾습니다.다음은 샘플 요청입니다.
GET https://merchantapi.googleapis.com/accounts/v1beta/termsOfService:retrieveLatest
다음은 호출에 성공했을 때의 샘플 응답입니다.
{ "name": "termsOfService/{VERSION}", "regionCode": "{COUNTRY}", "kind": "MERCHANT_CENTER", "fileUri": "{URI}" }
fileUri
의 이용약관을 판매자에게 표시합니다.판매자가 UI에서 서비스 약관에 동의하면 수락할 서비스 약관의
name
를 사용하여termsOfService.accept
를 호출합니다.
판매자가 이용약관에 동의하면 Merchant API를 사용하여 나머지 계정 정보를 설정할 수 있습니다. Merchant Accounts API로 관리할 수 있는 계정 정보에 관한 자세한 내용은 Account
리소스를 참고하세요.
웹사이트 소유권 주장
Merchant Accounts API를 사용하여 비즈니스의 Homepage
를 추가하고 소유권을 주장할 수 있습니다.
- 계정에 홈페이지를 추가하려면 홈페이지 URL이 포함된
Homepage
리소스를 사용하여accounts.updateHomepage
를 호출합니다. - 홈페이지의 소유권을 주장하려면
Hompeage
리소스의name
를 사용하여accounts.homepage.claim
를 호출합니다.
Merchant API를 사용하여 홈페이지를 인증할 수는 없습니다. 자세한 내용은 매장 웹사이트 확인 및 소유권 주장을 참고하세요.
비즈니스 세부정보 업데이트
Merchant Accounts API를 사용하여 비즈니스 PostalAddress
, CusomerService
, BusinessIdentity
를 수정할 수 있습니다.
비즈니스 ID:
- 비즈니스 ID를 보려면
accounts.businessIdentity.getBusinessIdentity
를 호출합니다. - 비즈니스 ID를 수정하려면
accounts.businessIdentity.updateBusinessIdentity
를 호출합니다.
다음 단계
- 하위 계정을 만들고 관리하는 방법을 알아보세요.
- 판매자 계정 간의 관계가 작동하는 방식을 알아보려면 계정 간 관계를 참고하세요.