הגדרות החזרת מוצרים במודעות שופינג ובכרטיסי מוצר חינמיים

אם אתם מפרסמים מוצרים דרך מודעות שופינג או כרטיסי מוצר חינמיים, תוכלו להשתמש returnpolicyonline כדי ליצור, להציג, לערוך או למחוק מדיניות החזרת מוצרים אונליין באמצעות המאפיינים הבאים:

לא נדרשת החזרה של מוצרים שנמכרים דרך מודעות שופינג או כרטיסי מוצר חינמיים address.

למידע נוסף, אפשר לעיין במאמר איך להגדיר מדיניות החזרת מוצרים במודעות שופינג ובכרטיסי מוצר חינמיים דפים עסקיים לפרטים נוספים.

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. השיטה הזו הפונקציה מחזירה קוד 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"
      }
    ]
  }
}
הקודם
קונים ב-Google