판매자 API를 사용하여 배송 설정 정보를 읽으려면 다음 요청을 사용합니다.
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings
{accountId}를 판매자 센터 계정의 고유 식별자로 바꿉니다.
판매자 API를 사용하여 배송 설정 정보를 읽으려면 다음 요청을 사용합니다.
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Content API for Shopping과 Merchant API의 비교
다음은 Content API for Shopping과 판매자 배송 설정 API를 비교한 예시입니다.
Content API | 판매자 API | |
---|---|---|
URL | https://shoppingcontent.googleapis.com/content/v2.1/ {accountId}/shippingsettings:insert |
https://merchantapi.googleapis.com/accounts/v1beta/accounts/ {accountId}/shippingSettings:insert |
식별자 | {accountId}/shippingsettings/ {accountId} |
{name} |
다음 목록에서는 Content API for Shopping과 비교하여 판매자 배송 설정 API의 주요 업데이트를 언급합니다.
- 판매자 API 사용자는 {name} 필드에
accounts/{accountId}/shippingSettings
를 입력해야 동일한 동작이 적용됩니다. - 판매자 API는 위치 그룹과 같은 맞춤 영역에 대한 읽기 및 쓰기 작업을 지원하지 않습니다. 위치 그룹과 같은 맞춤 지역은 지역 서비스를 통해서만 읽거나 쓸 수 있습니다.
- 판매자 API의
WarehouseBasedDeliveryTime
설정 방법은 Content API for Shopping과 다릅니다. 판매자 API를 사용하는 경우shippingsettings.warehouses
에 웨어하우스 정보를 정의해야 합니다. 그러면 각 배송 서비스가warehouseBaseDeliveryTime
에서 창고 이름을 통해 창고를 참조할 수 있습니다. - Merchant API의 서비스 하나는 여러 배송 국가를 지원합니다.
새로운 지원 필드
판매자 배송 설정 API는 Content API for Shopping과 비교하여 다음과 같은 새로운 필드를 지원합니다.
- 웨어하우스: 인벤토리를 저장하고 처리하는 처리 웨어하우스에 관한 정보를 제공합니다.
- 포인트 제도: 판매자 API 사용자는 배송 설정에 포인트 제도 정보를 입력할 수 있습니다.
- Etag: Etag: Etag는 여러 사용자가 판매자 API와 판매자 센터 UI를 동시에 사용하여 배송 설정을 업데이트하려고 할 때 발생하는 비동기 문제를 해결하도록 설계되었습니다.
이름이 변경된 필드
판매자 API에서 다음 필드의 이름이 변경되었습니다.
Content API for Shopping | 판매자 배송 설정 API | 설명 |
---|---|---|
service |
services |
단일 배송 서비스입니다. |
service.name |
services.serviceName |
자유 형식의 서비스 이름으로, 판매자 센터 계정 내에서 고유해야 합니다. |
service.deliveryCountry |
services.deliveryCountries |
배송 서비스가 적용되는 국가의 CLDR 지역 코드입니다. |
service.currency |
services.currencyCode |
이 서비스가 적용되는 통화의 CLDR 코드입니다. |
service.deliveryTime.minTransitTimeInDays |
services.deliveryTime.minTransitDays |
주문이 배송되는 최소 영업일 수입니다. 예를 들어 0은 당일 배송을 의미하고 1은 다음날 배송을 의미합니다. |
service.deliveryTime.maxTransitTimeInDays |
services.deliveryTime.maxTransitDays |
주문 운송 시 소비하는 최대 영업일수입니다. |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
주문 상품이 발송되기 전까지 소요된 최소 영업일 수입니다. |
service.deliveryTime.maxHandlingTimeInDays |
services.deliveryTime.maxHandlingDays |
주문 상품이 발송되기 전까지 소비한 최대 영업일 기준입니다. |
service.deliveryTime.cutoffTime.timezone |
services.deliveryTime.cutoffTime.timeZone |
마감 시간의 시간대 식별자입니다. |
service.deliveryTime.transitTimeTable.postalCodeGroupName |
services.deliveryTime.transitTimeTable.postalCodeGroupNames |
우편번호 그룹의 이름입니다. |
service.deliveryTime.transitTimeTable.transitTimeLabel |
services.deliveryTime.transitTimeTable.transitTimeLabel |
제품의 운송 시간 라벨입니다. |
service.rate_group |
services.rateGroups |
배송비 그룹 정의입니다. |
service.rate_group.subtable |
services.rateGroups.subtables |
하위 표 목록입니다. |
service.rate_group.carrier_rate |
services.rateGroups.carrierRates |
운송업체 요금 목록입니다. |
service.minimumOrderValueTable.storeCodeSetWithMovs |
services.minimumOrderValueTable.storeCodeSetWithMovs |
동일한 최소 주문값을 공유하는 판매점 코드 세트의 목록입니다. |
지원 중단된 메서드
shippingsettings.custombatch
를 사용하여 단일 요청으로 여러 계정의 배송 설정을 검색하고 업데이트할 수 없습니다.
지원 중단된 필드
다음 필드는 판매자 API에서 지원 중단되었습니다. 판매자 API는 이러한 필드에 대한 대안을 제공하지 않습니다.
Content API for Shopping | 판매자 API | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
postal_code_group |
region |
||||||||||||||||||||
service
| 메서드다음은 Content API for Shopping과 Merchant Shipping settings API의 메서드를 비교한 것입니다.
|