이
ShippingSettings
드림
리소스를 사용하면 계정의 배송 설정을 검색하고 업데이트할 수 있습니다.
Google에서 일부 제품의 예상 배송 기간을 자동으로 업데이트할 수 있습니다. 자세한 내용은 자동 사용 설정 개선사항을 참고하세요.
배송 설정 읽기, 쓰기, 업데이트
판매자 API 배송 서비스를 사용하려면 다음 단계를 따르세요.
GET
요청을 실행하여 제품의 전체 배송 설정을 가져옵니다. 있습니다.- 배송 설정을 수정합니다.
- 배송비 설정을 수정한
INSERT
요청을 전송합니다.
ETag
Etag는 비동기 업데이트를 방지하기 위해 인코딩된 토큰입니다. etag는
배송 설정 데이터 변경사항 사용자는 etag를 복사해야 함
GET
요청에서 INSERT
요청 본문으로 가져옵니다.
GET
요청과 INSERT
간에 배송 설정 데이터가 변경되는 경우
다른 GET
요청을 요청하는 오류 메시지가 나타납니다.
가장 최근의 etag 토큰을 가져옵니다. GET
요청을 호출하여
새 etag 토큰을 검색하고 새 etag 토큰을 INSERT
요청에 복사
본문입니다.
배송 설정 추가
shippingsettings.insert
을(를) 사용하여 배송 설정을 추가하거나 업데이트하세요.
있습니다. 다음은 maxTransitDays
를 7로 업데이트하는 샘플 요청입니다.
배송 서비스: GSA 배송 - $49.99 이상 무료 배송(계정 아래에)
10.
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
요청에서UPDATE
요청에shippingsettings
를 복사합니다.warehouses
섹션에서 웨어하우스를 사용하려면 웨어하우스를 채웁니다. (INSERT
요청)shippingsettings
및warehouses
를 포함하는UPDATE
요청을 실행합니다. 리소스를 배포합니다
다음은 Warehouse 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
자세히 알아보기
Content API for Shopping에서 이전하는 방법에 대해 자세히 알아보려면 배송 이전을 참고하세요. 설정 관리를 참조하세요.