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_consent true 는 PROMOTION_CONSENT_GIVEN 을,false 는 PROMOTION_CONSENT_DENIED 를 나타냅니다.
|
다음 표에서는 Content API for Shopping의 AccountIdentityType
리소스와 Merchant Accounts API의 identityAttribute
리소스를 비교합니다.
Content API for Shopping | 판매자 계정 API |
---|---|
self_identified |
identity_declaration true 는 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 |
필수 필드 또는 필드 집합이 정의된 리소스의 업데이트 요청에 매핑됩니다. |