Cambiaron el recurso OnlineReturnPolicy de la API de Content y los campos asociados, incluidos ReturnPolicyPolicy y ReturnPolicySeasonalOverride.
El equivalente en la API de Merchant del recurso returnpolicy en Content API es accounts.onlineReturnPolicies.
En esta tabla, se explica qué cambia en OnlineReturnPolicy.
| Content API | API de Merchant |
|---|---|
"country": string
|
"countries": [ string ]
|
"policy": {
object (ReturnPolicyPolicy)
}
|
"policy": {
object (Policy)
}
|
"seasonalOverrides": [
{
object (ReturnPolicySeasonalOverride)
}
]
|
"seasonalOverrides": [
{
object (SeasonalOverride)
}
],
|
nonFreeReturnReasons": [ string ]
|
Este campo dejará de estar disponible.
|
kind
|
Este campo dejará de estar disponible.
|
"returnShippingFee": {
object (Price)
}
|
"returnShippingFee": {
object (ReturnShippingFee)
}
|
Además, varios campos son nuevos en la API de Merchant.
| Campo de la API de Merchant | Descripción |
|---|---|
"restockingFee": {
object (RestockingFee)
},
|
Opcional. Es la tarifa de reposición que se aplica a todas las categorías de motivos de devolución.
Si no se establece el valor, se considerará que la tarifa de reposición es gratuita.
|
"returnMethods": [
enum (ReturnMethod)
]
|
Opcional. Son los métodos de devolución que pueden usar los clientes para devolver un artículo. Este valor no puede estar vacío, a menos que el tipo de política de devoluciones sea noReturns.
|
"itemConditions": [ enum (ItemCondition) ],
|
Opcional. Las condiciones del artículo aceptadas para las devoluciones no deben estar vacías, a menos que el tipo de política de devoluciones sea noReturns..
|
"returnShippingFee": {
object (ReturnShippingFee)
}
|
Opcional. Es la tarifa de envío por devolución. Se debe configurar solo cuando el cliente necesite descargar e imprimir la etiqueta de devolución.
|
"returnPolicyUri": string
|
Obligatorio. Es el URI de la política de devoluciones. Google usa esta información para validar la política.
Debe ser una URL válida.
|
"acceptDefectiveOnly": boolean
|
Obligatorio. Especifica que un comercio acepta solo productos defectuosos para devoluciones.
|
"processRefundDays": integer
|
Opcional. Especifica la cantidad de días que tardan los comercios en procesar los reembolsos.
|
"acceptExchange": boolean
|
Opcional. Especifica si el comercio permite que los clientes intercambien productos. |
"returnLabelSource": enum (ReturnLabelSource)
|
Especifica la fuente de la etiqueta de devolución. Se requiere cuando el método de devolución es BY_MAIL.
|
ReturnPolicyPolicy
La API de Content ReturnPolicyPolicy se convierte en Policy en la API de Merchant. A continuación, se muestra cómo cambiaron los campos.
| Content API | API de Merchant |
|---|---|
"type": string,
|
"type": enum (Type)
Entre los valores posibles, se incluyen los siguientes:
NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS.
|
"numberOfDays": string
|
"days": string
|
"lastReturnDate": string
|
Usa days en su lugar. Representa la cantidad de días que se pueden devolver los artículos después de la entrega, donde un día se define como 24 horas después de la marca de tiempo de entrega. Se requiere para las devoluciones de NUMBER_OF_DAYS_AFTER_DELIVERY.
|
ReturnPolicySeasonalOverride
La Content API ReturnPolicySeasonalOverride se convierte en SeasonalOverride en la Merchant API. Además de los cambios en los campos, el campo adicional return_window es una unión que puede ser returnDays o returnUntilDate:
"returnDays": integer,
"returnUntilDate": {
object (Date)
Tienen los siguientes significados:
returnDays: Es la cantidad de días (a partir de la fecha de entrega) en los que aún se puede devolver el producto.returnUntilDate: Es la fecha de finalización fija hasta la que se puede devolver el producto.
A continuación, se explica cómo cambiaron los campos.
| Content API | API de Merchant |
|---|---|
"name": string
|
"label": string
|
"startDate": string
|
"startDate": {
object (Date)
}
|
"endDate": string
|
"endDate": {
object (Date)
}
|
"policy": {
object (ReturnPolicyPolicy)
}
|
Usa policy en su lugar.
|
Definiciones de otros objetos
Definiciones de los nuevos objetos de la API de Merchant
RestockingFeeReturnMethodItemConditionReturnShippingFeeTypeReturnLabelSource
Consulta accounts.onlineReturnPolicies.
Métodos
Con la API de Merchant, también hay algunos cambios en los métodos de Content API.
| Content API | API de Merchant |
|---|---|
customBatch
|
Con la API de Merchant, se aplica un enfoque diferente. Consulta Refactoriza el código para solicitudes simultáneas. |
delete
|
delete
|
get
|
get
|
insert
|
create
|
list
|
list
|