Cette documentation ne concerne que Recommendations AI. Pour essayer Retail Search et la console Play Store unifiée pendant la phase de disponibilité limitée, contactez le service commercial Cloud. Si vous ne prévoyez pas d'utiliser Retail Search, restez dans la console "Recommandations" jusqu'à nouvel ordre.

Si vous utilisez la version v1beta de Recommendations AI, migrez vers la version Retail API.

Gérer les informations du catalogue

Cette page explique comment gérer vos informations produit après avoir importé un catalogue dans Recommendations AI. 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.

Importer un produit

curl

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

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": "Shoes & Accessories > Shoes"
    }' \
    "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": [
    "Shoes & Accessories \u003e Shoes"
  ],
  "title": "product title",
  "availability": "IN_STOCK"
}

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 méthode products.patch.

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",
       "categories": "Shoes & Accessories > Shoes"
    }" \
    "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": [
    "Shoes & Accessories \u003e Shoes"
  ],
  "title": "new product title",
  "availability": "IN_STOCK"
}

Supprimer des informations produit

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

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 méthode delete, 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]"

Récupérer un produit

curl

Pour récupérer un 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": [
      "Shoes & Accessories \u003e Shoes"
    ],
    "title": "product title",
    "availability": "IN_STOCK"
}

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" de la page Recommendations AI.

Données d'importation de catalogue dnas Recommendations AI

Modifier la configuration au niveau du produit

Lorsque vous importez un catalogue, vous devez spécifier si les éléments du catalogue sont des instances principales ou des variantes. Si ces niveaux de produits changent ou ne sont pas spécifiés correctement, suivez la procédure ci-dessous pour corriger leur configuration. Vous devez disposer du rôle IAM Administrateur Recommendations AI.

  1. Assurez-vous qu'aucune importation ne se produit pendant la reconfiguration des niveaux de catalogue. Cela garantit que les données ne seront pas importées au mauvais niveau.

  2. Si vous prévoyez de modifier les niveaux des éléments du catalogue d'événements, supprimez définitivement tous les événements utilisateur à l'aide de la méthode de suppression définitive.

  3. Supprimez tous les articles. Consultez la section Supprimer des articles. Le catalogue doit être entièrement vide avant de passer à l'étape suivante.

  4. Modifiez 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 catalogue sur leur nouvelle configuration.

  5. 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.

  6. 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 ses informations, puis cliquez sur Régler manuellement dans la barre de boutons.

    Accéder à la page "Modèles" de Recommendations AI.

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