אם אתם מפרסמים מוצרים דרך מודעות שופינג או כרטיסי מוצר חינמיים, תוכלו להשתמש ב-returnpolicyonline
כדי ליצור, להציג, לערוך או למחוק מדיניות החזרת מוצרים אונליין באמצעות המאפיינים הבאים:
- מדינות יעד
- עמלות החזרה למלאי
- שיטות החזרה
- מצב הפריט שהוחזר
- קטגוריית סיבת ההחזרה
- כתובות URL של מדיניות החזרת מוצרים
למוצרים שנמכרים דרך מודעות שופינג או כרטיסי מוצר חינמיים לא נדרשת כתובת להחזרת מוצרים.
מידע נוסף זמין במאמר איך מגדירים מדיניות החזרת מוצרים למודעות שופינג ולכרטיסי מוצר חינמיים.
list
אתם יכולים להשתמש ב-returnpolicyonline.list
כדי לפרט את כל כללי המדיניות הקיימים של החזרת מוצרים באינטרנט. כדי לצפות במדיניות החזרת מוצרים ספציפית לפי מזהה, ראו get
.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline
תגובה לדוגמה:
{
"returnPolicies": [
{
"returnPolicyId": "transactions:US:default",
"label": "default",
"countries": [
"GB"
],
"policy": {
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
"days": "90"
},
"restockingFee": {
"fixedFee": {
"value": "5.99",
"currency": "GBP"
}
},
"returnMethods": [
"IN_STORE",
"BY_MAIL"
],
"itemConditions": [
"NEW",
"USED"
],
"returnReasonCategoryInfo": [
{
"returnReasonCategory": "ITEM_DEFECT",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "GBP"
}
}
},
{
"returnReasonCategory": "BUYER_REMORSE",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "GBP"
}
}
}
],
"returnPolicyUri": "https://www.example.com/return-policy"
},
{
"returnPolicyId": "transactions:US:default",
"label": "default120days",
"countries": [
"US",
"FR"
],
"name": "returnpolicy120days",
"policy": {
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
"days": "90"
},
"restockingFee": {
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
},
"returnMethods": [
"BY_MAIL"
],
"itemConditions": [
"NEW",
"USED"
],
"returnReasonCategoryInfo": [
{
"returnReasonCategory": "ITEM_DEFECT",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
}
},
{
"returnReasonCategory": "BUYER_REMORSE",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
}
}
],
"returnPolicyUri": "https://www.example.com/return-policy"
}
]
}
get
אפשר להשתמש ב-returnpolicyonline.get
כדי לקבל מדיניות החזרת מוצרים ספציפית עד returnPolicyId
. השיטה הזו מחזירה מדיניות החזרת מוצרים אחת. כדי להציג את כל מדיניות החזרת המוצרים בבת אחת: list
.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline/returnPolicyId
תגובה לדוגמה:
{
"returnPolicyId": "transactions:US:default",
"label": "default",
"countries": [
"US"
],
"policy": {
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
"days": "90"
},
"restockingFee": {
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
},
"returnMethods": [
"BY_MAIL"
],
"itemConditions": [
"NEW",
"USED"
],
"returnReasonCategoryInfo": [
{
"returnReasonCategory": "ITEM_DEFECT",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
}
},
{
"returnReasonCategory": "BUYER_REMORSE",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
}
}
],
"returnPolicyUri": "https://www.example.com/return-policy"
}
create
אתם יכולים להשתמש ב-returnpolicyonline.create
כדי להוסיף מדיניות החזרת מוצרים חדשה. התשובה כוללת את המדיניות המעודכנת.
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline
הנה בקשה לדוגמה:
{
"returnPolicyId": "12345678",
"label": "default90days",
"name": "returnpolicy90days",
"policy": {
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
"days": "90"
},
"countries": [
"US"
],
"itemConditions": [
"NEW",
"USED"
],
"restockingFee": {
"fixedFee": {
"currency": "USD",
"value": "0.00"
}
},
"returnMethods": [
"BY_MAIL"
],
"returnReasonCategoryInfo": [
{
"returnReasonCategory": "ITEM_DEFECT",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
}
}
],
"returnPolicyUri": "https://www.example.com/return-policy"
}
תגובה לדוגמה:
{
"returnPolicyId": "12345678",
"label": "default90days",
"countries": [
"US"
],
"name": "returnpolicy90days",
"policy": {
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
"days": "90"
},
"restockingFee": {
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
},
"returnMethods": [
"BY_MAIL"
],
"itemConditions": [
"NEW",
"USED"
],
"returnReasonCategoryInfo": [
{
"returnReasonCategory": "ITEM_DEFECT",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
}
}
],
"returnPolicyUri": "https://www.example.com/return-policy"
}
patch
אפשר להשתמש ב-returnpolicyonline.patch
כדי לעדכן מדיניות קיימת של החזרת מוצרים אונליין עד returnPolicyId
.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline/returnPolicyId
הנה בקשה לדוגמה:
{
"returnPolicyId": "12345678",
"label": "default90days",
"countries": [
"US",
"FR"
],
"name": "returnpolicy90days",
"policy": {
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
"days": "90"
},
"restockingFee": {
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
},
"returnMethods": [
"BY_MAIL"
],
"itemConditions": [
"NEW",
"USED"
],
"returnReasonCategoryInfo": [
{
"returnReasonCategory": "ITEM_DEFECT",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
}
},
{
"returnReasonCategory": "BUYER_REMORSE",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
}
}
],
"returnPolicyUri": "https://www.example.com/return-policy"
}
תגובה לדוגמה:
{
"returnPolicyId": "12345678",
"label": "default90days",
"countries": [
"US",
"FR"
],
"name": "returnpolicy90days",
"policy": {
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
"days": "90"
},
"restockingFee": {
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
},
"returnMethods": [
"BY_MAIL"
],
"itemConditions": [
"NEW",
"USED"
],
"returnReasonCategoryInfo": [
{
"returnReasonCategory": "ITEM_DEFECT",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
}
},
{
"returnReasonCategory": "BUYER_REMORSE",
"returnLabelSource": "DOWNLOAD_AND_PRINT",
"returnShippingFee": {
"type": "FIXED",
"fixedFee": {
"value": "0.00",
"currency": "USD"
}
}
}
],
"returnPolicyUri": "https://www.example.com/return-policy"
}
delete
אפשר להשתמש ב-returnpolicyonline.delete
כדי למחוק מדיניות החזרת מוצרים קיימת אונליין עד returnPolicyId
. ה-method הזה מחזירה קוד 200
אם הבקשה מבוצעת בהצלחה, וקוד 404
אם הבקשה נתקלת בשגיאה.
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline/returnPolicyId
הנה בקשה לדוגמה:
{
"error": {
"code": "404",
"message": "Return policy not found.",
"status": "NOT_FOUND",
"details": [
{
"type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "notFound",
"domain": "global"
}
]
}
}