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

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

Pour lire les informations sur les paramètres de livraison à l'aide de l'API Merchant Center, utilisez le code suivant : requêtes:

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

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

Pour lire les informations sur les paramètres de livraison à l'aide de l'API Merchant Center, utilisez le code suivant : requêtes:

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

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

Comparaison entre Content API for Shopping et Merchant API

Voici un exemple de comparaison entre Content API for Shopping et le compte Merchant Center API Shipping Settings:

	Content API	API Merchant Center
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 Center doivent indiquer accounts/{accountId}/shippingSettings dans la {name} pour obtenir le même comportement.
2. L'API pour les marchands n'accepte pas les opérations de lecture et d'écriture sur les zones personnalisées, telles que en tant que groupes de zones géographiques. Les zones personnalisées, telles que les groupes de zones géographiques, ne peuvent être lues ou écrit à l'aide du service régional.
3. La façon de configurer WarehouseBasedDeliveryTime est différente pour Merchant API et Content API pour Shopping. Si vous utilisez l'API Merchant Center, vous devez définir les informations sur l'entrepôt sous shippingsettings.warehouses Chaque service de livraison peut alors faire référence l'entrepôt via le nom de l'entrepôt sous warehouseBaseDeliveryTime.
4. Un service de l'API Merchant Center accepte plusieurs pays de livraison.

Nouveaux champs acceptés

L'API Merchant Shipping Settings accepte 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 Center peuvent saisir des informations sur les programmes de fidélité pour leurs paramètres de livraison.
3. ETag: ETag est conçu pour résoudre les problèmes asynchrones lorsque différents utilisateurs tentent de modifiez les paramètres de livraison à l'aide de l'API Merchant Center et de l'UI Merchant Center en même temps.

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, 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 pendant lesquels une commande est passée dans l'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 pendant lesquels une commande est passée dans l'acheminement.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Nombre minimal de jours ouvrés dépensés avant l'expédition d'une commande.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Nombre maximal de jours ouvrés dépensé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	Étiquette 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 d'ensembles 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 demande

Champs obsolètes

Les champs suivants de Content API sont obsolètes dans Merchant API. Marchand L'API ne fournit pas d'alternative à 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

Vous trouverez ci-dessous une comparaison des méthodes disponibles dans Content API for Shopping et dans les API Merchant Shipping Settings:

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