השתנה המשאב 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
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.
Methods
ב-Merchant API יש גם כמה שינויים לעומת השיטות של Content API.
| Content API | Merchant API |
|---|---|
customBatch
|
ב-Merchant API, הגישה שונה. מידע נוסף על שינוי מבנה הקוד לבקשות בו-זמניות |
delete
|
delete
|
get
|
get
|
insert
|
create
|
list
|
list
|