Si publicas productos a través de 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 objetivo
- Tarifas de reposición
- Métodos de devolución
- Estado del artículo devuelto
- Categoría del motivo de la devolución
- URLs de la política de devoluciones
Los productos que se venden a través de los anuncios de Shopping o las 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 para 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 por returnPolicyId
. Este método devuelve 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"
}
create
Puedes usar returnpolicyonline.create
para agregar una nueva política de devoluciones. La respuesta incluye la política actualizada.
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline
A continuación, se muestra una solicitud de ejemplo:
{
"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 con returnPolicyId
.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline/returnPolicyId
A continuación, se muestra una solicitud 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"
}
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 por medio de returnPolicyId
. Este método devuelve 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 muestra una solicitud de ejemplo:
{
"error": {
"code": "404",
"message": "Return policy not found.",
"status": "NOT_FOUND",
"details": [
{
"type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "notFound",
"domain": "global"
}
]
}
}