تم تغيير المورد OnlineReturnPolicy في Content API والحقول المرتبطة به، بما في ذلك ReturnPolicyPolicy وReturnPolicySeasonalOverride.
المورد المكافئ returnpolicy في Merchant API ضمن 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
تصبح Content API ReturnPolicyPolicy 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
يصبح Content API ReturnPolicySeasonalOverride هو 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 الجديدة
RestockingFeeReturnMethodItemConditionReturnShippingFeeTypeReturnLabelSource
راجِع
accounts.onlineReturnPolicies.
الطُرق
باستخدام Merchant API، هناك بعض التغييرات أيضًا مقارنةً بطُرق Content API.
| Content API | Merchant API |
|---|---|
customBatch
|
مع Merchant API، يتوفّر نهج مختلف. اطّلِع على إعادة تصميم الرمز البرمجي للطلبات المتزامنة. |
delete
|
delete
|
get
|
get
|
insert
|
create
|
list
|
list
|