홈페이지 설정 이전

Merchant API는 전용 Homepage 리소스를 도입합니다. 이 리소스는 홈페이지 소유권 주장을 관리하는 새로운 메서드를 제공하며 기존의 Content API for Shopping을 뛰어넘는 기능을 제공합니다.

온라인 스토어의 기능에 액세스하는 것은 두 단계로 이루어집니다. 먼저 소유권을 확인한 다음 계정의 사이트 소유권 주장을 합니다. 마지막 단계를 완료하려면 다음을 사용하세요 accounts.homepage.claim.

주요 차이점

Merchant API는 Content API for Shopping과 비교하여 홈페이지와 관련된 여러 변경사항을 적용합니다.

• 전용 리소스: Merchant API는 모든 홈페이지 관련 작업에 대해 고유한 Homepage 리소스 (accounts.homepage) 를 제공합니다. (Content API for Shopping에서는 accounts.claimwebsite를 사용하여 소유권 주장 작업을 실행했으며 홈페이지 URL (website_url)은 Account 리소스의 일부였고 소유권 주장 상태 (website_claimed)는 AccountStatus 리소스의 일부였습니다.)
• 세분화된 메서드: Merchant API는 다음과 같은 특정 메서드를 제공합니다.
  • 홈페이지 세부정보 가져오기: accounts.homepage.getHomepage
  • 홈페이지 URI 업데이트: accounts.homepage.updateHomepage
  • 홈페이지 소유권 주장: accounts.homepage.claim
  • 홈페이지 소유권 주장 취소: accounts.homepage.unclaim Content API for Shopping은 소유권 주장 작업에 accounts.claimwebsite를 사용하고, URL을 설정하는 데 accounts.update (빈 URL을 설정하여 소유권 주장 취소)를 사용하고, URL 및 소유권 주장 상태를 각각 가져오는 데 accounts.get/accountstatuses.get를 사용했습니다.
• 중앙 집중식 정보: Merchant API Homepage 리소스에는 uri (홈페이지 URL)와 claimed 상태가 모두 직접 포함되어 있습니다. Homepage 리소스에서 작동하는 모든 메서드는 이 리소스를 반환하여 현재 상태에 대한 즉각적인 의견을 제공합니다. Content API for Shopping에서는 accounts.claimwebsite가 업데이트된 상태를 반환하지 않았으며 별도의 호출이 필요했습니다.
• 명시적 소유권 주장 취소: Content API for Shopping에서는 일반적으로 Account.website_url을 빈 문자열로 업데이트하여 소유권 주장을 취소했습니다. Merchant API는 전용 homepage.unclaim 메서드를 제공합니다.
• 소유권 주장 덮어쓰기: 두 API 모두 소유권을 확인할 수 있는 경우 소유권 주장 프로세스 중에 overwrite 매개변수를 지원하여 다른 계정의 소유권 주장을 인수합니다.

요청

Merchant API는 홈페이지의 다양한 측면을 관리하는 데 고유한 RESTful 엔드포인트를 사용합니다.

요청 설명	Content API for Shopping	Merchant API
홈페이지 세부정보 가져오기	accounts.get (Account.website_url 읽기), accountstatuses.get (AccountStatus.website_claimed 읽기)	GET /accounts/v1/accounts/{account}/homepage
홈페이지 URI 업데이트	accounts.update (Account.website_url 설정)	PATCH /accounts/v1/accounts/{account}/homepage
홈페이지 소유권 주장 또는 재인증	POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite (accounts.update를 사용하여 설정된 Account.website_url에 대해 작동)	POST /accounts/v1/accounts/{account}/homepage:claim
홈페이지 소유권 주장 취소	accounts.update (Account.website_url을 빈 문자열로 설정)	POST /accounts/v1/accounts/{account}/homepage:unclaim

식별자

Merchant API에서 리소스 식별이 간소화되었습니다.

식별자 설명	Content API for Shopping	Merchant API
리소스 액세스를 위한 계정 식별자	경로의 merchantId (고급 계정) 및 accountId (하위 계정)	account (name 필드의 일부, 예: accounts/{account_id}/homepage)
홈페이지 리소스 식별자	해당 사항 없음 (Account 리소스에 암시적)	name: accounts/{account_id}/homepage (Homepage 하위 리소스를 식별함)

메서드

소유권 주장 작업에 중점을 둔 Content API for Shopping의 accounts.claimwebsite 메서드는 이제 Merchant API의 Homepage 리소스 내에서 더 광범위한 기능 집합의 일부입니다.

Content API for Shopping 메서드	Merchant API 메서드	사용 가능 여부 및 참고사항
accounts.claimwebsite	accounts.homepage.claim	웹사이트 소유권 주장을 직접 시작하거나 재인증합니다. 이전에 homepage.update를 사용하여 설정된 uri에 대해 작동합니다. overwrite 매개변수를 포함합니다. 현재 uri 및 claimed 상태가 포함된 Homepage 리소스를 반환합니다.
accounts.get (Account.website_url 읽기), accountstatuses.get (AccountStatus.website_claimed 읽기)	accounts.homepage.getHomepage	단일 호출로 현재 홈페이지 uri 및 claimed 상태를 가져오는 새로운 전용 메서드입니다.
accounts.update (Account.website_url 설정)	accounts.homepage.updateHomepage	홈페이지 uri를 설정하거나 변경하는 새로운 전용 메서드입니다.
accounts.update (소유권 주장 취소를 위한 해결 방법으로 Account.website_url을 빈 문자열로 설정)	accounts.homepage.unclaim	홈페이지 소유권 주장을 명시적으로 취소하는 새로운 전용 메서드입니다.

세부 필드 변경사항

홈페이지 정보가 구성되고 액세스되는 방식이 Merchant API의 명시적 Homepage 리소스로 이동하면서 크게 변경되었습니다.

Content API for Shopping	Merchant API	설명
merchantId (accounts.claimwebsite의 경로 매개변수)	name (Homepage 메서드의 경로 매개변수, 형식: accounts/{account}/homepage)	Merchant API의 name 문자열의 account 부분은 Content API for Shopping의 accountId에 해당합니다.
accountId (accounts.claimwebsite의 경로 매개변수)	name (Homepage 메서드의 경로 매개변수, 형식: accounts/{account}/homepage)	홈페이지가 관리되는 특정 계정의 식별자입니다.
overwrite (ContentAccountsClaimwebsiteRequest 본문 및 AccountsCustomBatchRequestEntry의 불리언)	ClaimHomepageRequest.overwrite (homepage.claim 요청 본문의 불리언)	선택사항입니다. true인 경우 웹사이트 소유권 주장을 시도하며 요청 계정에서 소유권을 확인할 수 있는 경우 다른 계정의 기존 소유권 주장을 삭제할 수 있습니다.
Account.website_url (Account 리소스의 필드, accounts.update를 사용하여 설정, accounts.get를 사용하여 읽기)	Homepage.uri (Homepage 리소스의 필드)	스토어 홈페이지의 URI (URL)입니다. Merchant API에서 이는 Homepage 리소스 내의 명시적 필드입니다. accounts.homepage.updateHomepage를 사용하여 설정되며 모든 Homepage 메서드에서 반환됩니다.
AccountStatus.website_claimed (AccountStatus 리소스의 필드, accountstatuses.get을 사용하여 읽기)	Homepage.claimed (Homepage 리소스의 output_only 불리언 필드)	uri가 소유권 주장되고 확인되었는지 나타냅니다. 이 상태는 연결된 모든 Merchant API 메서드에서 반환되는 Homepage 리소스에서 직접 사용할 수 있습니다.
해당 사항 없음	UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage 요청 본문 매개변수)	Homepage 리소스의 업데이트되는 필드 (예: uri)를 지정하는 homepage.update의 선택적 필드 마스크입니다.