ShippingSettings
리소스를 사용하면 계정 및 연결된 모든 하위 계정의 배송 설정을 검색하고 업데이트할 수 있습니다. 계정의 배송 설정을 추가하거나 관리하는 방법에 관한 자세한 내용은 배송 설정 개요를 참고하세요.
Merchant API를 사용하여 배송 설정 정보를 읽으려면 다음 요청을 사용하세요.
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings
{ACCOUNT_ID}를 판매자 센터 계정의 고유 식별자로 바꿉니다.
Merchant API를 사용하여 배송 설정 정보를 업데이트하려면 다음 요청을 사용하세요.
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings:insert
자세한 내용은 메서드:
accounts.shippingSettings.insert
를 참고하세요.
Content API for Shopping과 Merchant API 비교
다음은 Content API for Shopping과 Merchant Shipping settings API를 비교한 샘플입니다.
Content API | Merchant API | |
---|---|---|
URL | https://shoppingcontent.googleapis.com/content/v2.1/ {ACCOUNT_ID}/shippingsettings:insert |
https://merchantapi.googleapis.com/accounts/v1beta/accounts/ {ACCOUNT_ID}/shippingSettings:insert |
식별자 | {ACCOUNT_ID}/shippingsettings/ {ACCOUNT_ID} |
{NAME} |
다음 목록에는 Content API for Shopping과 비교하여 Merchant Shipping settings API의 주요 업데이트가 나와 있습니다.
- Merchant API 사용자는 동일한 동작을 하려면 {NAME} 필드에
accounts/{ACCOUNT_ID}/shippingSettings
를 넣어야 합니다. - Merchant API는 위치 그룹과 같은 맞춤 영역의 읽기 및 쓰기 작업을 지원하지 않습니다. 위치 그룹과 같은 맞춤 영역은 지역 서비스를 사용하여만 읽거나 쓸 수 있습니다.
WarehouseBasedDeliveryTime
설정 방법은 Merchant API와 Content API for Shopping에서 다릅니다. Merchant API를 사용하는 경우shippingsettings.warehouses
아래에 창고 정보를 정의해야 합니다. 그러면 각 배송 서비스는warehouseBaseDeliveryTime
아래의 창고 이름을 통해 창고를 참조할 수 있습니다.- Merchant API의 한 서비스가 여러 배송 국가를 지원합니다.
지원되는 새로운 필드
Merchant Shipping settings API는 쇼핑용 Content API에 비해 다음과 같은 새 필드를 지원합니다.
- 창고: 인벤토리를 저장하고 처리하는 주문 처리 창고에 대한 정보를 제공합니다.
- 포인트 제도: Merchant API 사용자는 배송 설정에 포인트 제도 정보를 입력할 수 있습니다.
- Etag: Etag는 여러 사용자가 Merchant API와 판매자 센터 UI를 동시에 사용하여 배송 설정을 업데이트하려고 할 때 비동기 문제를 해결하도록 설계되었습니다.
이름이 변경된 필드
Merchant API에서 다음 필드의 이름이 변경되었습니다.
Content API for Shopping | Merchant Shipping settings 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
를 사용하여 단일 요청에서 여러 계정의 배송 설정을 검색하고 업데이트할 수는 없습니다.
지원 중단된 필드
Content API의 다음 필드는 Merchant API에서 지원 중단되었습니다. Merchant API는 이러한 필드에 대한 대안을 제공하지 않습니다.
postal_code_group
service
Pickup_service
Eligibility
Scheduling_channel
Delivery_time
Holiday_cutoff
Min_scheduling_time_in_days
Max_scheduling_time_in_days
Scheduling_business_day_config
Rate_group
single_value_alternative_list
메서드
다음은 Content API for Shopping과 Merchant Shipping settings API의 메서드 비교입니다.
메서드 | Content API for Shopping | Merchant API |
---|---|---|
customBatch |
예 | 아니요 |
get |
예 | 예 |
update |
예 | 아니요 |
insert |
아니요 | 예 |
getSupportedCarrier |
예 | 아니요 |
getSupportedHolidays |
예 | 아니요 |