La ressource OnlineReturnPolicy de l'API Content et les champs associés, y compris ReturnPolicyPolicy et ReturnPolicySeasonalOverride, ont été modifiés.
L'équivalent de la ressource returnpolicy dans l'API Content est accounts.onlineReturnPolicies dans l'API Merchant.
Ce tableau explique les modifications apportées à OnlineReturnPolicy.
| Content API | API Merchant |
|---|---|
"country": string
|
"countries": [ string ]
|
"policy": {
object (ReturnPolicyPolicy)
}
|
"policy": {
object (Policy)
}
|
"seasonalOverrides": [
{
object (ReturnPolicySeasonalOverride)
}
]
|
"seasonalOverrides": [
{
object (SeasonalOverride)
}
],
|
nonFreeReturnReasons": [ string ]
|
Ce champ disparaîtra.
|
kind
|
Ce champ disparaîtra.
|
"returnShippingFee": {
object (Price)
}
|
"returnShippingFee": {
object (ReturnShippingFee)
}
|
De plus, un certain nombre de champs sont nouveaux avec l'API Merchant.
| Champ de l'API Merchant | Description |
|---|---|
"restockingFee": {
object (RestockingFee)
},
|
Facultatif. Frais de remise en stock qui s'appliquent à toutes les catégories de motifs de retour.
Si la valeur n'est pas définie, cela sera considéré comme des frais de réapprovisionnement sans frais.
|
"returnMethods": [
enum (ReturnMethod)
]
|
Facultatif. Méthodes de retour disponibles pour les clients. Cette valeur ne doit pas être vide, sauf si le type de conditions de retour est "noReturns".
|
"itemConditions": [ enum (ItemCondition) ],
|
Facultatif. Les états des articles acceptés pour les retours ne doivent pas être vides, sauf si le type de conditions de retour est noReturns..
|
"returnShippingFee": {
object (ReturnShippingFee)
}
|
Facultatif. Frais de port de retour. Ce champ ne doit être défini que lorsque le client doit télécharger et imprimer l'étiquette de retour.
|
"returnPolicyUri": string
|
Obligatoire. URI des conditions de retour. Google utilise ce numéro pour valider la règle.
Il doit s'agir d'une URL valide.
|
"acceptDefectiveOnly": boolean
|
Obligatoire. Indique qu'un marchand n'accepte que les produits défectueux pour les retours.
|
"processRefundDays": integer
|
Facultatif. Indique le nombre de jours nécessaires aux marchands pour traiter les remboursements.
|
"acceptExchange": boolean
|
Facultatif. Indique si le marchand autorise les clients à échanger des produits. |
"returnLabelSource": enum (ReturnLabelSource)
|
Spécifie la source de l'étiquette de retour. Obligatoire lorsque la méthode de retour est BY_MAIL.
|
ReturnPolicyPolicy
L'API Content ReturnPolicyPolicy devient Policy dans l'API Merchant. Voici comment les champs ont changé.
| Content API | API Merchant |
|---|---|
"type": string,
|
"type": enum (Type)
Les valeurs possibles sont les suivantes :
NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS.
|
"numberOfDays": string
|
"days": string
|
"lastReturnDate": string
|
Utilisez days à la place. Il s'agit du nombre de jours pendant lesquels les articles peuvent être retournés après la livraison. Un jour correspond à 24 heures après l'horodatage de la livraison. Obligatoire pour les retours NUMBER_OF_DAYS_AFTER_DELIVERY.
|
ReturnPolicySeasonalOverride
L'API Content ReturnPolicySeasonalOverride devient SeasonalOverride dans l'API Merchant. En plus des modifications apportées aux champs, le champ supplémentaire return_window est une union qui peut être returnDays ou returnUntilDate :
"returnDays": integer,
"returnUntilDate": {
object (Date)
Voici leur signification :
returnDays: nombre de jours (à compter de la date de livraison) pendant lesquels le produit peut encore être retourné.returnUntilDate: date de fin fixe jusqu'à laquelle le produit peut être retourné.
Voici comment les champs ont changé.
| Content API | API Merchant |
|---|---|
"name": string
|
"label": string
|
"startDate": string
|
"startDate": {
object (Date)
}
|
"endDate": string
|
"endDate": {
object (Date)
}
|
"policy": {
object (ReturnPolicyPolicy)
}
|
Utilisez policy à la place.
|
Définitions d'autres objets
Pour obtenir la définition des nouveaux objets Merchant API
RestockingFeeReturnMethodItemConditionReturnShippingFeeTypeReturnLabelSource
Consultez accounts.onlineReturnPolicies.
Méthodes
Des modifications ont également été apportées aux méthodes de l'API Merchant par rapport à celles de Content API.
| Content API | API Merchant |
|---|---|
customBatch
|
L'approche est différente avec l'API Merchant. Consultez Refactoriser le code pour les requêtes simultanées. |
delete
|
delete
|
get
|
get
|
insert
|
create
|
list
|
list
|