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 l'API Merchant

Voici un exemple de comparaison entre Content API for Shopping et la ressource de 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 mises à jour de la ressource de paramètres de livraison dans la sous-API Accounts 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 de liste pour les paramètres de livraison.

Nouveaux champs compatibles

La ressource de 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 à l'aide de l'API Merchant et de l'interface utilisateur Merchant Center en même temps.

Champs renommés

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

Content API for Shopping Ressource de 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 de livraison 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 minimale 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 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 de 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