نقل إدارة سياسة الإرجاع على الإنترنت

تم تغيير المورد OnlineReturnPolicy في Content API والحقول المرتبطة به، بما في ذلك ReturnPolicyPolicy وReturnPolicySeasonalOverride.

مكافئ Merchant API لمرجع returnpolicy في Content 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

تصبح ReturnPolicyPolicy في Content API هي Policy في Merchant API. في ما يلي كيفية تغيُّر الحقول.

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

تصبح ReturnPolicySeasonalOverride في Content API هي SeasonalOverride في Merchant API. بالإضافة إلى التغييرات في الحقول، الحقل الإضافي 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 الجديدة

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

اطّلِع على accounts.onlineReturnPolicies.

الطُرق

مع Merchant API، هناك بعض التغييرات أيضًا في طرق Content API.

Content API	Merchant API
customBatch	مع Mechant API، هناك نهج مختلف. اطّلِع على مقالة إعادة صياغة الرمز البرمجي للطلبات المتزامنة.
delete	delete
get	get
insert	استخدِم create أو update بدلاً من ذلك.
list	list