이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Content API for Shopping에서 계정 관리 이전

이 문서에서는 Content API v2.1에서 Merchant API로 마이그레이션하는 방법을 설명합니다.

Content API v2.1에서 Merchant API로의 변경사항 개요

Merchant API는 개발자와 비즈니스의 사용성, 일관성, 유연성을 개선하기 위해 Content API v2.1에 비해 크게 개선되었습니다.

세분화된 리소스 구조

Merchant API의 리소스는 account, businessDetails, user, homepage, program와 같은 단일 개념을 나타냅니다. 관계를 반영하도록 계층적으로 구성됩니다. 예를 들어 account는 user의 상위 리소스입니다.

통합 계정 서비스

모든 계정 서비스 (예: MCA 및 하위 계정의 계정 집계 또는 서드 파티 서비스 제공업체와 계정 간의 계정 집계)는 통합된 accountService 리소스를 통해 관리됩니다. 서비스 제공업체는 accountRelationship 리소스를 사용하여 관계를 관리할 수 있습니다.

간소화된 URL 구조

이제 URL은 여러 ID 대신 단일 계정 ID (예: merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId})를 사용합니다. URL 경로는 세분화된 리소스 구조를 반영합니다.

기타 개선사항

프로그램 및 사용자 관리 개선: 쇼핑 광고 및 무료 등록정보와 같은 프로그램이 단일 program 리소스로 통합됩니다. user 리소스에는 세분화된 액세스 권한이 있는 포괄적인 관리 기능이 포함되어 있습니다.
구조화된 비즈니스 정보 및 비즈니스 ID: businessInfo 및 businessIdentity에 관한 전용 리소스가 있습니다. 여기에는 리전별 데이터 필드의 규정 준수 지원이 포함됩니다. 예: 대한민국 사업자등록번호
홈페이지 소유권 주장 간소화: 전용 homepage 리소스가 스토어의 홈페이지 URL을 관리합니다. claim 및 unclaim와 같은 메서드는 API를 통해 직접 웹사이트 소유권 주장을 처리합니다.
Google API 가이드라인 준수: Merchant API는 Google의 API 개선 제안서에 맞추는 것을 목표로 합니다.

계정 관리 이전

accounts 리소스를 사용하여 판매자 계정을 만들고 관리할 수 있습니다. 자세한 내용은 Merchant Accounts API 개요를 참고하세요.

이 페이지에서는 계정 관리를 Content API에서 Merchant API로 이전하는 방법을 설명합니다.

요청

Merchant Accounts API에는 다음과 같은 요청 URL 형식을 사용하세요.

POST https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts

다음은 계정 생성 및 관리 요청을 위한 Content API for Shopping과 Merchant Accounts API를 비교한 샘플입니다.

	Content API for Shopping	Merchant Accounts API
URL	`https://shoppingcontent.googleapis.com/content/v2.1/`merchantId`/accounts/`accountId/	`https://merchantapi.googleapis.com/accounts/v1beta/accounts/`accountId
식별자	merchantId`/accounts/`accountId	`accounts/`accountId

리소스

계정 데이터는 쇼핑용 Content API의 Account 리소스를 사용하여 전달됩니다. Merchant Accounts API는 계정 데이터를 전달하는 여러 리소스를 제공합니다. 이러한 리소스에는 Account, User, BusinessInfo, BusinessIdentity 리소스가 포함됩니다.

다음 표에서는 쇼핑용 Content API의 Account 리소스와 판매자 계정 API의 Account 리소스를 비교하여 보여줍니다.

Content API for Shopping	Merchant Accounts API
`id`	`name`
`name`	`accountName`
`kind`	사용할 수 없음
`websiteUrl`	`Homepage` 리소스의 `uri` 필드
`adultContent`	`adultContent`
`sellerId`	`AccountRelationship` 리소스의 `accountIdAlias` 필드
`users`	`[User](/merchant/api/reference/rest/v1/accounts.v1beta.accounts.users)` 리소스
`youtubeChannelLinks`	아직 사용할 수 없음
`googleMyBusinessLink`	아직 사용할 수 없음
`businessInformation`	`[businessInfo](/merchant/api/reference/rest/v1/BusinessInfo)` 리소스
`businessIdentity`	`[businessIdentity](/merchant/api/reference/rest/v1/BusinessIdentity)` 리소스
`automaticImprovements`	아직 사용할 수 없음
`adsLinks`	`AccountService` 리소스의 `campaignsManagement` 필드
`cssId`	CSS API에서만 사용할 수 있습니다.
`labelIds`	CSS API에서만 사용할 수 있습니다.
`accountManagement`	`AccountService` 리소스의 `accountManagement` 필드
`automaticLabelIds`	CSS API에서만 사용할 수 있습니다.
`conversionSettings`	아직 사용할 수 없음

다음 표는 Content API for Shopping의 AccountUser 리소스와 Merchant Accounts API의 User 리소스를 비교합니다.

Content API for Shopping	Merchant Accounts API
`emailAddress`	이메일은 `name`(`accounts/{account}/users/{email}`)의 일부입니다.
`admin`	`user#accessRights.ADMIN`
`orderManager`	사용할 수 없음
`paymentsManager`	사용 불가
`paymentsAnalyst`	사용할 수 없음
`reportingManager`	`user#accessRights.PERFORMANCE_REPORTING`

다음 표에는 Content API for Shopping의 AccountBusinessInformation 리소스와 Merchant Accounts API의 이에 상응하는 리소스 businessInfo를 비교하여 보여줍니다.

Content API for Shopping	Merchant Accounts API
`businessInformation`	`businessInfo`
`phoneNumber`	`phone`
`phoneVerificationStatus`	`phoneVerificationState`
`customerService`	`customerService`
`koreanBusinessRegistrationNumber`	`koreanBusinessRegistrationNumber`

다음 표에는 쇼핑용 Content API의 AccountBusinessIdentity 리소스와 판매자 계정 API의 businessIdentity 리소스를 비교한 내용이 나와 있습니다.

Content API for Shopping	Merchant Accounts API
`blackOwned`	`blackOwned`
`womenOwned`	`womenOwned`
`veteranOwned`	`veteranOwned`
`latinoOwned`	`latinoOwned`
`smallBusiness`	`smallBusiness`
`includeForPromotions`	`promotionsConsent`
	- `true`: `PROMOTION_CONSENT_GIVEN`을(를) 나타냄
	- `false`: `PROMOTION_CONSENT_DENIED`을(를) 나타냄

Content API의 AccountIdentityType 리소스는 MerchantAPI의 IdentityAttribute 유형 및 identityDeclaration 필드로 표현됩니다.

Content API for Shopping	Merchant Accounts API
`self_identified`	`identityDeclaration`
	- `true`: `SELF_IDENTIFIES_AS`을(를) 나타냄
	- `false`: `DOES_NOT_SELF_IDENTIFY_AS`을(를) 나타냄

메서드

Merchant Accounts API에 다음 메서드가 도입되었습니다.

Content API for Shopping	Merchant Accounts 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`	사용할 수 없음. Merchant API에서는 맞춤 일괄 처리가 지원되지 않습니다.
`accounts.delete`	`DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/`accountId
`accounts.get`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`
`accounts.insert`	`POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure`
	자세한 내용은 판매자 계정 만들기 및 구성을 참고하세요.
`accounts.link`	`AccountService` 리소스
`accounts.list`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`:listSubaccounts`
`accounts.listlinks`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`/services`
`accounts.update`	필수 필드 또는 필드 집합이 정의된 리소스의 업데이트 요청에 매핑됩니다.

개요

인벤토리 관리 이전