shippingsettings 리소스를 사용하면 계정의 배송 설정을 검색하고 업데이트할 수 있습니다.
일부 제품의 경우 Google에서 예상 배송 기간을 자동으로 업데이트할 수 있습니다. 자세한 내용은 자동 개선 사용 설정을 참고하세요.
배송 설정 읽기, 쓰기 또는 업데이트
판매자 API 배송 서비스를 사용하려면 다음 단계를 따르세요.
GET요청을 실행하여 계정의 전체 배송 설정을 가져옵니다.- 배송 설정을 수정합니다.
- 수정된 배송 설정으로
INSERT요청을 전송합니다.
ETag
Etag는 비동기 업데이트를 방지하기 위해 인코딩된 토큰입니다. etag는 배송 설정 데이터가 변경되면 변경됩니다. 사용자는 GET 요청에서 가져온 etag를 INSERT 요청 본문에 복사해야 합니다.
GET 요청과 INSERT 요청 간에 배송 설정 데이터가 변경되면 가장 최근의 etag 토큰을 가져오도록 다른 GET 요청을 하는 오류 메시지가 표시됩니다. GET 요청을 호출하여 새 etag 토큰을 가져오고 새 etag 토큰을 INSERT 요청 본문에 복사해야 합니다.
배송 설정 추가
계정의 배송 설정을 추가하거나 업데이트하려면 shippingsettings.insert를 사용합니다. 다음은 계정 10에서 GSA 배송 - 무료 배송 $49.99 이상이라는 배송 서비스의 maxTransitDays를 7로 업데이트하는 샘플 요청입니다.
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings/
{
"services": [
{
"name": "FedEx",
"active": true,
"deliveryCountries": ["US"],
"currencyCode": "USD",
"deliveryTime": {
"minTransitDays": 4,
"maxTransitDays": 6,
"minHandlingDays": 0,
"maxHandlingDays": 0
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"amountMicros": 5990000,
"currencyCode": "USD"
}
},
"name": "All products"
}
]
},
{
"name": "GSA Shipping - Free Ship Over $49.99",
"active": true,
"deliveryCountries": "US",
"currencyCode": "USD",
"deliveryTime": {
"minTransitDays": 3,
"maxTransitDays": 7,
"minHandlingDays": 1,
"maxHandlingDays": 2
},
"rateGroups": [
{
"mainTable": {
"rowHeaders": {
"prices": [
{
"amountMicros": 49990000,
"currencyCode": "USD"
},
{
"amountMicros": -1,
"currencyCode": "USD"
}
]
},
"rows": [
{
"cells": [
{
"flatRate": {
"amountMicros": 6990000,
"currencyCode": "USD"
}
}
]
},
{
"cells": [
{
"flatRate": {
"amountMicros": 0,
"currencyCode": "USD"
}
}
]
}
]
},
"name": "Free Ship Over $49.99"
}
]
}
]
}
웨어하우스 설정
다음 JSON 샘플은 판매자 배송 설정 서비스를 사용하여 판매자 계정의 창고 정보를 관리하는 방법을 보여줍니다.
"warehouses": [
{
"name": "warehouse 1",
"shippingAddress": {
"streetAddress": {street_address},
"city": {city},
"administrativeArea": {administrative_area},
"postalCode": {postal_code},
"regionCode": {region_code}
},
"cutoffTime": {
"minutes": {minutes}
},
"handlingDays": {handling_days},
"businessDaysConfig": {
"businessDays": [
"MONDAY", "SUNDAY"
]
}
}
]
다음을 바꿉니다.
- {street_address}: 창고 주소의 거리 수준 부분입니다.
- {city}: 창고가 위치한 시/군/구 또는 구/군입니다.
- {administrative_area}: 국가의 행정 구역 단위입니다. 예: 주
- {postal_code}: 우편번호입니다.
- {region_code}: 문자열의 국가 코드입니다.
- {minutes}: 창고에서 당일에 주문을 처리하기 위해 주문해야 하는 마감 시간(분)입니다.
- {handling_days}: 이 창고에서 상품을 포장하고 배송하는 데 걸리는 일 수입니다.
warehouses 리소스는 웨어하우스 목록입니다. warehouse.name를 통해 배송 서비스의 창고 기반 배송 시간을 통해 각 창고를 참조할 수 있습니다.
창고 관리
판매자 API를 사용하여 창고를 관리하는 방법은 다음과 같습니다.
GET요청을 실행하여 기존shippingsettings및 웨어하우스를 모두 검색합니다.GET요청의shippingsettings를UPDATE요청에 복사합니다.INSERT요청의warehouses섹션에서 웨어하우스를 사용하려면 웨어하우스를 채웁니다.shippingsettings및warehouses리소스가 포함된UPDATE요청을 실행합니다.
다음은 뉴욕에서 마운틴 뷰로 업데이트된 웨어하우스 1의 웨어하우스가 포함된 INSERT 요청 본문 샘플입니다.
{
"services": [
{
"name": "Standard Shipping",
"active": true,
"deliveryCountries": ["US", "UK"],
"currencyCode": "USD",
"deliveryTime": {
"minHandlingDays": 0,
"maxHandlingDays": 1,
"warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
"carrierService": "ground"
"warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
"carrierService": "2 days"
"warehouse": "Warehouse 2"
}
]
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"amountMicros": 0,
"currencyCode": "USD"
}
},
"name": "Standard Shipping"
}
],
},
{
"name": "Expedited",
"flatRate": {
"amountMicros": 9990000,
"currencyCode": "USD"
}
},
"name": "Expedited"
}
],
}
],
"warehouses": [
{
"name": "Warehouse1",
"shippingAddress": [
{
"streetAddress": "1111 shoreline street"
"city": "Mountain View",
"administrativeArea": "CA"
}
]
},
{
"name": "Warehouse 2",
"country": "US",
"postalCodeRanges": [
{
"streetAddress": "1111 5th avenue"
"city": "New York",
"administrativeArea": "NY"
}
]
}
]
}
당일 배송 추가
오프라인 판매점 인벤토리가 있는 경우 Content API for Shopping을 사용하여 당일 배송 서비스를 구성할 수 있습니다. 당일 배송 서비스의 경우 shipment_type가 local_delivery입니다. 현재 모든 local_delivery 배송 서비스는
당일 배송으로 간주됩니다.
지역 배송의 delivery_time 정보는 변경할 수 없습니다. shippingsettings.insert를 사용하여
오프라인 판매점 인벤토리 제품에 당일 배송을
설정하세요.
다음은 계정의 모든 매장에 당일 배송 서비스를 추가하는 요청 본문의 예입니다.
{
"name": "accounts/accountId/shippingSettings",
"services": [
{
"name": "Local Delivery",
"active": true,
"shipmentType": "local_delivery",
"deliveryCountries": "US",
"currencyCode": "USD",
"rateGroups": [
{
"singleValue": {
"flatRate": {
"amountMicros": 0,
"currencyCode": "USD"
}
}
}
],
"storeConfig": {
"storeServiceType": "all stores",
"storeCodes": [],
"cutoffConfig": {
"storeCloseOffsetHours": 2,
"noDeliveryPostCutoff": true
},
"serviceRadius": {
"value": 4,
"unit": "Miles"
}
}
}
]
}
익일 배송 추가
당일 배송 마감 시간 이후에 이루어진 주문은 기본적으로 다음날 배송으로 예약됩니다. 다음날 배송을 중지하려면 no_delivery_post_cutoff 필드를 true로 설정합니다. 다음날 배송을 사용 중지하면 매일 마감 시간 전에만 배송 서비스가 표시됩니다.
shipment_type이(가) local_delivery인 경우에만 다음 날 배송이 가능합니다.