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

판매자 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의 주요 업데이트를 언급합니다.

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

새로운 지원 필드

판매자 배송 설정 API는 Content API for Shopping과 비교하여 다음과 같은 새로운 필드를 지원합니다.

1. 웨어하우스: 인벤토리를 저장하고 처리하는 처리 웨어하우스에 관한 정보를 제공합니다.
2. 포인트 제도: 판매자 API 사용자는 배송 설정에 포인트 제도 정보를 입력할 수 있습니다.
3. 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 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 |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 판매자 API customBatch 예 아니요 get 예 예 update 예 아니요 insert 아니요 예 getSupportedCarrier 예 아니요 getSupportedHolidays 예 아니요