Lecteur d'ingestion

Le lecteur d'ingestion (accessible sous Ingestion > Historique dans le Centre d'actions) offre une visibilité en temps quasi réel sur l'état, la validité et l'historique de traitement des flux de points d'intérêt locaux.

Utilisez le lecteur d'ingestion pour suivre les importations quotidiennes de flux, surveiller l'état de l'ingestion, inspecter les statistiques sur les erreurs de validation au niveau des articles et vérifier l'arrivée des fichiers de flux.

Présentation

La page principale du lecteur d'ingestion affiche un journal chronologique inversé de tous les flux reçus par Google.

Phases du cycle de vie de l'ingestion

Chaque flux envoyé passe par les étapes de traitement séquentielles suivantes :

  1. Acquisition de fichiers : Google reçoit le fichier de flux via SFTP.
  2. Validation des fichiers : le système vérifie l'intégrité des fichiers, leur décompression et le format général du schéma.
  3. Extraction et validation des entités : le pipeline analyse les enregistrements locaux individuels (poi_id, adresse, coordonnées, localisations) et vérifie la syntaxe, l'exhaustivité et la conformité aux règles.
  4. Rapprochement et mise en correspondance : les entités valides sont transmises au moteur de mise en correspondance de Google pour être associées aux ID de lieux Google canoniques pour la diffusion.
  5. Génération de rapports : les métriques récapitulatives et les diagnostics de problèmes groupés sont publiés dans le lecteur d'ingestion.

Pour afficher l'historique d'ingestion de vos flux, procédez comme suit :

  1. Connectez-vous au Centre d'actions.
  2. Ouvrez la page Ingestion > Historique.
  3. Filtrez, triez et affichez le tableau d'ingestion à l'aide des commandes de colonne.

Colonnes de la liste d'ingestion

Le tableau récapitulatif principal fournit les colonnes suivantes pour chaque exécution d'ingestion :

Colonne Type de données Description
ID String Identifiant unique de l'exécution de l'ingestion.
Heure d'ingestion (UTC) Timestamp Date et heure (en UTC) auxquelles Google a commencé à traiter l'ingestion du flux.
Type d'ingestion Enum Type d'acquisition de données (par exemple, Feed).
Nom String Nom du type d'ingestion de flux. Il s'agira de google.local_vss.
État State État général du traitement de l'ingestion (par exemple, "Terminé" ou "Échec"). Consultez les définitions des états.
Comportement d'ingestion Enum Tous les flux de POI locaux sont traités en mode Batch.
Erreurs Integer Nombre total de problèmes de validation bloquants détectés.
Avertissements Integer Nombre total de problèmes de niveau avertissement non bloquants détectés.
Éléments Integer Nombre total de propriétés locales traitées lors de cette ingestion.

Définitions des états

La colonne État indique l'état opérationnel actuel d'un flux envoyé :

  • OK (STATUS_COMPLETE) : le flux a été ingéré, validé et traité sans erreur fatale.
  • Échec (STATUS_FAILED) : l'ingestion a rencontré des erreurs fatales de schéma, de corruption de fichier ou de pipeline, et n'a pas pu se terminer.
  • Traitement (STATUS_PROCESSING) : Google valide, fait correspondre et stocke activement les données du flux.
  • Ignoré (NOT_STARTED) : l'importation du flux a été ignorée (par exemple, si le code temporel de génération est antérieur à celui d'un flux traité précédemment).

Vue Détails de l'ingestion

Cliquez sur n'importe quelle ligne du tableau "Visionneuse d'ingestion" pour ouvrir la vue Détails de l'ingestion. Cette vue fournit des fiches de diagnostic complètes et des panneaux de développement pour déboguer les problèmes.

Panneaux de détails

La page d'informations sur l'ingestion est divisée en quatre sections extensibles :

1. Informations générales

Affiche les métadonnées principales sur l'exécution :

  • Heure d'ingestion (UTC) : code temporel indiquant le moment où Google a commencé l'ingestion.
  • Type d'ingestion : Feed.
  • Nom : google.local_vss
  • Comportement d'ingestion : Batch
  • État : badge d'état avec code couleur (Done, Failed, Processing, Skipped).

2. Validations

Liste tous les résultats de validation rencontrés lors de l'ingestion :

  • Erreurs liées aux fichiers (encadré) : si l'intégralité du fichier de flux a échoué (par exemple, en raison d'une archive illisible ou d'une syntaxe JSON incorrecte), un encadré d'avertissement bien visible affiche le message indiquant la cause première.
  • Problèmes liés aux entités (tableau accordéon) : problèmes de validation au niveau des articles, regroupés par niveau de gravité et code d'erreur.
    • Code du problème : identifiant d'erreur spécifique (tel que INVALID_ATTRIBUTE_VALUE, MISSING_RECOMMENDED_FIELD ou SAFE_SEARCH_POLICY_VIOLATION_TEXT).
    • Informations sur le problème : description du diagnostic expliquant la cause première et les champs concernés.
    • Enregistrements : nombre total d'entités de propriété concernées par ce problème.
    • Cliquez sur une ligne de problème pour développer les ID d'entités exemples (poi_id) avec des liens directs permettant d'inspecter les propriétés dans le visualiseur d'inventaire.

3. Éléments

Fournit des tableaux de données sur les deltas d'inventaire au niveau des articles pour l'exécution de l'ingestion :

  • Total : nombre total d'établissements locaux traités.
  • Ajoutées : nombre de fiches d'établissement nouvellement découvertes et ajoutées à votre catalogue.
  • Modifiées : nombre de propriétés existantes dont les attributs (nom, adresse, coordonnées ou images, par exemple) ont été modifiés.
  • Supprimé : nombre de propriétés supprimées ou omises par rapport à la référence du flux précédent.

4. Fichiers

Affiche le nom du fichier de flux importé :

  • Nom du fichier : nom du fichier de flux (par exemple, local_feed.json.gz).

Résoudre les échecs d'ingestion

Lorsque vous résolvez des problèmes liés aux flux dans la visionneuse d'ingestion, suivez les consignes suivantes :

Problème constaté Cause probable Action recommandée
L'état est Failed avec l'erreur de fichier Archive ZIP/GZIP corrompue, syntaxe JSON incorrecte ou encodage de fichier non compatible. Vérifiez que votre flux est correctement empaqueté à l'aide des Consignes d'empaquetage des flux.
Nombre élevé deErrors Des champs de schéma obligatoires (tels que poi_id, location.address structuré ou les coordonnées WGS84) sont manquants dans les enregistrements. Développez l'accordéon Validations pour identifier les poi_id concernés, corrigez les pipelines de votre flux de POI et réimportez le flux.
Zero Items processed Le fichier de flux est vide ou l'analyse du tableau JSON de niveau racine des enregistrements a échoué. Vérifiez que la structure de l'enveloppe de votre flux est conforme aux spécifications du message VssPoi. Consultez les Consignes relatives à l'emballage des flux.