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.

Migrer vers l'API Retail depuis la version bêta

Recommendations AI utilise désormais l'API Retail. Cette page décrit les modifications introduites et les bonnes pratiques de migration lors du passage de la version v1beta1 de l'API Recommendations Engine (point de terminaison de service https://recommendationengine.googleapis.com) à l'API Retail en disponibilité générale (point de terminaison de service https://retail.googleapis.com)

L'API Recommendations Engine et sa documentation restent disponibles mais ne seront plus mis à jour.

Ce document ne vous concerne que si vous avez commencé à utiliser Recommendations AI en version bêta.

Bonnes pratiques

  • Avant d'avoir effectué la migration complète, envoyez exclusivement le trafic de validation.
  • Il est préférable de migrer le trafic de manière incrémentale plutôt que d'un seul coup. Si possible, migrez progressivement votre trafic de la version v1beta1 vers la version v2.
  • Si vous exécutez des services dans différentes régions, il est préférable de migrer les régions une par une pour éviter une pannes globale.

Modifications de la documentation

Cet ensemble de documentation est destiné à l'API Retail en disponibilité générale.

La documentation bêta de l'API Recommendations Engine reste disponible mais ne sera plus mise à jour. Vous trouverez la documentation bêta ci-dessous :

Chemins d'accès REST et RPC

De nombreuses modifications ont été apportées aux chemins d'accès REST et RPC. Consultez la documentation de l'API Retail pour vous assurer que vos appels sont correctement formulés.

Tous les chemins utilisent désormais retail.googleapis.com au lieu de recommendationengine.googleapis.com.

Exemple :

API Recommendations Engine v1beta1 :

GET https://recommendationengine.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID

API Retail v2 :

GET https://retail.googleapis.com/v2/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID

Certaines ressources et méthodes ont été renommées, supprimées ou ajoutées. Utilisez le tableau ci-dessous pour comparer les ressources v1beta1 à celles de la version v2.

Notez que les liens vers les ressources v1beta1 renvoient à la documentation de l'API pour la version v1beta1.

Ressource v1beta1 Méthode Ressource v2 Méthode
catalogs list catalogs list
patch patch
Non disponible catalogs.branches.operations get
catalogs.catalogItems create catalogs.branches.products create
delete delete
get get
import import
list Supprimé
patch patch
catalogs.operations get catalogs.operations get
list list
catalogs.eventStores.operations get Supprimé
list
catalogs.eventStores.placements predict catalogs.placements predict
catalogs.eventStores.predictionApiKeyRegistrations create Supprimé
delete
list
catalogs.eventStores.userEvents collect catalogs.userEvents collect
import import
list Supprimé
purge purge
rejoin rejoin
write write
Non disponible operations get
list

Modifications apportées à IAM

Les modifications suivantes ont été introduites pour les rôles et les autorisations IAM (Identity and Access Management) de Recommendations AI :

  • Recommendations AI utilise des rôles et des autorisations IAM dans l'espace de noms retail plutôt que dans l'espace de noms automlrecommendations utilisé par Recommendations Engine v1beta1.
  • Le rôle Admin Viewer a été supprimé.
  • Les autorisations pour apiKeys ont été supprimées, car la méthode predict ne nécessite plus sa propre clé API.

Schémas de catalogue et d'événement utilisateur

Les schémas de catalogue et d'événement utilisateur ont été modifiés dans l'API Retail.