Content API for Shopping 호환성

이 가이드를 사용하여 Merchant API를 기존 Content API for Shopping 구현

시작하기

판매자 API 설계에서 Merchant 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 for Shopping용 REST 동시에 있습니다.

판매자 API 클라이언트 라이브러리에는 gRPC

자세한 내용은 gRPC 사용을 참조하세요. 확인할 수 있습니다

호환성

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

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

예를 들어 기존 인벤토리 인벤토리와 함께 판매자 인벤토리 API를 Content API for Shopping v2.1 인벤토리 및 products 구현 나 Content API for Shopping을 사용해 오프라인 제품 (광고주가 판매하는 판매자 인벤토리 API를 사용하여 LocalInventory 해당 제품의 매장 정보를 관리하기 위한 리소스입니다.

일괄 요청

Merchant API는 customBatch 메서드를 지원하지 Content API for Shopping 대신 일괄 데이터 보내기 요청을 참조하세요. 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 name를 구성하는 대신 출력을 변수로 저장합니다. 직접 삭제할 수 있습니다.

새 ID 형식

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

Content API 리소스에서 ID의 각 값 사이에 ~ 대신 :을(를) 사용했습니다. <ph type="x-smartling-placeholder">channel:language:feedLabel:offerId</ph>

모든 판매자 API 호출은~ 있습니다. 응답의 새 형식을 저장하고 있습니다.

하위 리소스의 상위 필드

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

예를 들어 특정 제품의 오프라인 판매점 인벤토리를 나열하려면 제품의 name parent 필드를 list 메서드를 사용하여 축소하도록 요청합니다. 이 경우 지정된 product는parent LocalInventory 리소스 수에 따라 다릅니다

유형

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

가격

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

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

Price 금액은 이제 100만 마이크로(micro)로 기록되고 있습니다. 이는 통화의 표준 단위와 동일합니다.

Content API for Shopping에서 Price은 문자열.

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

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

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