Cette page répertorie un ensemble de tutoriels interactifs pour l'API Google Retail incluant des actions pouvant être exécutées dans l'éditeur Google Cloud Shell. Cet outil vous permet d'écrire, de compiler, de tester, d'exécuter et de déboguer des applications cloud natives directement depuis votre navigateur.
Présentation
Essayez différents tutoriels en fonction de ce que vous souhaitez apprendre:
Si vous démarrez un projet, suivez les tutoriels Importer des informations du catalogue. Ici, vous allez apprendre à importer des produits dans le catalogue afin de tester différentes fonctionnalités de recherche, par exemple. Consultez ensuite les tutoriels Importer des événements utilisateur historiques. L'API Retail génère des recommandations et des résultats de recherche initiaux à l'aide d'événements utilisateur. Suivez ensuite les tutoriels Enregistrer des événements utilisateur en temps réel. L'API Retail utilise des événements utilisateur en temps réel pour fournir des résultats pertinents et de haute qualité.
Si vous souhaitez en savoir plus sur le fonctionnement de la recherche en général, consultez les tutoriels sur la recherche.
Pour savoir comment configurer la recherche avec des configurations et des commandes de diffusion, suivez les tutoriels suivants:
Si vous devez mettre à jour les informations de votre catalogue, consultez les tutoriels Gérer les informations du catalogue.
Si vous souhaitez savoir comment mettre à jour l'inventaire, consultez les tutoriels Mettre à jour l'inventaire pour Retail Search.
Si vous souhaitez savoir comment enregistrer, afficher ou supprimer des événements utilisateur en temps réel, consultez les tutoriels Enregistrer des événements utilisateur en temps réel.
Si vous prévoyez d'utiliser Recommendations AI, consultez les tutoriels pour importer et gérer des catalogues et des événements utilisateur.
Importer les informations du catalogue
Ces tutoriels expliquent comment importer les informations de votre catalogue dans l'API Retail et les maintenir à jour.
Importer des données de catalogue à partir de BigQuery
Ce tutoriel explique comment utiliser une table BigQuery pour importer de grandes quantités de données de catalogue sans limite.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Importer des données de catalogue depuis Cloud Storage
Ce tutoriel vous explique comment importer un grand nombre d'articles 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 :
Importer les données de catalogue de façon intégrée
Ce tutoriel explique comment importer des produits dans un catalogue de façon intégrée.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :
Gérer les informations du catalogue
Ces tutoriels expliquent comment gérer les informations sur vos produits après avoir importé un catalogue dans l'API Retail. Vous pouvez lire, écrire et supprimer des produits dans votre catalogue.
Découvrez comment appeler l'API Google Cloud Retail dans le langage de votre choix.
Créer, obtenir, mettre à jour et supprimer un produit
Ce tutoriel vous montre comment utiliser les méthodes du service Product de l'API Retail, 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 un produit
Ce tutoriel vous explique comment créer un seul produit.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Obtenir un produit
Ce tutoriel vous explique comment récupérer un article.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :
Mettre à jour un produit - Tutoriel
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 un produit - Tutoriel
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 des événements utilisateur historiques
Ces tutoriels expliquent comment importer de manière groupée les données d'événements utilisateur issues d'événements passés. Les modèles de l'API Retail nécessitent des données d'événement utilisateur pour l'entraînement.
Importer des événements depuis Cloud Storage
Ce tutoriel explique comment importer des événements utilisateur depuis Cloud Storage.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :
Importer des événements à partir de BigQuery
Ce tutoriel explique comment importer des événements utilisateur depuis BigQuery.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Importer des événements intégrés
Ce tutoriel explique comment importer des données d'événements utilisateur intégrées.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Enregistrer des événements utilisateur en temps réel
Ces tutoriels expliquent comment enregistrer, afficher ou supprimer des événements utilisateur en temps réel. L'API Retail utilise des événements utilisateur en temps réel pour générer des recommandations et des résultats de recherche. Enregistrer autant d'événements utilisateur que possible avec des informations valides sur le produit augmente la qualité des résultats.
Écrire des événements utilisateur
Ce tutoriel explique comment enregistrer des événements utilisateur à l'aide de la méthode userEvents.write.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Réassocier des événements utilisateur
Ce tutoriel explique comment joindre de nouveau des événements utilisateur en envoyant une requête POST au point de terminaison userEvents:rejoin.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :
Supprimer un événement utilisateur
Ce tutoriel explique comment supprimer définitivement des événements utilisateur.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :
Rechercher des tutoriels
La méthode search() de l'API Retail vous permet d'effectuer des recherches dans le catalogue en fonction de la requête de recherche et d'autres paramètres, tels qu'un filtre, un attribut ou un paramètre de tri (order_by).
Par défaut, la réponse de la recherche contient un nombre raisonnable de résultats classés par pertinence.
Effectuer des requêtes
Ce tutoriel vous explique comment envoyer une requête de recherche simple au service Retail et analyser sa réponse.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Utiliser la pagination
Ce tutoriel explique comment contrôler la pagination dans la requête de recherche. Lorsqu'un acheteur recherche des produits dans un magasin, il peut améliorer sa navigation dans les résultats de recherche. Par exemple, ils peuvent limiter le nombre d'éléments dans la réponse à la recherche à l'aide de la fonctionnalité de taille de page ou passer à la page de leur choix en utilisant la fonctionnalité de décalage.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Utiliser l'extension des requêtes
Ce tutoriel vous explique comment activer la fonctionnalité d'extension des requêtes. Lorsqu'un acheteur se sert d'une expression de recherche ambiguë ou comportant plusieurs mots, il peut recevoir une réponse vide. Une fois l'extension des requêtes activée, Retail Search analyse la requête et renvoie la liste développée des produits en fonction de la requête analysée.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Appliquer un filtre
Ce tutoriel présente la fonctionnalité de filtrage. Il vous permet d'affiner les requêtes de recherche en fonction de vos besoins ou de ceux de vos clients. Vous pouvez filtrer un ou plusieurs champs, des champs de texte ou des champs numériques, ou les deux. Vous pouvez utiliser un langage d'expression pour construire un prédicat pour chaque champ ou combiner différentes expressions à l'aide d'opérateurs logiques. Par exemple, un acheteur de chaussures peut utiliser des filtres pour affiner sa recherche en fonction de la marque et de la couleur de son choix.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Trier les produits
Ce tutoriel explique comment classer des éléments dans une réponse de recherche. Lorsqu'un acheteur recherche un produit sur votre site, Retail Search peut afficher des résultats classés selon plusieurs champs. Par exemple, un acheteur recherche une robe avec le meilleur prix et la meilleure remise. Le prix et la remise sont indiqués dans plusieurs champs. Retail Search affiche les robes de la commande triées par prix et, pour les robes au même prix, classées par remise.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :
Utiliser le boosting
Ce tutoriel présente des exemples d'optimisation de produits dans les résultats de recherche. Avec l'amplification, vous pouvez appliquer un boost à un produit afin de le hiérarchiser ou de le prioriser dans les résultats de recherche.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :
Utiliser la commande de redirection
Ce tutoriel vous explique comment utiliser la commande de redirection. La commande de redirection vous permet de spécifier une URL vers laquelle les internautes peuvent être redirigés lorsqu'ils utilisent une requête de recherche spécifique. Par exemple, si un utilisateur demande des "produits de fabrication durables", vous pouvez le rediriger vers une page contenant les marques environnementales avec lesquelles vous travaillez.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Mettre à jour l'inventaire pour Retail Search
Même si les méthodes CRUD (création, lecture, mise à jour et suppression) Product sont utilisées pour modifier de manière générale les attributs d'un objet Product, il existe un ensemble de méthodes Product qui peuvent être utilisées pour mettre à jour des champs spécifiques à l'inventaire avec différents niveaux de précision. Les champs Product suivants sont considérés comme des champs d'inventaire :
Product.price_infoProduct.availabilityProduct.available_quantityProduct.fulfillment_info
Ajouter des lieux de traitement
Ce tutoriel explique comment mettre à jour les informations de traitement des produits à l'aide de la méthode AddFulfillmentPlaces. De cette manière, Retail Search peut afficher les mises à jour concernant la disponibilité des produits et le traitement des commandes. Prenons l'exemple d'un acheteur qui recherche un jean bleu dans un magasin, mais qui n'est pas en stock. Dès que le jean est de nouveau en stock dans le magasin ou dans un autre magasin, Retail Search affiche les nouveautés et l'acheteur peut poursuivre sa commande.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:
Supprimer des lieux de traitement
Ce tutoriel explique comment mettre à jour les informations de traitement des produits à l'aide de la méthode [RemoveFulfillmentPlaces][remove-fulfillment-places]. Ainsi, Retail Search peut afficher les mises à jour lorsque les produits ne sont pas disponibles et les commandes ne peuvent pas être traitées. Prenons l'exemple d'un acheteur qui recherche un jean bleu dans un magasin. Si les jeans ne sont plus disponibles dans ce magasin, Retail Search affiche les nouveautés et l'acheteur ne peut pas poursuivre sa commande.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :
Configurer l'inventaire
Ce tutoriel explique comment envoyer des mises à jour d'inventaire à l'aide de la méthode SetInventory au lieu de mettre à jour l'ensemble du produit.
Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :