Content API 리소스 OnlineReturnPolicy 및 ReturnPolicyPolicy, ReturnPolicySeasonalOverride를 비롯한 관련 필드가 변경되었습니다.
Content API의 returnpolicy 리소스에 해당하는 Merchant API는 accounts.onlineReturnPolicies입니다.
이 표에서는 OnlineReturnPolicy의 변경사항을 설명합니다.
| Content API | Merchant API |
|---|---|
"country": string
|
"countries": [ string ]
|
"policy": {
object (ReturnPolicyPolicy)
}
|
"policy": {
object (Policy)
}
|
"seasonalOverrides": [
{
object (ReturnPolicySeasonalOverride)
}
]
|
"seasonalOverrides": [
{
object (SeasonalOverride)
}
],
|
nonFreeReturnReasons": [ string ]
|
이 필드는 사라집니다.
|
kind
|
이 필드는 사라집니다.
|
"returnShippingFee": {
object (Price)
}
|
"returnShippingFee": {
object (ReturnShippingFee)
}
|
또한 Merchant API에는 여러 필드가 새로 추가되었습니다.
| Merchant API 필드 | 설명 |
|---|---|
"restockingFee": {
object (RestockingFee)
},
|
선택사항입니다. 모든 반품 사유 카테고리에 적용되는 재입고 수수료입니다.
값이 설정되지 않은 경우 무료 재입고 수수료로 처리됩니다.
|
"returnMethods": [
enum (ReturnMethod)
]
|
선택사항입니다. 고객이 상품을 반품할 수 있는 반품 방법입니다. 반품 정책 유형이 noReturns가 아닌 경우 이 값은 비워둘 수 없습니다.
|
"itemConditions": [ enum (ItemCondition) ],
|
선택사항입니다. 반품에 허용되는 상품 상태는 반품 정책 유형이 noReturns.이 아닌 한 비어 있으면 안 됩니다.
|
"returnShippingFee": {
object (ReturnShippingFee)
}
|
선택사항입니다. 반품 배송비입니다. 고객이 반품 라벨을 다운로드하여 인쇄해야 하는 경우에만 설정해야 합니다.
|
"returnPolicyUri": string
|
필수 항목입니다. 반품 정책 URI입니다. Google은 이를 사용하여 정책을 검증합니다.
유효한 URL이어야 합니다.
|
"acceptDefectiveOnly": boolean
|
필수 항목입니다. 판매자가 결함이 있는 제품만 반품으로 허용함을 지정합니다.
|
"processRefundDays": integer
|
선택사항입니다. 판매자가 환불을 처리하는 데 걸리는 일수를 지정합니다.
|
"acceptExchange": boolean
|
선택사항입니다. 판매자가 고객의 제품 교환을 허용하는지 여부를 지정합니다. |
"returnLabelSource": enum (ReturnLabelSource)
|
반품 라벨 소스를 지정합니다. 반환 방법이 BY_MAIL인 경우 필수입니다.
|
ReturnPolicyPolicy
Content API ReturnPolicyPolicy이 Merchant API에서 Policy이 됩니다. 필드가 변경된 방식은 다음과 같습니다.
| Content API | Merchant API |
|---|---|
"type": string,
|
"type": enum (Type)
가능한 값은 다음과 같습니다.
NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS.
|
"numberOfDays": string
|
"days": string
|
"lastReturnDate": string
|
대신 days를 사용하세요. 배송 후 상품을 반품할 수 있는 일수를 나타냅니다. 여기서 하루는 배송 타임스탬프 후 24시간으로 정의됩니다. NUMBER_OF_DAYS_AFTER_DELIVERY 반품에 필요합니다.
|
ReturnPolicySeasonalOverride
Content API ReturnPolicySeasonalOverride가 Merchant API에서 SeasonalOverride이 됩니다. 필드 변경사항 외에도 추가 필드 return_window는 returnDays 또는 returnUntilDate일 수 있는 유니온입니다.
"returnDays": integer,
"returnUntilDate": {
object (Date)
각각의 의미는 다음과 같습니다.
returnDays: 제품을 반품할 수 있는 배송일로부터의 일수입니다.returnUntilDate: 제품을 반품할 수 있는 고정된 종료일입니다.
필드가 변경된 방식은 다음과 같습니다.
| Content API | Merchant API |
|---|---|
"name": string
|
"label": string
|
"startDate": string
|
"startDate": {
object (Date)
}
|
"endDate": string
|
"endDate": {
object (Date)
}
|
"policy": {
object (ReturnPolicyPolicy)
}
|
대신 policy를 사용하세요.
|
기타 객체 정의
새 Merchant API 객체의 정의
RestockingFeeReturnMethodItemConditionReturnShippingFeeTypeReturnLabelSource
accounts.onlineReturnPolicies을 참고하세요.
메서드
Merchant API에는 Content API 메서드와 다른 변경사항도 있습니다.
| Content API | Merchant API |
|---|---|
customBatch
|
Merchant API를 사용하면 다른 접근 방식을 취할 수 있습니다. 동시 요청을 위한 코드 리팩터링을 참고하세요. |
delete
|
delete
|
get
|
get
|
insert
|
create
|
list
|
list
|