Content API for Shopping에서 배송 설정 이전

ShippingSettings 리소스를 사용하면 계정 및 연결된 모든 하위 계정의 배송 설정을 검색하고 업데이트할 수 있습니다. 계정의 배송 설정을 추가하거나 관리하는 방법에 관한 자세한 내용은 배송 설정 개요를 참고하세요.

Merchant API를 사용하여 배송 설정 정보를 읽으려면 다음 요청을 사용하세요.

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings

{accountId}를 판매자 센터 계정의 고유 식별자로 바꿉니다.

Merchant API를 사용하여 배송 설정 정보를 업데이트하려면 다음 요청을 사용하세요.

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/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/{accountId}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
식별자	{accountId}/shippingsettings/{accountId}	{name}

다음 목록에는 Content API for Shopping과 비교하여 Merchant Shipping settings API의 주요 업데이트가 나와 있습니다.

1. Merchant API 사용자는 동일한 동작을 하려면 {name} 필드에 accounts/{accountId}/shippingSettings를 넣어야 합니다.
2. Merchant API는 위치 그룹과 같은 맞춤 영역의 읽기 및 쓰기 작업을 지원하지 않습니다. 위치 그룹과 같은 맞춤 지역은 지역 서비스를 사용하여만 읽거나 쓸 수 있습니다.
3. WarehouseBasedDeliveryTime 설정 방법은 Merchant API와 Content API for Shopping에서 다릅니다. Merchant API를 사용하는 경우 shippingsettings.warehouses 아래에 창고 정보를 정의해야 합니다. 그러면 각 배송 서비스는 warehouseBaseDeliveryTime 아래의 창고 이름을 통해 창고를 참조할 수 있습니다.
4. Merchant API의 한 서비스가 여러 배송 국가를 지원합니다.

새로 지원되는 필드

Merchant Shipping settings API는 쇼핑용 Content API에 비해 다음과 같은 새 필드를 지원합니다.

1. 창고: 인벤토리를 저장하고 처리하는 주문 처리 창고에 대한 정보를 제공합니다.
2. 포인트 제도: Merchant API 사용자는 배송 설정에 포인트 제도 정보를 입력할 수 있습니다.
3. 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	예	아니요