Esegui la migrazione della gestione delle norme sui resi online

La risorsa API Content OnlineReturnPolicy e i campi associati, inclusi ReturnPolicyPolicy e ReturnPolicySeasonalOverride, sono stati modificati.

L'equivalente dell'API Merchant della risorsa returnpolicy nell'API Content è accounts.onlineReturnPolicies.

Questa tabella spiega cosa cambia in OnlineReturnPolicy.

API Content API Merchant
"country": string "countries": [ string ]
"policy": { object (ReturnPolicyPolicy) } "policy": { object (Policy) }
"seasonalOverrides": [ { object (ReturnPolicySeasonalOverride) } ] "seasonalOverrides": [ { object (SeasonalOverride) } ],
nonFreeReturnReasons": [ string ] Questo campo non sarà più disponibile.
kind Questo campo non sarà più disponibile.
"returnShippingFee": { object (Price) } "returnShippingFee": { object (ReturnShippingFee) }

Inoltre, con l'API Merchant sono stati introdotti diversi nuovi campi.

Campo API Merchant Descrizione
"restockingFee": { object (RestockingFee) }, (Facoltativo) Il costo di ricostituzione delle scorte che si applica a tutte le categorie di motivi del reso. Se il valore non è impostato, questa commissione verrà trattata come una commissione di riassortimento senza costi.
"returnMethods": [ enum (ReturnMethod) ] (Facoltativo) I metodi di reso con cui i clienti possono restituire un articolo. Questo valore non deve essere vuoto, a meno che il tipo di norma per i resi non sia noReturns.
"itemConditions": [ enum (ItemCondition) ], (Facoltativo) Le condizioni dell'articolo accettate per i resi non devono essere vuote, a meno che il tipo di norme sui resi non sia noReturns.
"returnShippingFee": { object (ReturnShippingFee) } (Facoltativo) La tariffa di spedizione reso. Deve essere impostato solo quando il cliente deve scaricare e stampare l'etichetta per il reso.
"returnPolicyUri": string Obbligatorio. L'URI delle norme sui resi. Google utilizza questo valore per convalidare il criterio. Deve essere un URL valido.
"acceptDefectiveOnly": boolean Obbligatorio. Specifica che un commerciante accetta solo i prodotti difettosi per i resi.
"processRefundDays": integer (Facoltativo) Specifica il numero di giorni necessari ai commercianti per elaborare i rimborsi.
"acceptExchange": boolean (Facoltativo) Specifica se il commerciante consente ai clienti di cambiare i prodotti.
"returnLabelSource": enum (ReturnLabelSource) Specifica l'origine dell'etichetta di reso. Obbligatorio quando il metodo di reso è BY_MAIL.

ReturnPolicyPolicy

L'API Content ReturnPolicyPolicy diventa Policy nell'API Merchant. Ecco come sono cambiati i campi.

API Content API Merchant
"type": string, "type": enum (Type)
I valori possibili includono NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS.
"numberOfDays": string "days": string
"lastReturnDate": string Utilizza invece days. Rappresenta il numero di giorni in cui gli articoli possono essere restituiti dopo la consegna, dove un giorno è definito come 24 ore dopo il timestamp della consegna. Obbligatorio per i resi di NUMBER_OF_DAYS_AFTER_DELIVERY.

ReturnPolicySeasonalOverride

L'API Content ReturnPolicySeasonalOverride diventa SeasonalOverride nell'API Merchant. Oltre alle modifiche ai campi, il campo aggiuntivo return_window è un'unione che può essere returnDays o returnUntilDate:

  "returnDays": integer,
  "returnUntilDate": {
    object (Date)

Hanno i seguenti significati:

  • returnDays: Numero di giorni (dalla data di consegna) entro cui è ancora possibile restituire il prodotto.
  • returnUntilDate: Data di fine fissa fino alla quale è possibile restituire il prodotto.

Ecco come sono cambiati i campi.

API Content API Merchant
"name": string "label": string
"startDate": string "startDate": { object (Date) }
"endDate": string "endDate": { object (Date) }
"policy": { object (ReturnPolicyPolicy) } Utilizza invece policy.

Definizioni di altri oggetti

Per le definizioni dei nuovi oggetti dell'API Merchant

  • RestockingFee
  • ReturnMethod
  • ItemCondition
  • ReturnShippingFee
  • Type
  • ReturnLabelSource

vedi accounts.onlineReturnPolicies.

Metodi

Con l'API Merchant, sono state apportate alcune modifiche anche ai metodi dell'API Content.

API Content API Merchant
customBatch Con l'API Merchant, l'approccio è diverso. Vedi Refactor code for concurrent requests.
delete delete
get get
insert create
list list