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 en savoir plus sur l'ajout ou la gestion des paramètres de livraison de votre compte, consultez la 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/v1/accounts/{ACCOUNT_ID}/shippingSettings

Remplacez {ACCOUNT_ID} 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/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert

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

Comparaison entre Content API for Shopping et API Merchant

Voici un exemple de comparaison entre Content API for Shopping et la ressource "Paramètres de livraison" de la sous-API "Comptes" :

Content API API Merchant
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
Identifiants {MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} {NAME}

La liste suivante mentionne les principales mises à jour de la ressource "Paramètres de livraison" de la sous-API "Comptes" par rapport à Content API for Shopping :

  1. Les utilisateurs de l'API Merchant doivent placer accounts/{ACCOUNT_ID}/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 les groupes de zones géographiques. Les zones personnalisées, comme les groupes de zones géographiques, ne peuvent être lues ou écrites qu'à l'aide du service de région.
  3. Un service de l'API Merchant est compatible avec plusieurs pays de livraison.
  4. Contrairement à la méthode shippingsettings.list de Content API, l'API Merchant ne fournit pas de méthode list pour les paramètres de livraison.

Nouveaux champs compatibles

Par rapport à Content API for Shopping, la ressource "Paramètres de livraison" de la sous-API "Comptes" est compatible avec les nouveaux champs suivants :

  1. warehouses: 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 peuvent saisir des informations sur les programmes de fidélité dans leurs paramètres de livraison.
  3. Etag : Etag 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 et de l'interface utilisateur Merchant Center.

Champs renommés

Les champs suivants ont été renommés dans la ressource "Paramètres de livraison" de la sous-API "Comptes" :

Content API for Shopping Ressource "Paramètres de livraison" 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 s'applique le service de livraison.
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 pendant lesquels une commande est en transit. Par exemple, 0 signifie une livraison le jour même et 1 une livraison le lendemain.
service.deliveryTime.maxTransitTimeInDays services.deliveryTime.maxTransitDays Nombre maximal de jours ouvrés pendant lesquels une commande est en transit.
service.deliveryTime.minHandlingTimeInDays services.deliveryTime.minHandlingDays Nombre minimal de jours ouvré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 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 tarifs de livraison.
service.rate_group.subtable services.rateGroups.subtables Liste de sous-tables.
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 de la commande minimale.

Méthodes supprimées

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 supprimés

Les champs suivants de Content API for Shopping sont supprimés dans l'API Merchant. L'API Merchant ne fournit aucune alternative pour ces champs.

  • postal_code_group
  • service
    • Pickup_service
    • Eligibility
    • Scheduling_channel
    • Delivery_time
      • Holiday_cutoff

    • Rate_group
      • single_value_alternative_list

Méthodes

Voici une comparaison des méthodes de Content API for Shopping et de la ressource "Paramètres de livraison" :

Méthode Content API for Shopping API Merchant
customBatch Oui Non
get Oui Oui
update Oui Non
insert Non Oui
list Oui Non
getSupportedCarrier Oui Non
getSupportedHolidays Oui Non
Précédent
Migrate region management
Suivant
Migrate online return policy management