Si publicas productos mediante anuncios de Shopping o fichas gratuitas, puedes usar returnpolicyonline para crear, ver, editar o borrar políticas de devoluciones en línea con los siguientes atributos:
- Países de segmentación
- Tarifas de reposición
- Métodos de retorno
- Condición del artículo de devolución
- Categoría del motivo de la devolución
- URLs de la política de devoluciones
Los productos que se venden a través de anuncios de Shopping o fichas gratuitas no requieren una dirección de devolución.
Consulta Configura tus políticas de devoluciones para los anuncios de Shopping y las fichas gratuitas a fin de obtener más detalles.
list
Puedes usar returnpolicyonline.list para enumerar todas tus políticas de devoluciones en línea existentes. Para ver una política de devoluciones específica por ID, consulta get.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline
Esta es una respuesta de ejemplo:
{
"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
Puedes usar returnpolicyonline.get para obtener una política de devoluciones específica antes del returnPolicyId. Este método muestra una sola política de devoluciones. Para ver todas tus políticas de devoluciones a la vez, consulta list.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline/returnPolicyId
Esta es una respuesta de ejemplo:
{
"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"
}
crear
Puedes usar returnpolicyonline.create para agregar una política de devoluciones nueva. La respuesta incluye la política actualizada.
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline
A continuación, se incluye una solicitud de muestra:
{
"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"
}
Esta es una respuesta de ejemplo:
{
"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
Puedes usar returnpolicyonline.patch para actualizar una política de devoluciones en línea existente antes del returnPolicyId.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline/returnPolicyId
A continuación, se incluye una solicitud de muestra:
{
"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"
}
Esta es una respuesta de ejemplo:
{
"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"
}
borrar
Puedes usar returnpolicyonline.delete para borrar una política de devoluciones en línea existente antes del returnPolicyId. Este método muestra un código 200 si la solicitud se realiza correctamente y un código 404 si la solicitud encuentra un error.
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline/returnPolicyId
A continuación, se incluye una solicitud de muestra:
{
"error": {
"code": "404",
"message": "Return policy not found.",
"status": "NOT_FOUND",
"details": [
{
"type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "notFound",
"domain": "global"
}
]
}
}