Перенос управления политикой возврата товаров в режиме онлайн

Ресурс API контента OnlineReturnPolicy и связанные с ним поля, включая ReturnPolicyPolicy и ReturnPolicySeasonalOverride были изменены.

Эквивалентом ресурса returnpolicy в 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) }

Кроме того, в 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.

ВозвратПолитикаПолитика

Content API ReturnPolicyPolicy становится Policy в Merchant API. Вот как изменились поля.

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 .

ReturnPolicyСезонныйOverride

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 Merchant

• RestockingFee
• ReturnMethod
• ItemCondition
• ReturnShippingFee
• Type
• ReturnLabelSource

см. accounts.onlineReturnPolicies .

Методы

В API Merchant также есть некоторые изменения по сравнению с методами API Content.

API контента	API торговца
customBatch	С API Mechant есть другой подход. Смотрите Рефакторинг кода для параллельных запросов.
delete	delete
get	get
insert	Вместо этого используйте create или update .
list	list