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 |
예 | 아니요 |