Migrer les paramètres de livraison depuis Content API for Shopping

La ressource ShippingSettings vous permet de récupérer et de mettre à jour les paramètres de livraison de votre compte et de tous les sous-comptes qui lui sont associés. Pour savoir comment ajouter ou gérer les paramètres de livraison de votre compte, consultez Présentation des paramètres de livraison.

Pour utiliser l'API Merchant afin de lire les informations sur les paramètres de livraison, utilisez les requêtes suivantes:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings

Remplacez {accountId} par l'identifiant unique de votre compte Merchant Center.

Pour utiliser l'API Merchant afin de mettre à jour les informations sur les paramètres de livraison, utilisez les requêtes suivantes:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert

Pour en savoir plus, consultez Méthode : accounts.shippingSettings.insert.

Comparaison entre Content API for Shopping et l'API Merchant

Voici un exemple de comparaison entre Content API for Shopping et l'API Merchant Shipping Settings:

	Content API	API Merchant
URL	https://shoppingcontent.googleapis.com/content/v2.1/{accountId}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Identifiants	{accountId}/shippingsettings/{accountId}	{name}

La liste suivante mentionne les principales mises à jour de l'API Merchant Shipping settings par rapport à Content API for Shopping:

1. Les utilisateurs de l'API Merchant doivent mettre accounts/{accountId}/shippingSettings dans le champ {name} pour obtenir le même comportement.
2. L'API Merchant n'est pas compatible avec les opérations de lecture et d'écriture sur des zones personnalisées, telles que des groupes d'établissements. Les zones personnalisées telles que les groupes de zones géographiques ne peuvent être lues ou écrites qu'à l'aide du service de région.
3. La méthode de configuration de WarehouseBasedDeliveryTime est différente pour l'API Merchant par rapport à Content API for Shopping. Si vous utilisez l'API Merchant, vous devez définir les informations sur l'entrepôt sous shippingsettings.warehouses. Chaque service de livraison peut ensuite faire référence à l'entrepôt via le nom de l'entrepôt sous warehouseBaseDeliveryTime.
4. Un service de l'API Merchant est compatible avec plusieurs pays de livraison.

Nouveaux champs compatibles

L'API Merchant Shipping settings est compatible avec les nouveaux champs suivants par rapport à Content API for Shopping:

1. Entrepôts: fournit des informations sur un entrepôt de traitement, qui stocke et gère l'inventaire.
2. Programmes de fidélité: les utilisateurs de l'API Merchant peuvent saisir des informations sur les programmes de fidélité dans leurs paramètres de livraison.
3. Etag: l'Etag est conçu pour résoudre les problèmes asynchrones lorsque différents utilisateurs tentent de modifier les paramètres de livraison à l'aide de l'API Merchant et de l'interface utilisateur de Merchant Center en même temps.

Champs renommés

Les champs suivants ont été renommés dans l'API Merchant:

Content API for Shopping	API Merchant Shipping settings	Description
service	services	Un seul service de livraison.
service.name	services.serviceName	Nom libre du service, qui doit être unique dans votre compte Merchant Center.
service.deliveryCountry	services.deliveryCountries	Code CLDR du pays auquel le service de livraison s'applique.
service.currency	services.currencyCode	Code CLDR de la devise à laquelle ce service s'applique.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Nombre minimal de jours ouvrés passés en acheminement par une commande. Par exemple, 0 signifie livraison le jour même et 1 livraison le lendemain.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Nombre maximal de jours ouvrés passés en acheminement par une commande.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Nombre minimal de jours ouvrés passés avant l'expédition d'une commande.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Nombre maximal de jours ouvrés passés avant l'expédition d'une commande.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Identifiant du fuseau horaire de l'heure limite.
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	Nom du groupe de codes postaux.
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	Libellé du délai d'acheminement du produit.
service.rate_group	services.rateGroups	Définitions des groupes de frais de port.
service.rate_group.subtable	services.rateGroups.subtables	Liste de sous-tableaux.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Liste des tarifs des transporteurs.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Liste des ensembles de codes de magasin partageant la même valeur minimale de commande.

Méthodes obsolètes

Vous ne pouvez pas utiliser shippingsettings.custombatch pour récupérer et mettre à jour les paramètres de livraison de plusieurs comptes en une seule requête.

Champs obsolètes

Les champs suivants de Content API sont obsolètes dans Merchant API. L'API Merchant ne propose aucune alternative pour ces champs.

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Min_scheduling_time_in_days
• Max_scheduling_time_in_days
• Scheduling_business_day_config
• Rate_group
  • single_value_alternative_list

Méthodes

Voici une comparaison des méthodes de Content API for Shopping et de l'API Merchant Shipping settings:

Méthode	Content API for Shopping	API Merchant
customBatch	Oui	Non
get	Oui	Oui
update	Oui	Non
insert	Non	Oui
getSupportedCarrier	Oui	Non
getSupportedHolidays	Oui	Non