Gérer les informations du catalogue

Cette page explique comment gérer vos informations produit après avoir importé un catalogue dans AI Commerce Search. Vous pouvez lire, écrire et supprimer des produits dans votre catalogue.

Pour que votre catalogue reste à jour à mesure que les informations sur les produits changent, importez votre catalogue de la même manière que la première fois. Pour obtenir de l'aide concernant l'importation de votre catalogue, consultez la page Importer des informations de catalogue.

Tutoriels pour créer, gérer et accéder à des produits

Ce tutoriel vous explique comment utiliser les méthodes de l'API, qui effectuent les actions suivantes :

Créer un produit
Obtenir un produit
Mettre à jour un produit
Supprimer un produit

Pour obtenir des instructions détaillées sur cette tâche directement dans l' éditeur Cloud Shell, cliquez sur Visite guidée :

Créer le produit

Ce tutoriel vous explique comment créer un produit unique.

Pour obtenir des instructions détaillées sur cette tâche directement dans l' éditeur Cloud Shell, cliquez sur Visite guidée :

Obtenir le produit

Ce tutoriel vous explique comment récupérer un produit.

Pour obtenir des instructions détaillées sur cette tâche directement dans l' éditeur Cloud Shell, cliquez sur Visite guidée :

Mettre à jour le produit

Ce tutoriel vous explique comment mettre à jour un produit dans un catalogue.

Pour obtenir des instructions détaillées sur cette tâche directement dans l' éditeur Cloud Shell, cliquez sur Visite guidée :

Supprimer le produit

Ce tutoriel vous explique comment supprimer un produit d'un catalogue.

Pour obtenir des instructions détaillées sur cette tâche directement dans l' éditeur Cloud Shell, cliquez sur Visite guidée :

Importer un produit unique

curl

Créez un produit unique en utilisant la products.create méthode REST.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
      "title": "PRODUCT_TITLE",
      "categories": "CATEGORY"
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products?productId=PRODUCT_ID"

Si la requête aboutit, l'objet produit est renvoyé, comme dans l'exemple suivant.

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID",
  "id": "PRODUCT_ID",
  "primaryProductId": "PRODUCT_ID",
  "type": "PRIMARY",
  "categories": \[
    "CATEGORY"
  \],
  "title": "PRODUCT_TITLE",
  "availability": "IN_STOCK"
}

Java

public static Product createProduct(Product productToCreate, String productId)
    throws IOException {
  return getProductServiceClient().createProduct(
      DEFAULT_BRANCH_NAME, productToCreate, productId
  );
}

Mettre à jour des informations produit

Lorsque votre catalogue de produits évolue, vous pouvez l'actualiser en important en temps réel les modifications (nouveaux produits, prix et état des stocks, par exemple). Vous pouvez n'importer que les produits été ajoutés ou modifiés. Il n'est pas nécessaire d'importer à nouveau l'intégralité de votre catalogue.

curl

Mettez à jour les informations produit en utilisant la products.patch méthode.

L'exemple suivant met à jour le titre d'un produit spécifique :

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
       "title": "new-title-value"
    }" \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID?updateMask=title"

Si la requête aboutit, l'objet produit est renvoyé, comme dans l'exemple suivant.

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID",
  "id": "PRODUCT_ID",
  "primaryProductId": "PRODUCT_ID",
  "type": "PRIMARY",
  "categories": \[
    "Parent category > Child category"
  \],
  "title": "new product title",
  "availability": "IN_STOCK"
}

Java

public static Product updateProduct(Product productToUpdate) throws IOException {
  return getProductServiceClient().updateProduct(productToUpdate, FieldMask.getDefaultInstance());
}

Supprimer des informations produit

Bien que l'API permette de supprimer des produits de votre catalogue, n'oubliez pas que si vous enregistrez un événement utilisateur lié à un produit supprimé, l'API ne peut pas traiter l'événement utilisateur qui risque d'être supprimé. En outre, l'inclusion des données de l'historique du catalogue améliore la qualité de votre modèle et est essentielle pour la qualité des recommandations et des résultats de recherche.

Vous devez définir le availability des produits obsolètes sur OUT_OF_STOCK plutôt que de les supprimer.

curl

Supprimez un produit à l'aide de la delete méthode, en remplaçant PRODUCT_ID par l'ID du produit que vous souhaitez supprimer.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"

Java

public static void deleteProduct(String productName) throws IOException {
  getProductServiceClient().deleteProduct(productName);
}

Récupérer un produit

curl

Pour récupérer un article de produit, envoyez une requête GET au point de terminaison products, en remplaçant PRODUCT_ID par l'ID du produit que vous souhaitez récupérer :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"  \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"

La sortie obtenue doit ressembler à ceci :

{
    "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"
    "id": "PRODUCT_ID",
    "primaryProductId": "PRODUCT_ID",
    "type": "PRIMARY",
    "categories": \[
      "Parent category > Child category"
    \],
    "title": "product title",
    "availability": "IN_STOCK"
}

Java

public static Product getProduct(String productName) throws IOException {
  return getProductServiceClient().getProduct(productName);
}

Afficher des informations agrégées sur votre catalogue

Vous pouvez afficher des informations agrégées sur votre catalogue et prévisualiser les produits importés dans l'onglet Catalog (Catalogue) de la page Data (Données) d'AI Commerce Search dans la console Gemini Enterprise for Customer Experience.

Évaluer la qualité des données de catalogue

Pour évaluer la qualité des données de votre catalogue :

Accédez à la page Data quality (Qualité des données) dans la console AI Commerce Search dans Gemini Enterprise for Customer Experience.

Accéder à la page "Qualité des données"

La page Data quality (Qualité des données) indique si vous devez mettre à jour les données de catalogue pour améliorer la qualité de vos résultats de recherche et débloquer les niveaux de performances de recherche.

Pour en savoir plus sur la vérification de la qualité des données de recherche et l'affichage des niveaux de performances de recherche, consultez Débloquer les niveaux de performances de recherche.

Pour obtenir un résumé des métriques de catalogue disponibles, consultez Métriques de qualité du catalogue.

Modifier les types de produits

Lors de l'importation d'un produit, vous pouvez indiquer s'il s'agit d'un produit principal, d'une variante ou d'une collection. Si le type d'un produit change ou s'il est spécifié de manière incorrecte, vous devez supprimer le produit et le créer avec le type mis à jour spécifié.

Le type d'un produit peut être défini sur TYPE_UNSPECIFIED, PRIMARY, VARIANT ou COLLECTION. Pour en savoir plus, consultez la section product.Type dans la documentation de référence.

Modifier la configuration au niveau du produit

Pour importer un catalogue avec Merchant Center, vous devez indiquer si les produits sont des produits principaux ou variantes.

Si les niveaux de produit changent ou s'ils sont spécifiés de manière incorrecte, utilisez cette procédure pour corriger leur configuration. Vous devez disposer du rôle IAM Administrateur Retail pour terminer cette procédure.

Assurez-vous qu'aucune importation ne se produit pendant la reconfiguration des niveaux de produit. Cela permet de vérifier que les données ne sont pas importées au mauvais niveau.
Supprimez tous les articles. Consultez products.delete. Le catalogue doit être entièrement vide avant de passer à l'étape suivante.
Réimportez vos données pour modifier la configuration au niveau du produit.

Cette procédure dépend de la manière dont vous importez les données. Suivez la procédure appropriée de la section Importer des informations de catalogue pour définir les niveaux de produit sur leur nouvelle configuration.
Terminez l'importation du nouveau catalogue avec la configuration de niveau modifiée en suivant la procédure de votre choix dans la section Importer des informations de catalogue.
Réglez tous les modèles existants.

Pour régler un modèle, accédez à la page Modèles, cliquez sur le nom du modèle pour afficher sa page d'informations, puis cliquez sur Régler manuellement dans la barre de boutons.

Accéder à la page "Modèles"

Pour en savoir plus sur les coûts de réglage, consultez la page Tarifs.

Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.

Dernière mise à jour le 2026/05/01 (UTC).