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

Pour lire les informations sur les paramètres de livraison à l'aide de l'API Merchant Center, 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 lire les informations sur les paramètres de livraison à l'aide de l'API Merchant Center, utilisez les requêtes suivantes:

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

Comparaison entre Content API for Shopping et Merchant API

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

	Content API	API pour les marchands
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 Merchant Shipping Settings API par rapport à Content API for Shopping:

1. Les utilisateurs de l'API Merchant Center doivent indiquer accounts/{accountId}/shippingSettings dans le champ {name} pour que le même comportement s'applique.
2. L'API Merchant Center n'est pas compatible avec les opérations de lecture et d'écriture sur les zones personnalisées, telles que les groupes d'établissements. Les zones personnalisées telles que les groupes d'établissements ne peuvent être lues ou écrites qu'à l'aide du service régional.
3. La façon de configurer WarehouseBasedDeliveryTime est différente pour Merchant API et Content API for Shopping. Si vous utilisez l'API Merchant Center, vous devez définir les informations sur l'entrepôt sous shippingsettings.warehouses. Ensuite, chaque service de livraison peut référencer l'entrepôt via son nom sous warehouseBaseDeliveryTime.
4. Un service de l'API Merchant Center est disponible dans plusieurs pays de livraison.

Nouveaux champs compatibles

Merchant Shipping Settings API accepte les nouveaux champs suivants par rapport à Content API for Shopping:

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

Champs renommés

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

Content API for Shopping	API Merchant Shipping Settings	Description
service	services	Un seul service de livraison.
service.name	services.serviceName	Nom libre du service. Il 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é par une commande lors de son acheminement. Par exemple, 0 signifie livraison le même jour et 1 signifie livraison le jour suivant.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Nombre maximal de jours ouvrés passé par une commande lors de son acheminement.
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 avant l'expédition d'une commande.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Identifiant de fuseau horaire de l'heure limite pour commander.
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 tarifs de livraison.
service.rate_group.subtable	services.rateGroups.subtables	Liste de sous-tableaux.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Liste des tarifs de transporteurs.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Liste de jeux de codes de magasin partageant le même montant minimal 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 sont obsolètes dans l'API Merchant Center. Notez que Merchant API ne propose pas d'alternatives pour ces champs.

Content API for Shopping	API pour les marchands
postal_code_group	region
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 |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 pour Shopping et de Merchant Shipping Settings API: Méthode Content API for Shopping API pour les marchands customBatch Oui Non get Oui Oui update Oui Non insert Non Oui getSupportedCarrier Oui Non getSupportedHolidays Oui Non