O recurso OnlineReturnPolicy da API Content e os campos associados, incluindo
ReturnPolicyPolicy e ReturnPolicySeasonalOverride, mudaram.
O equivalente da API Merchant do recurso returnpolicy na API Content é accounts.onlineReturnPolicies.
Esta tabela explica o que muda em OnlineReturnPolicy.
| API Content | API Merchant |
|---|---|
"country": string
|
"countries": [ string ]
|
"policy": {
object (ReturnPolicyPolicy)
}
|
"policy": {
object (Policy)
}
|
"seasonalOverrides": [
{
object (ReturnPolicySeasonalOverride)
}
]
|
"seasonalOverrides": [
{
object (SeasonalOverride)
}
],
|
nonFreeReturnReasons": [ string ]
|
Esse campo vai desaparecer.
|
kind
|
Esse campo vai desaparecer.
|
"returnShippingFee": {
object (Price)
}
|
"returnShippingFee": {
object (ReturnShippingFee)
}
|
Além disso, vários campos são novos na API Merchant.
| Campo da API Merchant | Descrição |
|---|---|
"restockingFee": {
object (RestockingFee)
},
|
Opcional. A taxa de reposição que se aplica a todas as categorias de motivo da devolução.
Se o valor não for definido, isso será tratado como uma taxa de reposição sem custo financeiro.
|
"returnMethods": [
enum (ReturnMethod)
]
|
Opcional. Os métodos de devolução que os clientes podem usar para devolver um item. Esse valor não pode estar vazio, a menos que o tipo de política de devolução seja "noReturns".
|
"itemConditions": [ enum (ItemCondition) ],
|
Opcional. As condições do item aceitas para devoluções não podem estar vazias, a menos que
o tipo de política de devolução seja noReturns.
|
"returnShippingFee": {
object (ReturnShippingFee)
}
|
Opcional. A tarifa de frete de devolução. Só deve ser definido quando o cliente precisar
fazer o download e imprimir a etiqueta de devolução.
|
"returnPolicyUri": string
|
Obrigatório. O URI da política de devolução. O Google usa isso para validar a política.
Precisa ser um URL válido.
|
"acceptDefectiveOnly": boolean
|
Obrigatório. Especifica que um comerciante aceita apenas produtos com defeito para devoluções.
|
"processRefundDays": integer
|
Opcional. Especifica o número de dias que os comerciantes levam para processar reembolsos.
|
"acceptExchange": boolean
|
Opcional. Especifica se o comerciante permite que os clientes troquem produtos. |
"returnLabelSource": enum (ReturnLabelSource)
|
Especifica a origem do rótulo de devolução. Obrigatório quando o método de devolução é BY_MAIL.
|
ReturnPolicyPolicy
A API Content ReturnPolicyPolicy passa a ser Policy na API Merchant. Veja como os campos mudaram.
| API Content | API Merchant |
|---|---|
"type": string,
|
"type": enum (Type)
Os valores possíveis incluem
NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS.
|
"numberOfDays": string
|
"days": string
|
"lastReturnDate": string
|
Use days. Ele representa o número de dias em que os itens podem ser devolvidos após a entrega. Um dia é definido como 24 horas após o carimbo de data/hora da entrega. Obrigatório para devoluções de NUMBER_OF_DAYS_AFTER_DELIVERY.
|
ReturnPolicySeasonalOverride
A API Content ReturnPolicySeasonalOverride passa a ser SeasonalOverride na
API Merchant. Além das mudanças nos campos, o campo adicional return_window é uma união que pode ser returnDays ou returnUntilDate:
"returnDays": integer,
"returnUntilDate": {
object (Date)
Elas têm os seguintes significados:
returnDays: número de dias (a partir da data de entrega) em que o produto ainda pode ser devolvido.returnUntilDate: data de término fixa até quando o produto pode ser devolvido.
Confira como os campos mudaram.
| API Content | API Merchant |
|---|---|
"name": string
|
"label": string
|
"startDate": string
|
"startDate": {
object (Date)
}
|
"endDate": string
|
"endDate": {
object (Date)
}
|
"policy": {
object (ReturnPolicyPolicy)
}
|
Use policy.
|
Definições de outros objetos
Para definições dos novos objetos da API Merchant
RestockingFeeReturnMethodItemConditionReturnShippingFeeTypeReturnLabelSource
Consulte
accounts.onlineReturnPolicies.
Métodos
Com a API Merchant, também há algumas mudanças nos métodos da API Content.
| API Content | API Merchant |
|---|---|
customBatch
|
Com a API Merchant, a abordagem é diferente. Consulte Refatorar o código para solicitações simultâneas. |
delete
|
delete
|
get
|
get
|
insert
|
create
|
list
|
list
|