Compatibilité avec Content API for Shopping

Vous pouvez utiliser ce guide pour intégrer l'API Merchant à votre implémentation existante de Content API for Shopping.

Commencer

Pour en savoir plus sur les attributs, consultez la page Conception de l'API pour les marchands. l'API Merchant Center et ses sous-API.

Pour commencer à utiliser l'API Merchant Center, remplacez les URL de vos requêtes par les suivantes : format:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…

Consultez le guide de démarrage rapide et consultez la documentation de référence de l'API Merchant pour en savoir plus.

Compatibilité avec gRPC

L'API Merchant est compatible avec gRPC et REST. Vous pouvez utiliser de gRPC pour l'API Merchant et de REST pour Content API for Shopping, en temps réel.

Les bibliothèques clientes de l'API Merchant nécessitent gRPC.

Pour en savoir plus, consultez la page Utiliser gRPC. des informations.

Compatibilité

Ce guide décrit les modifications générales qui s'appliquent à l'ensemble de l'API pour les marchands. Voir consultez les guides suivants pour en savoir plus sur les modifications apportées à des fonctionnalités spécifiques:

• Migrer la gestion des comptes
• Migrer les paramètres de livraison
• Migrer la gestion des produits
• Gestion de la migration des sources de données
• Migrer la gestion des inventaires
• Migrer la gestion des promotions
• Migrer la gestion des rapports
• Migrer la gestion des sources de conversion
• Migrer la gestion des partenariats pour les flux en magasin

L'API pour les marchands est conçue pour fonctionner avec Content API for Shopping existante. de la version 2.1.

Par exemple, vous pouvez utiliser l'API Merchant Inventories en plus de vos les inventaires et la version 2.1 de Content API for Shopping Implémentation de products. Toi peuvent utiliser Content API for Shopping pour importer un nouveau magasin produit (que vous vendez dans un magasin local), puis utiliser l'API Merchant Inventories LocalInventory ressource pour gérer les informations en magasin pour ce produit.

Remarque :Nous ne pouvons pas garantir une rétrocompatibilité totale pour des fonctionnalités similaires. entre l'API Content pour Shopping et l'API Merchant Center grâce aux améliorations design. Par exemple, les noms de champs ou la disponibilité des méthodes peuvent différer pour une même ressource dans Content API for Shopping et dans la section API Merchant Center

.

Requêtes par lot

L'API Merchant Center n'est pas compatible avec la méthode customBatch présentée dans le Content API for Shopping. Consultez plutôt la section Envoyer un e-mail par lot requêtes. Si vous utilisez customBatch et avez besoin de cette fonctionnalité pour l'API Merchant Center, expliquez-nous pourquoi dans votre commentaires.

Identifiants

Pour nous aligner sur les principes d'amélioration des API de Google, nous avons nous avons apporté quelques modifications aux identifiants des ressources de l'API Merchant Center.

remplace "Id"

Toutes les ressources de l'API Merchant utilisent le champ name comme identifiant unique.

Voici un exemple d'utilisation du champ name dans vos appels:

POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert

Ce nouveau champ name est renvoyé en tant qu'identifiant de ressource pour toutes les ressources lues et écrire des appels dans l'API Merchant Center.

La valeur renvoyée dans les champs name utilise le nouveau format d'ID.

Important :Nous vous recommandons d'utiliser la valeur du champ name directement dans votre au lieu d'analyser ou de construire manuellement le nom d'une ressource pour éviter en cas de problème.

Par exemple, implémentez une méthode getName() pour récupérer le name à partir d'un ressource et stocker la sortie en tant que variable au lieu de créer l'name à partir de l'ID du marchand et de l'ID de ressource.

Nouveau format d'ID

Remarque :L'API Merchant renvoie les ID sans valeur channel jusqu'en novembre 13 février 2023. Après le 13 novembre, tous les appels renverront l'ID complet de la ressource. Toi devez utiliser l'ID de ressource complet, y compris channel, dans vos appels d'ici le 1er février ; 2024.

Dans l'API Merchant Center, les ID de ressource sont au format suivant: channel~language~feedLabel~offerId

Les ressources Content API ont utilisé : au lieu de ~ entre chaque valeur de l'ID: channel:language:feedLabel:offerId

Tous les appels d'API Merchant Center renvoient le nouveau format, avec ~ entre les valeurs des ID. Nous vous recommandons de stocker le nouveau format de la réponse et de l'utiliser dans votre les prochains appels.

champs parents pour les ressources enfants

Dans l'API Merchant Center, toutes les ressources enfants comportent le champ parent. Vous pouvez utiliser le champ parent pour spécifier le name de la ressource dans laquelle insérer l'enfant ; au lieu de transmettre l'intégralité de la ressource parente. Vous pouvez également utiliser l'parent avec les méthodes list pour répertorier les ressources enfants de ce parent.

Par exemple, pour lister les inventaires en magasin d'un produit donné, spécifiez le name du produit dans la parent pour le champ list . Dans ce cas, le product donné est le parent de la LocalInventory ressources renvoyées.

Types

Voici quelques types courants partagés entre les sous-API de l'API Merchant Center.

Prix

Voici les modifications apportées à Price dans le package Merchant Common:

	Content API	API Merchant Center
Champ du montant	value:string	amountMicros:int64
Champ de devise	currency:string	currencyCode:string

Le montant de Price est désormais enregistré en micros, soit 1 million de micros équivalente à l'unité standard de votre devise.

Dans Content API for Shopping, Price était un nombre décimal sous la forme d'une .

Le nom du champ du montant est passé de value à amountMicros

Le nom du champ de devise est passé de currency à currencyCode. La reste au format ISO 4217.