مدیریت سیاست بازگشت آنلاین مهاجرت
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
منبع Content API OnlineReturnPolicy و فیلدهای مرتبط از جمله 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
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 در 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 جدید
-
RestockingFee -
ReturnMethod -
ItemCondition -
ReturnShippingFee -
Type -
ReturnLabelSource
به accounts.onlineReturnPolicies مراجعه کنید.
روش ها
با Merchant API، تغییراتی در روش‌های Content API نیز وجود دارد.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Migrate online return policy management\n\nThe Content API resource `OnlineReturnPolicy` and associated fields including\n`ReturnPolicyPolicy` and `ReturnPolicySeasonalOverride` have changed.\n\nThe Merchant API equivalent of the\n[`returnpolicy`](/shopping-content/reference/rest/v2.1/returnpolicy) resource in\nContent API is\n[`accounts.onlineReturnPolicies`](/merchant/api/reference/rest/accounts_v1/accounts.onlineReturnPolicies).\n\nThis table explains what changes in `OnlineReturnPolicy`.\n\n| Content API | Merchant API |\n|------------------------------------------------------------------------|-------------------------------------------------------------|\n| ` \"country\": string ` | ` \"countries\": [ string ] ` |\n| ` \"policy\": { object (ReturnPolicyPolicy) } ` | ` \"policy\": { object (Policy) } ` |\n| ` \"seasonalOverrides\": [ { object (ReturnPolicySeasonalOverride) } ] ` | ` \"seasonalOverrides\": [ { object (SeasonalOverride) } ], ` |\n| ` nonFreeReturnReasons\": [ string ] ` | This field goes away.` ` |\n| `kind ` | This field goes away.` ` |\n| ` \"returnShippingFee\": { object (Price) } ` | ` \"returnShippingFee\": { object (ReturnShippingFee) } ` |\n\nIn addition, a number of fields are new with Merchant API.\n\n| Merchant API field | Description |\n|---------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` \"restockingFee\": { object (RestockingFee) }, ` | Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set. ` ` |\n| ` \"returnMethods\": [ enum (ReturnMethod) ] ` | Optional. The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns. ` ` |\n| ` \"itemConditions\": [ enum (ItemCondition) ], ` | Optional. The item conditions accepted for returns must not be empty unless the type of return policy is `noReturns.` |\n| ` \"returnShippingFee\": { object (ReturnShippingFee) } ` | Optional. The return shipping fee. Should be set only when customer need to download and print the return label. ` ` |\n| ` \"returnPolicyUri\": string ` | Required. The return policy URI. Google uses this to validate the policy. It must be a valid URL. ` ` |\n| ` \"acceptDefectiveOnly\": boolean ` | Required. Specifies that a merchant accepts only defective products for returns. ` ` |\n| ` \"processRefundDays\": integer ` | Optional. Specifies the number of days it takes for merchants to process refunds. ` ` |\n| ` \"acceptExchange\": boolean ` | Optional. Specifies whether the merchant allows customers to exchange products. |\n| ` \"returnLabelSource\": enum (ReturnLabelSource) ` | Specifies the return label source. Required when return method is BY_MAIL. ` ` |\n\nReturnPolicyPolicy\n------------------\n\nThe Content API `ReturnPolicyPolicy` becomes `Policy` in Merchant API. Here's\nhow the fields have changed.\n\n| Content API | Merchant API |\n|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` \"type\": string, ` | ` \"type\": enum (Type) ` Possible values include ` NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS. ` |\n| ` \"numberOfDays\": string ` | ` \"days\": string ` |\n| ` \"lastReturnDate\": string ` | Use `days` instead. It represents the number of days items can be returned after delivery, where one day is defined as 24 hours after the delivery timestamp. Required for `NUMBER_OF_DAYS_AFTER_DELIVERY` returns. |\n\nReturnPolicySeasonalOverride\n----------------------------\n\nThe Content API `ReturnPolicySeasonalOverride` becomes `SeasonalOverride` in\nMerchant API. In addition to the changes in fields, the additional field\n`return_window` is a union that can be either `returnDays` or `returnUntilDate`: \n\n \"returnDays\": integer,\n \"returnUntilDate\": {\n object (Date)\n\nThey have the following meanings:\n\n- `returnDays`: Number of days (from the delivery date) that the product can still be returned.\n- `returnUntilDate`: Fixed end date until which the product can be returned.\n\nHere's how the fields have changed.\n\n| Content API | Merchant API |\n|-----------------------------------------------|------------------------------------|\n| ` \"name\": string ` | ` \"label\": string ` |\n| ` \"startDate\": string ` | ` \"startDate\": { object (Date) } ` |\n| ` \"endDate\": string ` | ` \"endDate\": { object (Date) } ` |\n| ` \"policy\": { object (ReturnPolicyPolicy) } ` | Use `policy` instead. |\n\nDefinitions of other objects\n----------------------------\n\nFor definitions of the new Merchant API objects\n\n- `RestockingFee`\n- `ReturnMethod`\n- `ItemCondition`\n- `ReturnShippingFee`\n- `Type`\n- `ReturnLabelSource`\n\nsee\n[`accounts.onlineReturnPolicies`](/merchant/api/reference/rest/accounts_v1/accounts.onlineReturnPolicies).\n\nMethods\n-------\n\nWith Merchant API, there are some changes from the Content API methods as well.\n\n| Content API | Merchant API |\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` customBatch ` | With Mechant API, there is a different approach. See [Refactor code for concurrent requests.](/merchant/api/guides/compatibility/refactor-concurrent-requests) |\n| ` delete ` | ` delete ` |\n| ` get ` | ` get ` |\n| ` insert ` | `create` |\n| ` list ` | ` list ` |"]]
