accounts 리소스를 사용하여 판매자 계정을 만들고 관리할 수 있습니다. 자세한 내용은 Merchant Accounts API 개요를 참조하세요.
이 페이지에서는 Content API에서 Merchant API로 계정 관리를 이전하는 방법을 설명합니다.
요청
판매자 계정 API에는 다음 요청 URL 형식을 사용합니다.
POST https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
다음은 계정 생성 및 관리 요청을 위한 Content API for Shopping과 판매자 Accounts API를 비교한 샘플입니다.
| Content API for Shopping | 판매자 계정 API | |
|---|---|---|
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/
|
https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
|
| 식별자 | {merchantId}/accounts/{accountId} |
{accountId}
|
리소스
계정 데이터는 Content API for Shopping의 Account 리소스를 사용하여 전달됩니다. 판매자 계정 API는 계정 데이터를 전달하기 위한 여러 리소스를 제공합니다. 이러한 리소스에는 Account, User, BusinessInfo, BusinessIdentity 리소스가 포함됩니다.
다음 표에서는 Content API for Shopping의 Account 리소스와 Merchant Accounts API의 Account 리소스를 비교합니다.
| Content API for Shopping | 판매자 계정 API |
|---|---|
id
|
account_id
|
name
|
account_name
|
kind
|
사용할 수 없음 |
websiteUrl
|
homepage 리소스의 uri 필드
|
adultContent
|
adult_content
|
sellerId
|
사용할 수 없음 |
users
|
리소스 User개에 포함
|
youtubeChannelLinks
|
아직 사용할 수 없음 |
googleMyBusinessLink
|
아직 사용할 수 없음 |
businessInformation
|
리소스 businessInfo개에 포함
|
businessIdentity
|
리소스 businessIdentity개에 포함
|
automaticImprovements
|
아직 사용할 수 없음 |
adsLinks
|
아직 사용할 수 없음 |
cssId
|
CSS API에서만 사용 가능 |
labelIds
|
CSS API에서만 사용 가능 |
accountManagement
|
아직 사용할 수 없음 |
automaticLabelIds
|
CSS API에서만 사용 가능 |
conversionSettings
|
아직 사용할 수 없음 |
다음 표에서는 Content API for Shopping의 AccountUser 리소스와 Merchant Accounts API의 User 리소스를 비교합니다.
| Content API for Shopping | 판매자 계정 API |
|---|---|
emailAddress |
email은(는) name(accounts/{account}/users/{email})의 일부입니다. |
admin |
user#access_rights.ADMIN |
orderManager |
사용할 수 없음 |
paymentsManager |
사용할 수 없음 |
paymentsAnalyst |
사용할 수 없음 |
reportingManager |
user#access_rights.PERFORMANCE_REPORTING |
다음 표에서는 Content API for Shopping의 AccountBusinessInformation 리소스와 Merchant Accounts API의 이에 상응하는 리소스 businessinfo를 비교합니다.
| Content API for Shopping | 판매자 계정 API |
|---|---|
businessInformation |
businessinfo |
phoneNumber |
phone |
phoneVerificationStatus |
phone_verification_state |
customerService |
customer_service |
koreanBusinessRegistrationNumber |
사용할 수 없음 |
다음 표에서는 Content API for Shopping의 AccountBusinessIdentity 리소스와 Merchant Accounts API의 businessIdentity 리소스를 비교합니다.
| Content API for Shopping | 판매자 계정 API |
|---|---|
blackOwned |
black_owned |
womenOwned |
women_owned |
veteranOwned |
veteran_owned |
latinoOwned |
latino_owned |
smallBusiness |
small_business |
includeForPromotions |
promotions_consenttrue는 PROMOTION_CONSENT_GIVEN을,false는 PROMOTION_CONSENT_DENIED를 나타냅니다.
|
다음 표에서는 Content API for Shopping의 AccountIdentityType 리소스와 Merchant Accounts API의 identityAttribute 리소스를 비교합니다.
| Content API for Shopping | 판매자 계정 API |
|---|---|
self_identified |
identity_declarationtrue는 SELF_IDENTIFIES_AS을,false는 DOES_NOT_SELF_IDENTIFY_AS를 나타냅니다.
|
방법
판매자 계정 API에 다음과 같은 메서드가 도입되었습니다.
| Content API for Shopping | 판매자 계정 API |
|---|---|
accounts.authinfo |
필터 없는 GET https://merchantapi.googleapis.com/accounts/v1beta/accounts |
accounts.claimwebsite |
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId/homepage:claim자세한 내용은 메서드: accounts.v1beta.accounts.homepage.claim을 참조하세요. |
accounts.custombatch |
사용할 수 없음. 판매자 API에서는 커스텀 배치가 지원되지 않습니다. |
| accounts.delete | DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId |
accounts.get |
필수 필드 또는 필드 집합이 정의된 리소스의 GET 요청에 매핑됩니다. |
accounts.insert |
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure자세한 내용은 판매자 계정 만들기 및 구성을 참고하세요. |
accounts.link |
아직 지원되지 않는 기능입니다. |
accounts.list |
GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts |
accounts.listlinks |
아직 지원되지 않는 기능입니다. |
accounts.update |
필수 필드 또는 필드 집합이 정의된 리소스의 업데이트 요청에 매핑됩니다. |