ShippingSettings
리소스를 사용하면 계정 및
연결된 모든 하위 계정의 배송 설정을 가져오고 업데이트할 수 있습니다. 계정의 배송 설정을 추가하거나 관리하는 방법에 대한 자세한 내용은 배송 설정 개요를 참고하세요.
Merchant API를 사용하여 배송 설정 정보를 읽으려면 다음 요청을 사용하세요.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings
{ACCOUNT_ID}를 판매자 센터 계정의 고유 식별자로 바꿉니다.
Merchant API를 사용하여 배송 설정 정보를 업데이트하려면 다음 요청을 사용하세요.
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
자세한 내용은 메서드:
accounts.shippingSettings.insert를 참고하세요.
Content API for Shopping과 Merchant API 비교
다음은 Content API for Shopping과 Accounts 하위 API의 배송 설정 리소스를 비교한 샘플입니다.
| Content API | Merchant API | |
|---|---|---|
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} |
https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert |
| 식별자 | {MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} |
{NAME} |
다음 목록에는 Content API for Shopping과 비교하여 Accounts 하위 API의 배송 설정 리소스에 적용된 주요 업데이트가 나와 있습니다.
- Merchant API 사용자는 동일한 동작을 위해
{NAME} 필드에
accounts/{ACCOUNT_ID}/shippingSettings를 입력해야 합니다. - Merchant API는 위치 그룹과 같은 맞춤 영역에 대한 읽기 및 쓰기 작업을 지원하지 않습니다. 위치 그룹과 같은 맞춤 영역은 리전 서비스를 사용해서만 읽거나 쓸 수 있습니다.
- Merchant API의 한 서비스는 여러 배송 국가를 지원합니다.
- Merchant API는 Content API의 shippingsettings.list 메서드와 달리 배송 설정의 목록 메서드를 제공하지 않습니다.
새로 지원되는 필드
Accounts 하위 API의 배송 설정 리소스는 Content API for Shopping과 비교하여 다음과 같은 새 필드를 지원합니다.
warehouses: 재고를 저장하고 처리하는 주문 처리 창고에 관한 정보를 제공합니다.- 포인트 멤버십: Merchant API 사용자는 배송 설정에 포인트 멤버십 정보를 입력할 수 있습니다.
- Etag: Etag는 여러 사용자가 Merchant API 및 판매자 센터 UI를 사용하여 배송 설정을 동시에 업데이트하려고 할 때 발생하는 비동기 문제를 해결하도록 설계되었습니다.
이름이 변경된 필드
Accounts 하위 API의 배송 설정 리소스에서 다음 필드의 이름이 변경되었습니다.
| Content API for Shopping | 배송 설정 리소스 | 설명 |
|---|---|---|
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 for Shopping의 다음 필드는 Merchant API에서 삭제되었습니다. Merchant API는 이러한 필드에 대한 대안을 제공하지 않습니다.
postal_code_groupservicePickup_serviceEligibilityScheduling_channelDelivery_timeHoliday_cutoffRate_groupsingle_value_alternative_list
메서드
다음은 Content API for Shopping과 배송 설정 리소스의 메서드를 비교한 것입니다.
| 메서드 | Content API for Shopping | Merchant API |
|---|---|---|
customBatch |
지원 | 아니요 |
get |
예 | 예 |
update |
예 | 아니요 |
insert |
아니요 | 예 |
list |
예 | 아니요 |
getSupportedCarrier |
예 | 아니요 |
getSupportedHolidays |
예 | 아니요 |