Le lecteur d'inventaire vous permet d'effectuer les opérations suivantes:
- Rechercher des entités en fonction de l'ID du fournisseur (l'identifiant que vous indiquez dans les flux)
- Consultez les informations spécifiques aux entités, y compris :
- Nom de l'entité
- Adresse du restaurant
- JSON d'entité brute
- Zones desservies
- Heures
- État de diffusion sur les surfaces grand public
- Liens vers le processus de commande des consommateurs
- et autres articles
- Naviguer entre les entités associées (par exemple, passer d'un menu à son service parent et restaurant, ou inversement)
- Identifier la version d'une entité dont Google dispose
Pour accéder à l'outil de visualisation de l'inventaire, ouvrez Actions Center et accédez à Inventaire > Entités de commande de repas ou cliquez sur ce lien.
Tous les utilisateurs disposant d'un accès de type Lecteur ou supérieur à votre compte Actions Center ont automatiquement accès à Lecteur d'inventaire.
Le lecteur d'inventaire n'est compatible qu'avec les environnements de production et de bac à sable. Les tests rapides ne sont pas disponibles.
Utiliser l'outil d'affichage de l'inventaire
Accédez à Inventaire > Entités de commande de repas ou cliquez sur ce lien.
Le lecteur d'inventaire propose deux vues: la vue Liste et la vue détaillée.
Vue Liste
Il s'agit de la vue que les utilisateurs voient lorsqu'ils accèdent à l'outil pour la première fois. Elle contient une table avec un onglet pour chaque type d'entité. Chaque onglet contient un tableau paginé de toutes les entités de ce type. Les colonnes varient selon le type d'entité, mais incluent toujours les éléments suivants:
| Nom de la colonne | Description |
|---|---|
| ID d'entité | ID d'entité fourni par le partenaire (issu de flux par lot et de mises à jour en temps réel) |
| Dernière modification | Il s'agit du code temporel de la dernière modification de l'ingestion de cette entité dans les flux ou les RTU (dans votre fuseau horaire). |
Voici d'autres colonnes spécifiques à une entité:
| Nom de la colonne | Description |
|---|---|
| Nom | Nom de l'entité dans les flux. |
| État | État de diffusion de l'entité. Disponible uniquement pour les restaurants et services |
| État supprimé | État "supprimé" de l'entité. Les valeurs sont "Supprimées" ou "Non supprimées". Disponible pour tous les types d'entités, sauf Service et Restaurant |
| Type | Livraison ou Vente à emporter pour les services, optionType pour MenuItemOptions |
Cliquez sur une ligne pour accéder à la vue détaillée de cette entité.
Filtres de la vue Liste
Chaque table sous forme de liste accepte un ensemble de filtres spécifiques à ce type d'entité. Toutes les entités sont compatibles avec le filtrage par ID d'entité (l'ID que vous fournissez à Google dans les flux et les RTU).
Certains types d'entités prennent en charge des filtres plus avancés. Vous trouverez ci-dessous un tableau qui répertorie quelques filtres de ce type.
| Clé | Opérateurs | Types d'entités compatibles | Description |
|---|---|---|---|
| Nom | =,contient | Restaurant, Menu, MenuSetion, MenuItem | Nom d'entité fourni dans les flux |
| SKU | = | MenuItemOffer | |
| Adresse | =,contient | Restaurant | Adresse indiquée dans les flux |
| État de diffusion | sélection multiple | Restaurant, service | État de diffusion dans l'interface utilisateur |
| État supprimé | sélection multiple | Toutes les entités, sauf Restaurant et service | État de suppression de l'entité (supprimée ou non supprimée) |
Vue Détails
La vue détaillée est la vue que les utilisateurs voient lorsqu'ils cliquent sur une entité dans la vue Liste. La vue détaillée contient des informations supplémentaires sur cette entité, par exemple:
- Motif de désactivation (pour les types d'entités "Restaurant" et "Service")
- Vues sous forme de liste des entités associées
- Date d'indexation de l'entité (heure de la dernière synchronisation avec la base de données à diffuser)
- JSON brut des flux ou des mises à jour en temps réel
- Vues combinées d'entités associées (par exemple, OperationHours, ServiceAreas, price)
- Liens vers les flux de commande de production et de test (restaurants et services uniquement)
États et solutions pour corriger les erreurs
Le tableau suivant décrit les états de diffusion des entités indiqués dans l'outil Inventory Viewer. Seuls les restaurants et les services sont associés à un état de diffusion.
| État | Description |
|---|---|
| Activé | L'entité peut diffuser des annonces sur les surfaces Google. |
| Désactivée | L'entité n'est pas diffusée sur Google. Cliquez sur la ligne pour ouvrir la vue détaillée et découvrir la raison pour laquelle elle n'est pas diffusée. |
| En attente | L'entité a été ajoutée dans le flux le plus récent, mais elle n'est pas encore diffusée. |
| Supprimé | L'entité a été supprimée d'un flux ou d'une mise à jour en temps réel. Les entités supprimées sont conservées pendant 30 jours. |
La version que vous voyez dans la visionneuse d'inventaire n'est peut-être pas celle qui est diffusée en raison des délais de traitement des entités. Pour en savoir plus, consultez les questions fréquentes.
Si une entité est désactivée, ouvrez la vue détaillée pour connaître le motif de la désactivation.
| Motif de la désactivation | Description | Solutions |
|---|---|---|
| Menu manquant ou comportant une erreur | L'entité de menu est manquante ou présente une erreur lors de l'ingestion. | Assurez-vous qu'une entité de menu est définie pour le restaurant dans les flux de données. Vérifiez que les références @id sont correctes. Rechercher les erreurs dans le menu en utilisant l'outil de visualisation de l'inventaire |
| Restaurant manquant ou comportant une erreur | L'entité du restaurant ne figure pas dans les flux ou a rencontré une erreur lors de l'ingestion. | Assurez-vous que l'entité de restaurant est définie dans les flux de données. Assurez-vous que les références @id à l'entité du restaurant sont correctes. |
| Impossible de trouver un restaurant valide dans la base de données de Google | Cela se produit lorsqu'une entité de restaurant de votre flux de données ne parvient pas à établir une correspondance avec un restaurant valide figurant dans la base de données de Google. | Vérifiez si le restaurant existe dans la recherche Google et sur Maps. Si le restaurant n'existe pas, suivez les instructions pour ajouter ou revendiquer votre fiche d'établissement sur Google. Assurez-vous que le nom et l'adresse indiqués dans le fichier de flux de données correspondent exactement à ceux indiqués dans la fiche d'établissement. |
| Service manquant ou comportant une erreur | L'entité de service est manquante ou présente une erreur lors de l'ingestion. | Assurez-vous que l'entité de service est définie pour le restaurant dans les flux de données. Vérifiez que les références @id sont correctes. Utilisez l'outil d'affichage de l'inventaire pour rechercher les erreurs liées aux entités de service et les corriger. |
| Temporairement désactivée dans les flux | Le restaurant figure dans des flux de données, mais son service a été désactivé. | Envoyez une mise à jour incrémentielle ou une ingestion par lots pour définir la propriété isDisabled de l'entité de service sur "false". |
| Restaurant désactivé dans OwG | Le marchand n'est pas autorisé à commander de bout en bout, car il a déjà choisi de désactiver le bouton "Commander en ligne" en suivant les instructions de Configurer, activer ou désactiver le bouton "Commander en ligne". | Contactez votre restaurant et demandez-lui d'activer le bouton "Commander en ligne" à l'aide de ces boutons "Configurer, activer ou désactiver" le bouton "Commander en ligne". |
| Restaurant désactivé par le fournisseur | Le marchand a désactivé le service Commander en ligne en suivant les instructions de l'article Configurer, activer ou désactiver le bouton "Commander en ligne" pour vous dans le service de commande de bout en bout, car il a signalé qu'il n'entretenait aucune relation commerciale avec vous. | Contactez le marchand et demandez-lui d'activer le bouton "Commander en ligne" pour le fournisseur à l'aide du formulaire de contact. |
| Marqué comme fermé sur Google – Fermé définitivement | L'établissement apparaît comme fermé définitivement dans la fiche info Google. | Les marchands peuvent suivre les instructions de la section Définir des horaires d'ouverture ou indiquer une fermeture pour indiquer que l'établissement a rouvert sur sa fiche d'établissement. |
| Marqué comme fermé sur Google – Fermé temporairement | L'établissement apparaît comme fermé définitivement ou temporairement dans la fiche info Google. | Les marchands peuvent suivre les instructions de la section Définir des horaires d'ouverture ou indiquer une fermeture pour indiquer que l'établissement a rouvert sur sa fiche d'établissement. |
| Restaurants en double | Cela signifie que plusieurs entités de restaurant de vos flux de données sont mises en correspondance avec le même restaurant dans la base de données de Google. | Supprimez les entités de restaurant en double de vos flux de données. Si le même restaurant possède plusieurs établissements dans un même complexe (centre commercial, aéroport ou centre commercial) ou à proximité les uns des autres, assurez-vous que chacun d'eux est associé à un emplacement distinct sur la fiche d'établissement Google (instructions) et qu'il correspond à une seule entité dans les flux de données. |
| Services en double | Cela signifie que plusieurs services du même type (livraison ou à emporter) issus de vos flux de données sont associés au même restaurant dans la base de données de Google. Exemple: Deux entités de service de livraison sont configurées pour le même restaurant dans vos flux de données. | Mettez à jour vos flux de données pour vous assurer que chaque restaurant ne propose pas de service de livraison ni de service à emporter en double. |
Entités supprimées
Pour les entités "Restaurant" et "Service" qui ont été supprimées, la colonne "État" affiche "État supprimé". Pour tous les autres types d'entités, la vue sous forme de liste contient une colonne "état supprimé" dont la valeur sera soit "Supprimé", soit "Non supprimé". Les entités supprimées sont stockées pendant 30 jours après les événements de suppression. Le lecteur d'inventaire ne dispose pas d'informations complètes sur les entités supprimées, et les champs tels que "Nom" affichent la mention "Inconnu".
Questions fréquentes
Le rapport Visionneuse d'inventaires remplace-t-il le rapport Statut du restaurant ?
Non. Le rapport sur l'état des restaurants continuera d'exister et fournira une vue agrégée des états de diffusion.
Quelle est la latence des données qui s'affichent dans l'outil d'affichage de l'inventaire ?
Dans le lecteur d'inventaire, la latence des données est postérieure au temps d'ingestion et de traitement. Pour les données fournies dans des flux par lot, la latence peut atteindre deux heures à compter du moment où l'ingestion a réussi. Pour les mises à jour en temps réel, ce délai est inférieur à 5 minutes. Une ingestion réussie implique l'une des actions suivantes:
- L'état du flux contenant l'entité est "Opération réussie" sur l'écran Historique des ingestions.
- La RTU contenant l'entité ne présente aucune erreur de validation au niveau de la requête ou de l'entité, comme indiqué dans RTU Reporting.
L'outil de visualisation d'inventaire est-il compatible avec Quicktesting ?
Non. Le lecteur d'inventaire n'est compatible qu'avec les environnements de production et de bac à sable.
J'ai résolu le problème qui empêchait la diffusion d'un restaurant, mais il apparaît toujours comme "Désactivé" dans l'outil de visualisation de l'inventaire.
Il peut s'écouler jusqu'à deux heures entre le moment où l'ingestion est réussie, via les flux par lot, ou jusqu'à cinq minutes pour que les RTU soient prises en compte dans le flux de commande des consommateurs. Pour en savoir plus sur la latence, consultez les questions fréquentes. L'état de diffusion du lecteur d'inventaire est à jour. Ainsi, lorsqu'une entité modifie l'état de diffusion dans l'interface utilisateur consommateur, elle apparaît presque instantanément dans la visionneuse d'inventaire.
Dernière modification et heure d'indexation
Le lecteur d'inventaire affiche toujours la dernière version ingérée d'une entité. Toutefois, une fois l'ingestion terminée, mais avant la mise à jour de l'UI consommateur avec la dernière version, la version de l'entité diffusée ne correspondra pas à la version qui vient d'être ingérée et qui s'affiche dans la visionneuse d'inventaire. Cela est dû au temps de traitement dans le pipeline de diffusion. La heure d'indexation correspond à l'heure à laquelle les données reçues via des flux et des mises à jour en temps réel ont été synchronisées avec la base de données de diffusion pour être diffusées sur les surfaces grand public. Toute entité dont l'heure de la dernière modification est antérieure à la heure d'indexation sera diffusée sur les surfaces grand public.
Par exemple, supposons que vous ajoutiez un service dans les flux. L'ingestion se termine à 00:30:00 et est indexée à 01:30:00, et la diffusion commence à ce moment-là. Ensuite, à 04:00:00, vous importez un autre flux avec une nouvelle version de ce service (isDisabled=true) et l'ingestion se termine à 04:30:00. Une fois la deuxième ingestion terminée, le lecteur d'inventaire affiche le 1er janvier à 04:30:00 GMT comme horodatage de la dernière modification. Toutefois, tant qu'une opération d'indexation n'a pas eu lieu, le flux de commande des consommateurs continue de diffuser la version qui s'est terminée à 00:30:00. Supposons qu'une autre opération d'indexation ait lieu à 04:45:00. À ce stade, l'état désactivé du service est mis à jour dans l'interface utilisateur grand public et l'entité cesse d'être diffusée. Toutefois, pendant toute la période allant de 01:30:00 (première opération d'indexation) à 04:45:00 (seconde opération d'indexation), l'état de l'entité est défini sur "Activé", car une version précédente de l'entité a été diffusée dans l'interface utilisateur.