Présentation de l'API Merchant Data Source

Cette page explique comment créer et mettre à jour de façon programmatique les sources de données qui vous permettent d'insérer des produits. Les sources de données automatiques facilitent l'envoi de vos données produit à Google. Les sources de données automatisées permettent aux utilisateurs des informations à jour sur des produits pertinents provenant de votre site Web parviennent à Google.

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

Content API for Shopping vous permet uniquement de gérer des sources de données avec une entrée de fichier. L'API Merchant vous permet de gérer des sources de données à l'aide d'entrées de fichiers 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 pour laquelle les champs feedLabel et contentLanguage ne sont pas définis. Avec ce type de source de données, vous pouvez cibler plusieurs pays pour vos produits, car vous pouvez insérer des produits associés à différentes combinaisons feedLabel et contentLanguage dans une seule 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.
  • Inscrivez votre compte pour la gestion automatique des sources de données.
  • Gérer les sources de données de l'API
  • Gérez la règle par défaut des sources de données à l'aide des sources de données produit principales.
  • Utiliser d'autres types de sources de données, comme les promotions

Vous ne pouvez pas utiliser l'API Merchant Center pour insérer des produits dans une source de données contenant les produits en magasin et en ligne. Pour en savoir plus sur les sources de données, consultez l'article Chaînes :

Prérequis

  • Votre compte doit avoir été migré 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 de sources de données ou 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

Les sources de données principales sont les principales sources de données de votre inventaire Merchant Center. Vous ne pouvez ajouter ni supprimer des produits qu'à l'aide d'une source de données principale. Si tous les produits que vous ajoutez à votre source de données principale respectent les conditions et les exigences concernant les données de Merchant Center, vous n'avez pas besoin de créer d'autres sources 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. Pour en savoir plus sur ces champs, consultez PrimaryProductDataSource.

Pour en savoir plus sur la création d'une source de données, consultez la méthode accounts.dataSources.create.

Pour afficher la source de données que vous venez de créer, utilisez la méthode accounts.dataSources.get ou accounts.dataSources.list .

Créer une source de données principale qui vous aide à cibler plusieurs pays

Pour créer un flux principal qui vous aide à cibler plusieurs pays, 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, une seule source de données API est créée pour vous. L'API Merchant Data Sources vous permet d'avoir plusieurs sources de données API, dont certains peuvent ne pas avoir défini les champs feedLabel et contentLanguage.

Seules les sources de données avec entrée API peuvent se trouver sans feedLabel et contentLanguage champs définis. Ce type de sources de données n'est pas compatible avec les entrées de fichiers.

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

Les sources de données supplémentaires ne sont utilisées que pour mettre à jour les données produit existe dans une ou plusieurs sources de données principales. Vous pouvez avoir plusieurs sources de données supplémentaires, chacune pouvant compléter les données de différents flux principaux.

Vous pouvez utiliser des sources de données supplémentaires pour mettre à jour partiellement vos données produit en procédant comme suit : en ajoutant l'identifiant unique de la source de données comme paramètre de requête les appels au accounts.productInputs.insert et accounts.productInputs.delete méthodes. 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 votre source de données à l'aide de SupplementalProductDataSource, puis l'associer en mettant à jour defaultRule de votre source de données principale.

Les champs feedLabel et contentLanguage doivent être définis pour les sources de données de fichiers supplémentaires. Les champs feedLabel et contentLanguage doivent toujours être définis sur "unset" pour les sources de données API supplémentaires.

Planifier la source de données d'un fichier

Pour planifier votre flux de fichiers, configurez votre source de données en tant que fichier source de données via le 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.

Source de données de récupération

Pour récupérer un fichier configuré dans la source de données, utilisez la méthode accounts.dataSources.fetch . Cette méthode permet d'extraire immédiatement les données d'une source de données 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 associée à votre compte, utilisez le accounts.dataSources.get .

Répertorier les sources de données

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

Source de données de correctif

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

Les sources de données produit principales vous permettent de gérer la règle par défaut des sources de données. La règle par défaut est celle qui s'applique dans votre source de données. La règle par défaut peut être définie lors de la création de la source de données ou en mettant à jour une source de données existante via le champ de règle par défaut.

L'exemple de configuration suivant permet de s'assurer que tous les attributs provenant de la source de données avec l'identifiant unique 1001. Ensuite, les sont ajoutés à partir de la source de données principale. Finalement, les autres seront extraits de la source de données supplémentaire avec l'attribut Identifiant 1002 s'il n'est pas déjà fourni dans une autre source de données. Si les est fourni dans plusieurs sources de données, la valeur la plus élevée dans la liste est sélectionnée.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

Gestion automatique des flux

Pour activer la gestion automatique des sources de données dans votre compte, procédez comme suit : suivantes:

Une fois que votre compte est éligible pour l'inscription, vous pouvez utiliser le accounts.autofeedSettings.updateAutofeedSettings permettant d'activer la gestion automatique des sources de données. En activant la gestion automatique des sources de données, Google peut ajouter automatiquement vos produits à partir de votre boutique en ligne et s'assurer qu'ils sont toujours à jour sur les plates-formes de Google.

Récupérer l'état de l'importation de fichiers

Pour obtenir l'état d'une source de données avec un fichier, une récupération ou une feuille de calcul, vous pouvez appeler la méthode GET du service accounts.dataSources.fileUploads. Pour obtenir le résultat de la dernière récupération de la source de données calculée de manière asynchrone lorsque le traitement de la source de données est terminé, utilisez l'identifiant de nom latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

L'état de l'importation du fichier peut contenir une vue détaillée de vos produits, y compris les problèmes potentiels.

Notez que l'état de l'importation du fichier peut ne pas exister si le fichier n'a jamais été importé. Il est possible que l'état de l'importation du fichier soit en cours de traitement si vous y êtes invité peu de temps après. le fichier est importé.