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와 같은 단일 개념을 나타냅니다. 관계를 반영하도록 계층적으로 구성됩니다. 예를 들어 accountuser의 상위 리소스입니다.

통합 계정 서비스

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

간소화된 URL 구조

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

기타 개선사항

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

계정 관리 이전

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

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

요청

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

https://merchantapi.googleapis.com/accounts/v1beta/{ACCOUNT_ID}/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/{name=accounts/*}
식별자 merchantId,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 리소스
youtubeChannelLinks 아직 사용할 수 없음
googleMyBusinessLink 아직 사용할 수 없음
businessInformation businessInfo 리소스
businessIdentity businessIdentity 리소스
automaticImprovements 아직 사용할 수 없음
adsLinks AccountService 리소스의 campaignsManagement 필드
cssId CSS API에서만 사용할 수 있습니다.
labelIds CSS API에서만 사용할 수 있습니다.
accountManagement AccountService 리소스의 accountManagement 필드
automaticLabelIds CSS API에서만 사용할 수 있습니다.
conversionSettings 아직 사용할 수 없음

다음 표는 쇼핑용 Content API의 AccountUser 리소스와 판매자 계정 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
address address
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
- truePROMOTION_CONSENT_GIVEN을(를) 나타냅니다.
- falsePROMOTION_CONSENT_DENIED을(를) 나타냅니다.

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

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