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/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 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 la ressource Shipping (Paramètres de livraison) dans la sous-API Accounts :

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 modifications apportées à la ressource "Paramètres de livraison" dans la sous-API Accounts par rapport à Content API for Shopping :

  1. Les utilisateurs de l'API Merchant doivent saisir accounts/{ACCOUNT_ID}/shippingSettings dans le champ {NAME} pour obtenir le même comportement.
  2. L'API Merchant ne permet pas d'effectuer des opérations de lecture et d'écriture sur des zones personnalisées, telles que les groupes d'établissements. 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 prend en charge plusieurs pays de livraison.
  4. Contrairement à la méthode shippingsettings.list de l'API Content, l'API Merchant ne fournit pas de méthode list pour les paramètres de livraison.

Nouveaux champs acceptés

La ressource des paramètres de livraison dans la sous-API Accounts est compatible avec les nouveaux champs suivants par rapport à Content API for Shopping :

  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'UI Merchant Center.

Champs renommés

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

Content API for Shopping Ressource ShippingSettings Description
service services Un seul service de livraison
service.name services.serviceName Nom du service en texte libre, 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 livraison le jour même et 1 signifie 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 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é de 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 le même montant minimal de commande.

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 ont été supprimés de l'API Merchant. L'API Merchant ne propose 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 data sources management
Suivant
Migrate conversion sources management