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 automatiques facilitent l'envoi de vos données produit à Google. Les sources de données automatisées permettent de s'assurer que les informations les plus récentes sur les produits pertinents de votre site Web parviennent à Google.

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

Content API for Shopping ne vous permet de gérer les sources de données que par importation de fichiers. 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 avec différentes combinaisons de 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.
  • Configurez un planning pour une source de données de 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 de 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 pour insérer des produits dans une source de données contenant à la fois des produits en magasin et en ligne. Pour en savoir plus sur les canaux de sources de données, consultez la section Canaux.

Prérequis

  • Votre compte doit avoir été migré vers des flux pour une seule langue.

  • Pour vérifier que le compte est déjà migré vers la répartition des cibles 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 et vous devrez contacter 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.

L'exemple de requête suivant montre comment créer une source de données produit principale:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "feedLabel": "{FEED_LABEL}",
    "countries": [
      "{COUNTRY}"
    ],
    "channel": "ONLINE_PRODUCTS"
  }
}

Remplacez les éléments suivants :

  • {ACCOUNT_ID}: identifiant unique de votre compte Merchant Center.
  • {DISPLAY_NAME}: nom à afficher de la source de données.
  • {CONTENT_LANGUAGE}: code de langue ISO 639-1 à deux lettres des produits de la source de données.
  • {FEED_LABEL}: libellé du flux de la source de données.
  • {COUNTRY}: code de territoire CLDR du pays cible des produits qui seront importés à l'aide de la source de données.

Une fois la requête exécutée, la réponse suivante s'affiche:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}",
  "dataSourceId": "{DATA_SOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "{FEED_LABEL}",
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "countries": [
      "{COUNTRY}"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

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

Pour afficher votre nouvelle source de données, utilisez la méthode accounts.dataSources.get ou accounts.dataSources.list.

Créer une source de données principale qui permet de 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. Avec l'API Merchant Data sources, vous pouvez avoir plusieurs sources de données API, dont certaines peuvent ne pas avoir de champs feedLabel et contentLanguage définis.

Seules les sources de données avec entrée API peuvent ne pas avoir de champs feedLabel et contentLanguage 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 doivent être utilisées que pour mettre à jour les données produit déjà présentes 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 effectuer des mises à jour partielles des données produit en ajoutant l'identifiant unique de la source de données comme 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 votre source de données à l'aide de SupplementalProductDataSource, puis associez-la en mettant à jour le champ 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.

Configurer un planning pour votre source de données de fichiers

Pour configurer un calendrier pour votre flux de fichiers, configurez votre source de données en tant que source de données de fichiers à 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.

Source de données de récupération

Pour extraire un fichier configuré dans la source de données, utilisez la méthode accounts.dataSources.fetch. Cette méthode effectue l'extraction de données immédiatement sur une source de données de votre compte. Cette méthode ne fonctionne que sur les sources de données pour lesquelles une entrée de fichier est définie.

Obtenir la source de données

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

Lister la source de données

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

Source de données de correctif

Pour mettre à jour la configuration d'une source de données existante, utilisez la méthode 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 s'applique à tous les attributs de 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.

Pour en savoir plus sur la configuration de règles, consultez Configurer des règles pour vos sources de données produit.

L'exemple de configuration suivant garantit que tous les attributs sont d'abord extraits de la source de données avec l'identifiant unique 1001. Les attributs manquants sont ensuite ajoutés à partir de la source de données principale. À terme, les attributs restants seront extraits de la source de données supplémentaire avec l'identifiant unique 1002, s'ils ne sont pas déjà fournis dans une autre source de données. Si le même attribut est fourni dans plusieurs sources de données, la valeur la plus élevée de 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 enregistrer votre compte pour la gestion automatique des sources de données, procédez comme suit:

Une fois que votre compte est éligible à l'inscription, vous pouvez utiliser la méthode accounts.autofeedSettings.updateAutofeedSettings pour activer la gestion automatique des sources de données. Activer la gestion automatique des sources de données permet à Google d'ajouter automatiquement vos produits à partir de votre boutique en ligne et de 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/{ACCOUNT_ID}/datasources/{DATASOURCE_ID}/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é. L'état de l'importation du fichier peut être "En cours de traitement" si la demande est effectuée peu de temps après l'importation du fichier.