Page "Inventaire"

Présentation

L'outil de visualisation de l'inventaire d'Actions Center vous permet de voir l'état d'ingestion, l'état de correspondance des lieux et l'éligibilité à la diffusion de l'inventaire en magasin de vos points d'intérêt (POI).

Ce lecteur affiche les problèmes indépendamment des ingestions individuelles (problèmes avec état représentant l'état de diffusion actif de chaque fournisseur de services, y compris les modes d'échec possibles (règles, avertissements, erreurs, etc.) pouvant se produire).

Utilisez cet outil pour :

  • Recherchez et inspectez tous les fournisseurs de services ingérés et leurs états de diffusion en direct.
  • Diagnostiquer les erreurs de validation des données et les cas de non-respect des règles relatives au contenu
  • Envoyez et suivez les appels pour tout cas de non-respect des règles.
  • Inspectez les diagnostics de correspondance des fournisseurs de services et envoyez des propositions de correspondance manuelle.
  • Examinez les charges utiles JSON brutes de vos dernières ingestions de flux.

Colonnes du tableau d'inventaire

La vue sous forme de liste affiche tous les fournisseurs de services importés à partir de votre flux de points d'intérêt, organisés de manière hiérarchique par entité. Vous pouvez filtrer par ID de POI local, état de correspondance, intégration et surface.

Colonnes de la table récapitulative Description
ID de POI local Identifiant unique de l'établissement local fourni dans le flux (poi_id).
Nom du point d'intérêt (caractères locaux) Nom localisé de l'établissement local extrait du flux.
État de la correspondance Indique si le point d'intérêt a été mis en correspondance avec une fiche Google Maps :
• Oui (badge vert) : mis en correspondance avec un lieu Google Maps.
• Non (badge rouge) : aucune correspondance. Un examen ou une proposition de correspondance est nécessaire.
Intégration Il s'agit de l'intégration de l'unité agrégateurs locaux.
Surface La surface de diffusion cible (par exemple, la recherche).
État de diffusion État d'éligibilité à la diffusion en temps réel :
• Activé (indicateur vert) : éligible et diffusé activement sur les surfaces Google.
• Désactivé (indicateur rouge) : la diffusion est bloquée en raison d'erreurs de validation, de non-respect des règles ou d'un état non mis en correspondance.
Erreurs Nombre de problèmes actifs avec un niveau de gravité "Erreur". Si une propriété comporte une erreur, elle ne pourra pas être diffusée sur une surface.
Avertissements Nombre de problèmes actifs avec un niveau de gravité "Avertissement". Les établissements présentant des avertissements peuvent toujours être diffusés.
Infos sur le match Contient le bouton "Modifier la correspondance", qui ouvre le panneau interactif de correction des correspondances.

Vue détaillée du POI

Cliquez sur un ID de point d'intérêt dans la vue sous forme de liste pour accéder à la page d'informations dédiée de l'entité.

La vue détaillée se compose de quatre sections extensibles :

1. Informations générales

Résume les métadonnées d'entité de haut niveau :

  • Nom du point d'intérêt : nom de l'établissement analysé à partir de data[].name.localizations.
  • ID du point d'intérêt : identifiant unique de l'entité partenaire (poi_id).
  • Source de données : nom exact du fichier de flux à partir duquel cette entité a été ingérée.

2. État du traitement

Répartit l'éligibilité à la diffusion par intégration et par surface cible :

  • Intégration et surface : secteur d'activité et surface cible (par exemple, Local Aggregator Unit sur Search).
  • État de diffusion : état actuel (Enabled ou Disabled).
  • Problèmes : affiche les badges de problème pour toutes les erreurs ou tous les avertissements actifs (par exemple, Unmatched entity, Policy Violation). Cliquez sur un badge de problème pour ouvrir le panneau des détails du problème.
  • Appels : affiche les états de forçage ou d'appel (Under review, Approved ou Rejected).

3. Informations sur la mise en correspondance

Affiche les diagnostics de correspondance des lieux :

  • Entrée de correspondance : adresse physique formatée analysée à partir de votre flux (street_address, locality, region, postal_code, country).
  • Type de correspondance : mécanisme de résolution de la correspondance (par exemple, Location).
  • Espace de noms de la correspondance : secteur d'activité auquel s'appliqueront les modifications de correspondance (par exemple, Local Aggregator Unit).
  • État de la correspondance : Yes (vert) ou No (rouge).
  • Résultat de la correspondance : nom, adresse et ID de lieu Google Maps résolus.
  • Modifier la correspondance : bouton permettant d'ouvrir la boîte de dialogue de proposition de correspondance.

4. JSON brut

Fournit un lecteur de code interactif avec des numéros de ligne et une mise en surbrillance de la syntaxe affichant la charge utile JSON analysée complète (item_proto) pour un débogage et une vérification rapides du schéma. Les valeurs de données présentées ici reflètent les valeurs reçues du flux de POI.

Workflow de tri et de gestion des problèmes

Les entités signalées comme présentant des problèmes sont soit désactivées (si elles sont signalées par une ERREUR), soit dégradées (si elles sont signalées par un AVERTISSEMENT). Les problèmes d'entité associés à un avertissement ne peuvent pas faire l'objet d'un appel. Les avertissements peuvent être résolus en corrigeant le problème sous-jacent.

Types de problèmes : contestables ou non contestables

  1. Problèmes non susceptibles d'appel (problèmes techniques, de qualité des données et avertissements) :
    • Erreurs de schéma, champs obligatoires manquants, coordonnées non valides, URL non fonctionnelles, ID en double ou avertissements de contenu non bloquants (par exemple, noms d'établissement dans des paramètres régionaux autres que ceux par défaut, ou paramètres régionaux pour les descriptions, les adresses à afficher et les catégories d'établissement).
    • Résolution : les partenaires doivent corriger les données sous-jacentes dans leur flux source et importer un fichier de flux mis à jour.
  2. Problèmes pouvant faire l'objet d'un appel (blocage de contenu et non-respect des règles) :
    • Déclenché lorsque les composants texte ou image obligatoires de la propriété ne passent pas les filtres de sécurité du contenu automatisés avec une gravité d'ERREUR.
    • Résolution : si le contenu respecte les règles de la plate-forme, les partenaires peuvent cliquer sur le bouton Faire appel à côté du problème dans Actions Center pour faire appel. Les partenaires doivent fournir une raison et une justification, et notre équipe chargée des appels examinera et approuvera ou refusera les demandes. Vous serez informé des décisions prises par le biais de l'outil et par e-mail.

Catalogue des problèmes liés aux unités d'agrégateurs locaux

Le tableau suivant présente l'ensemble des erreurs de validation et des codes de problème de non-respect des règles pour les intégrations d'unités d'agrégateurs locaux :

Description du problème Gravité Code du problème Champ / Arguments concernés Est-il possible de faire appel ? Action / Règle pertinente
ID de point d'intérêt manquant ERROR MISSING_REQUIRED_FIELD poi_id Non Indiquez un poi_id unique. Consultez les spécifications du flux de POI.
Paramètre régional par défaut manquant pour le champ "name" ERROR MISSING_REQUIRED_FIELD name.default_locale Non Spécifiez un code de langue BCP 47 valide pour les paramètres régionaux par défaut. Consultez Compatibilité multilingue.
Aucune localisation par défaut trouvée pour le champ "name" ERROR MISSING_REQUIRED_FIELD name.localizations Non Indiquez une valeur pour le nom localisé du point d'intérêt correspondant à la langue default_locale déclarée.
Paramètre régional par défaut manquant pour le champ "description" ERROR MISSING_REQUIRED_FIELD description.default_locale Non Spécifiez des paramètres régionaux par défaut BCP 47 valides pour la description de l'établissement.
Aucune localisation par défaut trouvée pour le champ "description" ERROR MISSING_REQUIRED_FIELD description.localizations Non Fournissez une description correspondant à la langue déclarée (default_locale).
Paramètre régional par défaut manquant pour le champ "display_address" ERROR MISSING_REQUIRED_FIELD display_address.default_locale Non Spécifiez des paramètres régionaux par défaut BCP 47 valides pour l'adresse à afficher.
Aucune localisation par défaut trouvée pour le champ "display_address" ERROR MISSING_REQUIRED_FIELD display_address.localizations Non Fournissez un texte d'adresse mis en forme correspondant à la langue default_locale déclarée.
Nombre maximal d'images dépassé AVERTISSEMENT EXCEEDED_MAX_COUNT images Non Limitez les entrées d'images à un maximum de cinq images par POI. Les images en trop sont supprimées.
Coordonnée de latitude non valide ERROR INVALID_LATLNG location.latitude Non Saisissez une latitude valide comprise entre -90.0 et +90.0. Consultez la définition des coordonnées géographiques.
Coordonnée de longitude non valide ERROR INVALID_LATLNG location.longitude Non Saisissez une longitude valide comprise entre -180.0 et +180.0. Consultez la définition des coordonnées géographiques.
Coordonnée de latitude manquante ERROR MISSING_REQUIRED_FIELD location.latitude Non Indiquez la valeur de latitude pour compléter la paire de coordonnées. Consultez la définition des coordonnées géographiques.
Coordonnée de longitude manquante ERROR MISSING_REQUIRED_FIELD location.longitude Non Indiquez la valeur de longitude pour compléter la paire de coordonnées. Consultez la définition des coordonnées géographiques.
Adresse manquante ou non structurée ERROR MISSING_REQUIRED_FIELD location.address Non Fournissez une adresse postale structurée incluant la rue, la localité, le code postal et le pays.
URL incorrecte ou non valide ERROR INVALID_ATTRIBUTE_VALUE url Non Assurez-vous que l'URL de la page de destination utilise un protocole HTTP/HTTPS compatible et une syntaxe valide.
Image non valide ou inaccessible AVERTISSEMENT INVALID_IMAGE image.url Non Vérifiez que les URL d'images sont accessibles publiquement, qu'elles ne nécessitent pas d'authentification et qu'elles ne renvoient pas d'erreurs 4xx/5xx.
ID de point d'intérêt en double ERROR DUPLICATE_ENTITY poi_id Non Assurez-vous que chaque poi_id est unique dans la charge utile du flux. Supprimez les entrées en double.
Entité correspondante en double ERROR DUPLICATE_MATCHED_ENTITY POI Non Supprimez les entrées en double de votre flux ou utilisez l'outil de mise en correspondance des entités de POI pour associer des établissements distincts à leurs fiches Google Maps indépendantes.
Entité sans correspondance ERROR UNMATCHED_ENTITY POI Non Associez le POI à une fiche de lieu Google Maps à l'aide de l'outil Mise en correspondance des entités de POI.
Non-respect des règles relatives aux images ERROR SAFE_SEARCH_POLICY_VIOLATION_IMAGE image Oui Supprimez ou remplacez l'image signalée, ou cliquez sur Faire appel pour envoyer une justification. Consultez le Règlement relatif au contenu des images de la recherche Google.
Non-respect des règles relatives au texte – Nom par défaut ERROR SAFE_SEARCH_POLICY_VIOLATION_TEXT name.localizations.*.text Oui Supprimez ou remplacez le texte du nom signalé, ou cliquez sur Faire appel. Consultez le Règlement relatif au contenu pour la recherche Google.
Non-respect des règles relatives au texte : nom non défini par défaut AVERTISSEMENT SAFE_SEARCH_POLICY_VIOLATION_TEXT name.localizations.*.text Non Supprimez ou remplacez le texte du nom signalé. Consultez le Règlement relatif au contenu pour la recherche Google.
Non-respect des règles relatives au texte : description AVERTISSEMENT SAFE_SEARCH_POLICY_VIOLATION_TEXT description.localizations.*.text Non Supprimez ou remplacez le texte de description signalé. Consultez le Règlement relatif au contenu pour la recherche Google.
Non-respect des règles relatives au texte : adresse à afficher AVERTISSEMENT SAFE_SEARCH_POLICY_VIOLATION_TEXT display_address.localizations.*.text Non Supprimez ou remplacez le texte de l'adresse visible signalé. Consultez le Règlement relatif au contenu pour la recherche Google.
Paramètre régional par défaut manquant pour la catégorie d'établissement ERROR MISSING_REQUIRED_FIELD local_data.establishment_category.default_locale Non Indiquez une valeur pour la catégorie d'établissement localisée du POI correspondant à la langue default_locale déclarée.
Jour d'ouverture manquant dans les horaires d'ouverture ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.open_day Non Indiquez un jour d'ouverture valide pour les horaires d'ouverture.
Horaires d'ouverture manquants ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.open_time Non Veuillez indiquer des horaires d'ouverture valides.
Missing business hours close day ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.close_day Non Indiquez un jour de fermeture valide pour les horaires d'ouverture.
Heure de fermeture manquante ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.close_time Non Indiquez une heure de fermeture valide.
Les horaires d'ouverture sont postérieurs à l'heure de fermeture ERROR NOT_LESS_THAN_FIELD local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time Non Indiquez une paire d'heures d'ouverture et de fermeture valide, en veillant à ce que l'heure d'ouverture soit antérieure à l'heure de fermeture.
La valeur minimale de la gamme de prix est supérieure à la valeur maximale ERROR INVALID_PRICE_RANGE local_data.price_range.min_price, local_data.price_range.max_price Non Indiquez une gamme de prix valide, avec un prix minimal inférieur au prix maximal.
ID de marque manquant ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.brand_id Non Indiquez un ID de marque valide.
ID de marque en double dans un point d'intérêt ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.brand_id Non Assurez-vous que chaque brand_id est unique dans la charge utile du point d'intérêt. Supprimez les entrées en double.
URL par défaut de la marque manquante ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.default_url Non Indiquez une URL de marque par défaut valide.
URL de marque incorrecte ou non valide ERROR INVALID_ATTRIBUTE_VALUE local_data.brand_landing_pages.default_url Non Assurez-vous que l'URL par défaut de la marque utilise un protocole HTTP/HTTPS compatible et une syntaxe valide.
URL de la page de destination localisée de la marque manquante ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.localized_landing_pages.url Non Indiquez une URL valide pour la page de destination localisée.
URL de la page de destination localisée de la marque incorrecte ou non valide ERROR INVALID_ATTRIBUTE_VALUE local_data.brand_landing_pages.localized_landing_pages.url Non Assurez-vous que l'URL de la page de destination localisée utilise un protocole HTTP/HTTPS compatible et une syntaxe valide.
URL de la page de destination localisée de la marque en double ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.localized_landing_pages.url Non Assurez-vous que chaque url est unique sur les pages de destination localisées des points de vente. Supprimez les entrées en double.
Page de destination localisée de la marque manquante ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.localized_landing_pages.locales Non Indiquez un ensemble de paramètres régionaux valides pour la page de destination localisée.
Paramètres régionaux de la page de destination localisée de la marque en double ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.localized_landing_pages.locales Non Assurez-vous que chaque locale est unique sur les pages de destination localisées des points de vente. Supprimez les entrées en double.
Non-respect des règles concernant le texte : catégorie d'établissement AVERTISSEMENT SAFE_SEARCH_POLICY_VIOLATION_TEXT local_data.establishment_category.localizations.*.text Non Supprimez ou remplacez le texte de la catégorie d'établissement signalé. Consultez le Règlement relatif au contenu pour la recherche Google.

Codes de problème

Les sections suivantes fournissent des causes détaillées et des étapes de correction pour chaque code de problème.

Champ obligatoire non renseigné

Code du problème : MISSING_REQUIRED_FIELD
Gravité : erreur (bloque la diffusion)
Possibilité de faire appel : non (corrigez le problème en mettant à jour votre flux de points d'intérêt)

Cette erreur se produit lorsqu'il manque un ou plusieurs attributs obligatoires à une entité ingérée, conformément aux spécifications du flux de points d'intérêt.

Consultez le panneau "Détails du problème" pour identifier la propriété manquante, puis appliquez le correctif correspondant :

1. ID de POI manquant (poi_id)

  • Cause : le champ poi_id est vide, nul ou manquant dans l'objet d'entité racine.
  • Correction : fournissez un identifiant de chaîne unique et persistant pour la propriété.
{
  "poi_id": "test_restaurant_1"
}

2. Paramètres régionaux par défaut ou nom localisé manquants (name)

  • Cause : la chaîne default_locale ou le tableau localizations avec des paramètres régionaux correspondants sont manquants dans l'objet name.
  • Correction : Fournissez à la fois le default_locale et au moins une entrée de localisation correspondant à ce paramètre régional.
{
  "name": {
    "localizations": [
      {
        "locale": "en",
        "text": "Tasty Bites Test Restaurant"
      }
    ],
    "default_locale": "en"
  }
}

3. Paramètres régionaux par défaut ou adresse localisée manquants (display_address)

  • Cause : la chaîne default_locale ou le tableau localizations est manquant dans l'objet display_address.
  • Correction : fournissez à la fois le default_locale et au moins une entrée de localisation correspondant à ces paramètres régionaux pour l'adresse postale formatée.
{
  "display_address": {
    "localizations": [
      {
        "locale": "en",
        "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
      }
    ],
    "default_locale": "en"
  }
}

4. Paramètres régionaux par défaut ou description localisée manquants (description)

  • Cause : lorsque l'objet description est inclus, default_locale ou la localisation correspondante est manquant.
  • Correction : fournissez à la fois le default_locale et au moins une entrée de localisation correspondant à ces paramètres régionaux pour la description.
{
  "description": {
    "localizations": [
      {
        "locale": "en",
        "text": "A mock restaurant for testing the POI feed ingestion."
      }
    ],
    "default_locale": "en"
  }
}

5. Coordonnées géographiques manquantes (location.latitude / location.longitude)

  • Cause : la valeur numérique latitude ou longitude est manquante dans l'objet location.
  • Correction : fournissez latitude et longitude sous forme de nombres à virgule flottante en degrés décimaux WGS84 standards.
{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

6. Adresse postale structurée manquante (location.address)

  • Cause : il manque des composants d'adresse obligatoires (country, locality ou postal_code) dans l'objet location.address.
  • Correction : Renseignez l'objet d'adresse postale structurée conformément aux normes ISO.
{
  "location": {
    "address": {
      "country": "US",
      "locality": "Mountain View",
      "postal_code": "94043",
      "street_address": "1600 Amphitheatre Pkwy"
    }
  }
}

7. Paramètres régionaux par défaut manquants pour la catégorie d'établissement (local_data.establishment_category.default_locale)

  • Cause : l'objet local_data.establishment_category est présent, mais default_locale est manquant, vide ou ne correspond à aucune entrée du tableau localizations.
  • Correction : Spécifiez un tag de langue BCP 47 valide pour default_locale et fournissez au moins une chaîne localisée correspondant à ces paramètres régionaux.
{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        }
      ]
    }
  }
}

8. Jour d'ouverture manquant dans les horaires d'ouverture (local_data.business_hours.time_ranges.open_day)

  • Cause : une entrée dans local_data.business_hours.time_ranges ne contient pas open_day ou est définie sur DAY_OF_WEEK_UNSPECIFIED.
  • Correction : indiquez une chaîne de jour de la semaine valide (par exemple, "MONDAY", "TUESDAY", etc.).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

9. Horaires d'ouverture manquants (local_data.business_hours.time_ranges.open_time)

  • Cause : l'objet open_time est manquant dans une entrée de local_data.business_hours.time_ranges.
  • Correction : spécifiez open_time avec hours (0-23) et minutes (0-59).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

10. Jour de fermeture manquant dans les horaires d'ouverture (local_data.business_hours.time_ranges.close_day)

  • Cause : une entrée dans local_data.business_hours.time_ranges ne contient pas close_day ou est définie sur DAY_OF_WEEK_UNSPECIFIED.
  • Correction : indiquez une chaîne de jour de la semaine valide (par exemple, "MONDAY", "TUESDAY", etc.).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

11. Heure de fermeture manquante des horaires d'ouverture (local_data.business_hours.time_ranges.close_time)

  • Cause : l'objet close_time est manquant dans une entrée de local_data.business_hours.time_ranges.
  • Correction : spécifiez close_time avec hours (0-23) et minutes (0-59).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

12. ID de marque manquant (local_data.brand_landing_pages.brand_id)

  • Cause : une entrée de local_data.brand_landing_pages comporte un brand_id vide, nul ou manquant.
  • Correction : fournissez un identifiant de chaîne non vide correspondant à la configuration de votre marque partenaire enregistrée.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

13. URL par défaut de la marque manquante (local_data.brand_landing_pages.default_url)

  • Cause : une entrée dans local_data.brand_landing_pages ne contient pas default_url ou est une chaîne vide.
  • Correction : fournissez une URL de page de destination HTTP/HTTPS de remplacement valide pour les utilisateurs dont les paramètres régionaux ne correspondent pas aux URL localisées.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

14. URL de la page de destination localisée de la marque manquante (local_data.brand_landing_pages.localized_landing_pages.url)

  • Cause : un élément de localized_landing_pages comporte un champ url manquant ou vide.
  • Correction : indiquez une URL HTTP/HTTPS valide et complète pour la page de destination localisée.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

15. Paramètre régional de la page de destination localisée de la marque manquant (local_data.brand_landing_pages.localized_landing_pages.locales)

  • Cause : un élément de localized_landing_pages comporte un tableau locales manquant ou vide.
  • Correction : fournissez au moins un code de langue ou de paramètre régional BCP 47 valide (par exemple, ["en-US"]) dans le tableau locales.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

Nombre maximal d'images dépassé

Code du problème : EXCEEDED_MAX_COUNT
Gravité : avertissement
Possibilité de faire appel : non (résolvez le problème en mettant à jour la charge utile du flux)

Cette erreur se produit lorsqu'une charge utile d'entité de point d'intérêt contient plus de cinq objets d'image dans le tableau images.

Correction :

  • Réduisez le tableau images afin qu'il ne contienne pas plus de cinq photos représentatives et de haute qualité de l'établissement local.
  • Toute image dépassant la limite de cinq sera supprimée.

Coordonnées géographiques non valides

Code du problème : INVALID_LATLNG
Gravité : erreur (bloque la diffusion)
Possibilité de faire appel : non (corrigez le problème en mettant à jour la charge utile du flux)

Cette erreur se produit lorsque les coordonnées géographiques fournies dans location.latitude ou location.longitude se trouvent en dehors des limites sphériques valides ou représentent des coordonnées nulles non renseignées.

Causes courantes et correction :

  • Latitude hors limites : la latitude doit être un nombre à virgule flottante compris entre -90.0 et 90.0 inclus.
  • Longitude hors limites : la longitude doit être un nombre à virgule flottante compris entre -180.0 et 180.0 inclus.
  • Null Island (0,0) : l'envoi de 0.0, 0.0 ou d'entiers d'espace réservé (comme 999, 999) entraîne le rejet des coordonnées.
  • Coordonnées inversées : vérifiez que la latitude et la longitude ne sont pas inversées dans votre pipeline de sérialisation.

Exemple de charge utile valide :

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

URL incorrecte ou non valide

Code du problème : INVALID_ATTRIBUTE_VALUE
Gravité : erreur (bloque la diffusion)
Possibilité de faire appel : non (corrigez le problème en mettant à jour la charge utile du flux)

Cette erreur se produit lorsqu'une valeur d'attribut échoue à la validation du schéma, le plus souvent lorsqu'une URL de page de destination ou d'image d'un partenaire n'est pas valide d'un point de vue syntaxique.

Conditions requises :

  • Protocole : les URL doivent spécifier explicitement http:// ou https:// (HTTPS est vivement recommandé).
  • Encodage : les URL contenant des caractères spéciaux, des espaces ou des caractères non ASCII doivent être correctement encodées en pourcentage (RFC 3986).
  • Domaine canonique : assurez-vous que le domaine est complet (par exemple, https://example.com/local/123, et non example.com/local/123 ou www.example).

Exemple de charge utile valide :

{
  "url": "https://www.tastybitestest.com/en"
}

Image non valide ou inaccessible

Code du problème : INVALID_IMAGE
Gravité : avertissement
Possibilité de faire appel : non (résolvez le problème en mettant à jour la charge utile du flux)

Cet avertissement se produit lors de l'étape de récupération asynchrone des images, lorsque le robot d'exploration Google ne parvient pas à télécharger, décoder ou valider le composant multimédia à partir de image.url. L'image non valide est ignorée, mais l'établissement reste éligible à la diffusion.

Causes courantes et correction :

  • Erreurs HTTP (404 / 403 / 500) : l'URL de l'image renvoie un code d'état HTTP autre que 200. Assurez-vous que les images sont accessibles publiquement sans authentification, cookie walls ni restrictions de liste d'autorisation d'adresses IP.
  • Blocage par le fichier robots.txt : assurez-vous que votre réseau de diffusion de contenu (CDN) autorise les user-agents Googlebot et Googlebot-Image.
  • Format de fichier non compatible : les images doivent être au format matriciel standard (JPEG, PNG, WebP). Les GIF animés, les SVG et les formats d'appareil photo bruts ne sont pas acceptés. Pour en savoir plus, consultez nos consignes relatives aux images.
  • Échecs de certificat SSL : vérifiez que le serveur d'hébergement d'images dispose d'une chaîne de certificats SSL valide.

ID de POI en double

Code du problème : DUPLICATE_ENTITY
Gravité : erreur (bloque la diffusion)
Possibilité de faire appel : non (corrigez le problème en mettant à jour la charge utile du flux)

Cette erreur se produit lorsque la même chaîne poi_id apparaît plusieurs fois dans un même ensemble de fichiers de flux.

Correction :

  • Assurez-vous que chaque fiche locale de votre flux possède un poi_id unique et déterministe.
  • Si un établissement local propose plusieurs types de chambres ou tarifs, regroupez-les sous une seule entité de point d'intérêt racine plutôt que de créer des enregistrements d'entités en double avec des ID identiques.

Entité correspondante en double

Code du problème : DUPLICATE_MATCHED_ENTITY
Gravité : erreur (bloque la diffusion)
Possibilité de faire appel : non (résolvez le problème en mettant à jour la charge utile du flux ou en utilisant les outils de mise en correspondance des entités de point d'intérêt)

Cette erreur se produit lorsque deux entrées poi_id distinctes ou plus de votre flux correspondent à la même fiche d'établissement canonique sur Google Maps. Lorsque plusieurs établissements sont mappés à la même entité Google, toutes les entrées en conflit sont bloquées jusqu'à ce que le problème de duplication soit résolu.

Comment résoudre le problème :

  1. Identifiez les propriétés en conflit : ouvrez l'outil de visualisation des ingestions (Ingestion > Historique), sélectionnez votre dernière exécution d'ingestion, puis développez le panneau Validations. Cliquez sur la ligne DUPLICATE_MATCHED_ENTITY qui partage le même identifiant de groupe Informations sur le problème pour afficher tous les enregistrements poi_id correspondant à la même entité Google.
  2. Supprimez les fiches en double de votre flux : si les entrées poi_id en conflit représentent le même établissement physique, supprimez les entrées en double de votre flux afin qu'un seul poi_id soit envoyé pour cet établissement.
  3. Corrigez les correspondances incorrectes pour les établissements indépendants : si les entrées poi_id en conflit représentent des établissements distincts et indépendants qui ont été associés de manière incorrecte à la même entité Google, ouvrez l'établissement associé de manière incorrecte dans la vue "Inventaire", puis cliquez sur Modifier la correspondance pour sélectionner ou proposer la fiche d'établissement Google Maps dédiée. Pour obtenir des instructions détaillées, consultez le guide sur la mise en correspondance d'entités de POI.

Entité sans correspondance

Code du problème : UNMATCHED_ENTITY
Gravité : erreur (bloque la diffusion)
Possibilité de faire appel : non (utilisez les outils de mise en correspondance des entités de point d'intérêt ou corrigez les métadonnées de l'entité)

Ce problème indique que le pipeline de mise en correspondance de Google n'a pas pu rapprocher votre fiche locale d'un lieu canonique dans Google Maps.

Comment résoudre le problème :

  1. Vérifiez les attributs principaux : assurez-vous que les attributs name, display_address, location.address, url, telephone et location.latitude/location.longitude de l'établissement reflètent précisément l'emplacement physique de l'établissement.
  2. Inspecter les informations de correspondance : examinez la colonne Informations de correspondance dans la vue de l'inventaire pour voir les lieux candidats.
  3. Utilisez l'outil de correction des correspondances de POI : cliquez sur Modifier la correspondance dans Actions Center pour rechercher et confirmer manuellement l'ID de lieu Google correct. Des instructions détaillées sont disponibles dans le guide sur la mise en correspondance d'entités de POI.

Non-respect des règles de la recherche d'images Google

Code du problème : SAFE_SEARCH_POLICY_VIOLATION_IMAGE
Gravité : ERREUR (bloque la diffusion)
Possibilité de faire appel : oui

Voir les codes de problème de non-respect des règles pertinents : Règlement relatif au contenu de la recherche Google

Si vous pensez que l'image a été signalée par erreur (faux positif), cliquez sur Créer un appel dans le panneau "Détails du problème".

Non-respect des règles relatives au contenu textuel de la recherche Google - Nom

Code du problème : SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravité : la gravité varie selon le champ (voir les détails ci-dessous)
Champ concerné : name.localizations.*.text
Possibilité de faire appel : oui (ERREUR de paramètre régional par défaut uniquement) ; non (avertissement de paramètre régional autre que celui par défaut)

  • Paramètres régionaux par défaut (name.default_locale) : ERREUR (bloque la diffusion). La diffusion de l'intégralité du point d'intérêt est bloquée. Si vous pensez que le texte du nom de paramètre régional par défaut a été signalé par erreur (faux positif), cliquez sur Créer un appel dans le panneau "Détails du problème".
  • Paramètres régionaux autres que ceux par défaut : Avertissement (ne bloque pas la diffusion). Seule la localisation signalée est omise, tandis que le point d'intérêt reste éligible à la diffusion. Les avertissements concernant les paramètres régionaux autres que ceux par défaut ne peuvent pas faire l'objet d'un appel et peuvent être résolus en mettant à jour la charge utile de votre flux.

Voir les codes de problème de non-respect des règles pertinents : Règlement relatif au contenu de la recherche Google

Non-respect du règlement relatif au contenu textuel de la recherche Google - Description

Code du problème : SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravité : avertissement (ne bloque pas la diffusion)
Champ concerné : description.localizations.*.text
Possibilité de faire appel : non (résolvez le problème en mettant à jour la charge utile du flux)

Cet avertissement s'affiche lorsque le texte de description.localizations est signalé pour non-respect du règlement relatif au contenu textuel de la recherche Google. Bien que la localisation de la description signalée (ou l'intégralité du champ description si les paramètres régionaux par défaut sont signalés) soit omise, le point d'intérêt reste éligible à la diffusion.

Voir les codes de problème de non-respect des règles pertinents : Règlement relatif au contenu de la recherche Google

Non-respect du règlement relatif au contenu textuel de la recherche Google - Adresse visible

Code du problème : SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravité : avertissement (ne bloque pas la diffusion)
Champ concerné : display_address.localizations.*.text
Possibilité de faire appel : non (résolvez le problème en mettant à jour la charge utile du flux)

Cet avertissement s'affiche lorsque le texte de l'adresse mise en forme dans display_address.localizations contient du contenu interdit par le règlement relatif au contenu textuel de la recherche Google. Bien que la localisation de l'adresse signalée (ou l'intégralité du champ display_address si les paramètres régionaux par défaut sont signalés) soit omise, le point d'intérêt reste éligible à la diffusion.

Voir les codes de problème de non-respect des règles pertinents : Règlement relatif au contenu de la recherche Google

L'heure d'ouverture de l'établissement est postérieure à l'heure de fermeture

Code du problème : NOT_LESS_THAN_FIELD
Gravité : erreur (bloque la diffusion)
Champs concernés : local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time
Possibilité de faire appel : non (résoudre en mettant à jour la charge utile du flux)

Cette erreur se produit lorsque l'heure d'ouverture open_time est postérieure ou égale à l'heure de fermeture close_time pour le même intervalle de jour.

Causes courantes et correction :

  • Inversion le même jour : assurez-vous que open_time est antérieur à close_time (par exemple, de 09:00 à 17:00).
  • Horaires de nuit : si un établissement ouvre un jour et ferme après minuit le jour suivant (par exemple, de 21h00 à 2h00), définissez close_day sur le jour suivant (par exemple, open_day : "FRIDAY", close_day : "SATURDAY").

Exemple de charge utile valide :

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 9, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 17, "minutes": 0 }
        }
      ]
    }
  }
}

La valeur minimale de la gamme de prix est supérieure à la valeur maximale

Code du problème : INVALID_PRICE_RANGE
Gravité : erreur (bloque la diffusion)
Champs concernés : local_data.price_range.min_price, local_data.price_range.max_price
Possibilité de faire appel : non (résoudre en mettant à jour la charge utile du flux)

Cette erreur se produit lorsque la valeur de min_price dépasse celle de max_price, ou si min_price et max_price spécifient des codes de devise différents.

Causes courantes et correction :

  • Valeurs inversées : assurez-vous que min_price est inférieur ou égal à max_price.
  • Incohérence de devise : vérifiez que min_price.currency_code et max_price.currency_code correspondent au même code de devise ISO 4217 à trois lettres (par exemple, "USD").

Exemple de charge utile valide :

{
  "local_data": {
    "price_range": {
      "min_price": {
        "currency_code": "USD",
        "units": 15,
        "nanos": 0
      },
      "max_price": {
        "currency_code": "USD",
        "units": 45,
        "nanos": 0
      }
    }
  }
}

Propriété unique en double dans un POI

Code du problème : DUPLICATE_UNIQUE_PROPERTY
Gravité : erreur (bloque la diffusion)
Possibilité de faire appel : non (corrigez le problème en mettant à jour la charge utile du flux)

Cette erreur se produit lorsqu'un champ ou un sous-élément devant être unique pour une même entité de point d'intérêt contient des entrées en double.

Consultez le panneau "Détails du problème" pour identifier la propriété qui ne respecte pas l'unicité :

1. ID de marque en double dans un point d'intérêt (local_data.brand_landing_pages.brand_id)

  • Cause : La même chaîne brand_id apparaît dans plusieurs entrées brand_landing_pages pour un même point d'intérêt.
  • Correction : regroupez toutes les pages de destination de cette marque dans un seul objet brand_landing_pages.

Exemple de charge utile valide :

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722"
      },
      {
        "brand_id": "brand_opentable",
        "default_url": "https://www.opentable.com/r/287722"
      }
    ]
  }
}

2. URL de la page de destination localisée de la marque en double (local_data.brand_landing_pages.localized_landing_pages.url)

  • Cause : l'URL de la page de destination est définie plusieurs fois sous localized_landing_pages pour la même marque.
  • Correction : Assurez-vous que chaque entrée d'URL est distincte ou associez plusieurs paramètres régionaux dans le tableau locales d'une seule entrée d'URL.

Exemple de charge utile valide :

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

3. Paramètre régional de la page de destination localisée de la marque en double (local_data.brand_landing_pages.localized_landing_pages.locales)

  • Cause : le même code de paramètre régional (par exemple, "en-US") est répété dans plusieurs entrées de localized_landing_pages pour la même marque.
  • Correction : Attribuez chaque balise de paramètre régional à une seule page de destination localisée.

Exemple de charge utile valide :

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US", "en-GB"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

URL de marque incorrecte ou non valide

Code du problème : INVALID_ATTRIBUTE_VALUE
Gravité : erreur (bloque la diffusion)
Possibilité de faire appel : non (résoudre en mettant à jour la charge utile du flux)
Champs concernés : local_data.brand_landing_pages.default_url, local_data.brand_landing_pages.localized_landing_pages.url

Cette erreur se produit lorsqu'une URL par défaut de la marque ou une URL de page de destination localisée échoue à la validation de la syntaxe de l'URI.

Conditions requises :

  • Protocole : doit spécifier explicitement http:// ou https:// (https:// est requis pour la diffusion en production).
  • Syntaxe : doit être une URL valide, encodée en pourcentage et conforme à la norme RFC 3986, avec un nom de domaine complet.

Exemple de charge utile valide :

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com/en",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en/reservation",
            "locales": ["en-US"]
          }
        ]
      }
    ]
  }
}

Non-respect du règlement relatif au contenu textuel de la recherche Google - Catégorie d'établissement

Code du problème : SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravité : avertissement (ne bloque pas la diffusion)
Possibilité de faire appel : non (résoudre en mettant à jour la charge utile du flux)
Champ concerné : local_data.establishment_category.localizations.*.text

Cet avertissement s'affiche lorsque le texte localisé de la catégorie d'établissement ne passe pas les filtres de contenu SafeSearch automatisés. Bien que la localisation de la catégorie d'établissement signalée (ou l'intégralité du champ establishment_category si les paramètres régionaux par défaut sont signalés) soit omise, le POI reste éligible à la diffusion.

Correction :

Exemple de charge utile valide :

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        },
        {
          "locale": "fr",
          "text": "Restaurant gastronomique"
        }
      ]
    }
  }
}