Content API for Shopping 호환성

이 가이드를 사용하여 판매자 API를 기존 Content API for Shopping 구현과 통합할 수 있습니다.

사용해 보기

판매자 API 및 해당 하위 API에 대한 자세한 내용은 판매자 API 설계를 참조하세요.

판매자 API를 사용하려면 요청 URL을 다음 형식으로 변경하세요.

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…

자세한 내용은 빠른 시작 가이드 및 판매자 API 참조를 확인하세요.

gRPC 지원

Merchant API는 gRPC 및 REST를 지원합니다. 판매자 API에는 gRPC를, 쇼핑용 Content API에는 REST를 동시에 사용할 수 있습니다.

판매자 API 클라이언트 라이브러리에는 gRPC가 필요합니다.

자세한 내용은 gRPC 사용을 참조하세요.

호환성

이 가이드에서는 전체 판매자 API에 적용되는 일반적인 변경사항을 설명합니다. 특정 기능의 변경사항은 다음 가이드를 참고하세요.

판매자 API는 기존 Content API for Shopping v2.1 기능과 함께 작동하도록 설계되었습니다.

예를 들어 기존 Content API for Shopping v2.1 인벤토리 및 products 구현과 함께 판매자 인벤토리 API를 사용할 수 있습니다. Content API for Shopping을 사용하여 오프라인 상점에서 판매하는 새 오프라인 제품을 업로드한 다음 Merchant Inventories API LocalInventory 리소스를 사용하여 해당 제품의 매장 정보를 관리할 수 있습니다.

일괄 요청

판매자 API는 Content API for Shopping에서 제공하는 customBatch 메서드를 지원하지 않습니다. 대신 일괄 요청 보내기를 참고하세요. customBatch를 사용하며 판매자 API에 이 기능이 필요한 경우 의견을 통해 이유를 알려주세요.

식별자

Google의 API 개선 원칙에 따라 판매자 API 리소스의 식별자를 일부 변경했습니다.

이름이 ID를 대체함

모든 판매자 API 리소스는 name 필드를 고유 식별자로 사용합니다.

다음은 호출에 name 필드를 사용하는 방법을 보여주는 예입니다.

POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert

이 새로운 name 필드는 판매자 API의 모든 읽기 및 쓰기 호출의 리소스 식별자로 반환됩니다.

name 필드에 반환된 값은 새 ID 형식을 사용합니다.

예를 들어 getName() 메서드를 구현하여 리소스에서 name를 검색하고 출력을 판매자 및 리소스 ID에서 직접 name를 구성하는 대신 변수로 저장합니다.

새 ID 형식

판매자 API에서 리소스 ID는 다음 형식을 사용합니다. channel~language~feedLabel~offerId

Content API 리소스가 ID의 각 값 사이에 ~ 대신 :을(를) 사용했습니다. channel:language:feedLabel:offerId

모든 판매자 API 호출은 ID 값 사이에 ~가 있는 새 형식을 반환합니다. 응답의 새 형식을 저장하고 이후 호출에서 사용하는 것이 좋습니다.

하위 리소스의 상위 필드

판매자 API에서 모든 하위 리소스에는 parent 필드가 있습니다. 전체 상위 리소스를 전달하는 대신 parent 필드를 사용하여 하위 요소를 삽입할 리소스의 name을 지정할 수 있습니다. parent 필드를 list 메서드와 함께 사용하여 해당 parent의 하위 리소스를 나열할 수도 있습니다.

예를 들어 특정 제품의 오프라인 판매점 인벤토리를 나열하려면 list 메서드의 parent 필드에 제품의 name를 지정합니다. 이 경우 지정된 product는 반환된 LocalInventory 리소스의 parent입니다.

유형

다음은 판매자 API 하위 API에서 공유되는 몇 가지 일반적인 유형입니다.

가격

Merchant Common 패키지에서 Price의 변경사항은 다음과 같습니다.

Content API 판매자 API
금액 필드 value:string amountMicros:int64
통화 필드 currency:string currencyCode:string

이제 Price 금액이 마이크로로 기록되며, 100만 마이크로는 통화의 표준 단위에 해당합니다.

Content API for Shopping에서 Price는 문자열 형식의 10진수입니다.

금액 필드 이름이 value에서 amountMicros(으)로 변경되었습니다.

통화 필드 이름이 currency에서 currencyCode(으)로 변경되었습니다. 형식은 ISO 4217로 유지됩니다.

이전
빠른 시작
다음
계정 관리 이전