Ресурс API контента OnlineReturnPolicy и связанные с ним поля, включая ReturnPolicyPolicy и ReturnPolicySeasonalOverride были изменены.
Эквивалентом ресурса returnpolicy в Content API для Merchant API является accounts.onlineReturnPolicies .
В этой таблице поясняются изменения в OnlineReturnPolicy .
| API контента | 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 появился ряд новых полей.
| Поле 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
В API Merchant API поле ReturnPolicyPolicy для Content API преобразуется в Policy . Вот как изменились поля.
| API контента | 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 превращается в SeasonalOverride в Merchant API. Помимо изменений в полях, дополнительное поле return_window представляет собой объединение, которое может принимать значения returnDays или returnUntilDate :
"returnDays": integer,
"returnUntilDate": {
object (Date)
Они имеют следующие значения:
-
returnDays: Количество дней (с даты доставки), в течение которых товар еще можно вернуть. -
returnUntilDate: фиксированная конечная дата, до которой товар может быть возвращен.
Вот как изменились поля.
| API контента | API торговца |
|---|---|
"name": string | "label": string |
"startDate": string | "startDate": { object (Date) } |
"endDate": string | "endDate": { object (Date) } |
"policy": { object (ReturnPolicyPolicy) } | Вместо этого используйте policy . |
Определения других объектов
Определения новых объектов API продавца
-
RestockingFee -
ReturnMethod -
ItemCondition -
ReturnShippingFee -
Type -
ReturnLabelSource
см. accounts.onlineReturnPolicies .
Методы
В Merchant API также наблюдаются некоторые изменения по сравнению с методами Content API.
| API контента | API торговца |
|---|---|
customBatch | В Mechant API используется другой подход. См. раздел «Рефакторинг кода для параллельных запросов». |
delete | delete |
get | get |
insert | create |
list | list |