Présentation de l'API Merchant Data Source

Cette page explique comment créer et mettre à jour de manière programmatique vos sources de données qui vous permettent d'insérer des produits. Les sources de données automatisées facilitent l'envoi de vos données produit à Google. Les sources de données automatiques s'assurent que les informations les plus récentes sur les produits concernés de votre site Web sont transmises à Google.

Content API for Shopping vous permet uniquement de créer des sources de données principales. L'API Merchant Data Sources vous permet de créer les types de sources de données suivants:

Content API for Shopping ne permettait de gérer que les sources de données contenant des fichiers. L'API Merchant Center vous permet de gérer les sources de données avec des entrées de fichier et d'API.

L'API Merchant Data Sources vous permet d'effectuer les opérations suivantes:

  • Créez une source de données principale avec un feedLabel et un contentLanguage spécifiques.
  • Créez une source de données générique. Dans le cas d'une source de données générique, les champs feedLabel et contentLanguage ne sont pas définis. Les sources de données génériques vous permettent d'insérer des produits avec différentes combinaisons de feedLabel et contentLanguage dans une source de données.
  • Créez une source de données supplémentaire à associer à une source de données principale existante.
  • Planifier la source de données d'un fichier.
  • Gérer les sources de données de l'API
  • Utilisez d'autres types de sources de données, comme les promotions.

Conditions préalables

  • Votre compte doit avoir fait l'objet d'une migration vers des flux pour un seul paramètre régional.

  • Pour vérifier que le compte a déjà fait l'objet d'une migration vers la répartition cible de données, utilisez la liste des sources de données ou les méthodes get. Si vous n'êtes pas éligible, vous recevrez le message d'exception suivant. Contactez l'assistance.

    This account is in the data sources migration process and can't be used with
this API yet. Contact support for more info on when this account will be able
to use the data sources endpoint.

Créer une source de données

Pour créer une source de données principale avec un feedLabel et un contentLanguage spécifiques, définissez les champs feedLabel et contentLanguage dans la configuration spécifique au type. Par exemple, PrimaryProductDataSource.

Pour afficher la source de données que vous venez de créer, créez une requête GET ou LIST.

Créer une source de données principale avec un caractère générique

Pour créer un flux principal avec des caractères génériques, configurez votre source de données à l'aide de PrimaryProductDataSource, et ne définissez pas les champs feedLabel et contentLanguage.

Avec Content API for Shopping, vous n'avez créé qu'une seule source de données d'API. L'API Merchant Data sources vous permet d'avoir plusieurs sources de données d'API, dont certaines peuvent être génériques.

Seules les sources de données avec une entrée API peuvent être des sources de données à caractère générique. Les sources de données utilisant des caractères génériques ne sont pas compatibles avec les entrées de fichiers.

Créer une source de données supplémentaire et l'associer à la source de données principale

Vous pouvez utiliser des sources de données supplémentaires pour effectuer des mises à jour partielles des données produit en ajoutant l'identifiant unique de la source de données en tant que paramètre de requête lorsque vous appelez les méthodes accounts.productInputs.insert et accounts.productInputs.delete. Vous ne pouvez utiliser des sources de données supplémentaires que pour mettre à jour des produits existants.

Pour créer une source de données supplémentaire, configurez-la à l'aide de SupplementalProductDataSource, puis associez-la en mettant à jour le champ defaultRule de votre source de données principale.

Les sources de données de fichiers supplémentaires ne peuvent pas être des sources de données avec des caractères génériques. Les sources de données d'API supplémentaires doivent toujours être des sources de données à caractère générique.

Planifier la source de données d'un fichier

Pour planifier votre flux de fichiers, configurez votre source de données de sorte qu'elle soit une source de données sous forme de fichier à l'aide du champ FileInput, puis configurez fetchsettings à l'aide du champ FileInput.FetchSettings.

Supprimer une source de données

Pour supprimer une source de données existante de votre compte, utilisez la méthode accounts.dataSources.delete.

Extraire la source de données

Pour récupérer un fichier configuré dans la source de données, utilisez la méthode accounts.dataSources.fetch. Avec cette méthode, les données sont récupérées immédiatement sur une source de données de votre compte. Cette méthode ne fonctionne que sur les sources de données comportant un ensemble d'entrées de fichiers.

Obtenir la source de données

Pour récupérer la configuration de la source de données pour votre compte, utilisez la méthode accounts.dataSources.get.

Répertorier les sources de données

Pour répertorier les configurations des sources de données de votre compte, utilisez la méthode accounts.dataSources.list.

Appliquer un correctif à la source de données

Pour mettre à jour la configuration d'une source de données existante, utilisez la méthode accounts.dataSources.patch.