Inventaransicht

Übersicht

Mit dem Inventar-Viewer im Actions Center können Sie den Status der Datenaufnahme, den Status des Ortsabgleichs und die Berechtigung zur Auslieferung Ihres lokalen Inventars für POIs einsehen.

In dieser Ansicht werden Probleme unabhängig von einzelnen Aufnahmen angezeigt. Es handelt sich um zustandsorientierte Probleme, die den aktiven Bereitstellungsstatus der einzelnen Dienstleister darstellen und alle möglichen Fehlermodi (Richtlinien, Warnungen, Fehler usw.) enthalten, die auftreten können.

Möglichkeiten mit diesem Tool:

  • Suchen und prüfen Sie alle aufgenommenen Dienstanbieter und ihren Live-Bereitstellungsstatus.
  • Fehler bei der Datenvalidierung und Verstöße gegen Inhaltsrichtlinien diagnostizieren
  • Einsprüche gegen Richtlinienverstöße einreichen und nachverfolgen.
  • Diagnoseergebnisse für den Abgleich von Dienstleistern prüfen und manuelle Abgleichsvorschläge einreichen.
  • Prüfen Sie die JSON-Rohdaten-Nutzlasten aus Ihren letzten Feedaufnahmen.

Spalten der Inventartabelle

In der Listenansicht werden alle hochgeladenen Dienstleister aus Ihrem POI-Feed (Point of Interest) angezeigt, hierarchisch nach Entität sortiert. Sie können nach lokaler POI-ID, Übereinstimmungsstatus, Integration und Oberfläche filtern.

Spalten der Zusammenfassungstabelle Beschreibung
Lokale POI-ID Die eindeutige Kennung für die lokale Unterkunft, die im Feed angegeben ist (poi_id).
Name des POI (lokal) Der lokalisierte Name der lokalen Unterkunft, die aus dem Feed extrahiert wurde.
Abgleichstatus Gibt an, ob der POI einem Google Maps-Eintrag zugeordnet wurde:
• Ja (grünes Badge): Der POI wurde einem Google Maps-Ort zugeordnet.
• Nein (rotes Logo): Nicht abgeglichen; Überprüfung oder Abgleichsvorschlag erforderlich.
Integration Dies ist die Integration des lokalen Aggregator-Bereichs.
Oberfläche Die Zieloberfläche für die Bereitstellung (z.B. die Suche).
Auslieferungsstatus Der Echtzeitstatus der Berechtigung zur Auslieferung:
• Aktiviert (grüne Anzeige): Berechtigt und aktiv auf Google-Plattformen auslieferbar.
• Deaktiviert (rote Anzeige): Die Auslieferung ist aufgrund von Validierungsfehlern, Richtlinienverstößen oder einem nicht übereinstimmenden Status blockiert.
Fehler Anzahl der aktiven Probleme mit dem Schweregrad „Fehler“. Wenn für eine Unterkunft ein Fehler vorliegt, kann sie auf keiner Oberfläche präsentiert werden.
Warnungen Anzahl der aktiven Probleme mit dem Schweregrad „Warnung“. Properties mit Warnungen können weiterhin ausgeliefert werden.
Match-Informationen Enthält die Schaltfläche „Übereinstimmung bearbeiten“, über die das interaktive Steuerfeld zur Korrektur von Übereinstimmungen geöffnet wird.

POI-Detailansicht

Wenn Sie in der Listenansicht auf eine POI-ID klicken, gelangen Sie zur Detailseite der Entität.

Die Detailansicht besteht aus vier maximierbaren Abschnitten:

1. Allgemeine Informationen

Fasst allgemeine Entitätsmetadaten zusammen:

  • POI-Name: Name der Einrichtung, wie aus data[].name.localizations geparst.
  • POI-ID: Eindeutige Kennung der Partnerentität (poi_id).
  • Datenquelle: Der genaue Feed-Dateiname, aus dem diese Entität aufgenommen wurde.

2. Serving-Status

Hier wird die Auslieferungseignung nach Integration und Zielfläche aufgeschlüsselt:

  • Integration und Oberfläche: Branche und Zieloberfläche (z.B. Local Aggregator Unit auf Search).
  • Auslieferungsstatus: Aktueller Enabled- oder Disabled-Status.
  • Probleme: Zeigt Problem-Badges für alle aktiven Fehler oder Warnungen an (z.B. Unmatched entity, Policy Violation). Wenn Sie auf ein Problem-Badge klicken, wird der Bereich „Problemdetails“ geöffnet.
  • Einsprüche: Zeigt Überschreibungs- oder Einspruchsstatus an (Under review, Approved oder Rejected).

3. Informationen zum Abgleich

Zeigt Diagnoseinformationen zum Ortsabgleich an:

  • Übereinstimmungseingabe: Die formatierte physische Adresse, die aus Ihrem Feed geparst wurde (street_address, locality, region, postal_code, country).
  • Übereinstimmungstyp: Der Mechanismus zur Auflösung von Übereinstimmungen (z.B. Location).
  • Match namespace: Die Branche, auf die sich die Änderungen am Abgleich beziehen (z.B. Local Aggregator Unit).
  • Übereinstimmungsstatus: Yes (Grün) oder No (Rot).
  • Übereinstimmungsausgabe: Der aufgelöste Google Maps-Ortsname, die Adresse und die Orts-ID.
  • Übereinstimmung bearbeiten: Schaltfläche zum Öffnen des Dialogfelds für den Übereinstimmungsvorschlag.

4. Roh-JSON

Bietet eine interaktive Codeansicht mit Zeilennummern und Syntaxhervorhebung, die die vollständige geparste JSON-Nutzlast (item_proto) für schnelles Debugging und Verifizieren des Schemas anzeigt. Die hier angezeigten Datenwerte entsprechen den Werten, die aus dem POI-Feed empfangen wurden.

Probleme und Triage-Workflow

Entitäten, die mit Problemen gekennzeichnet sind, werden entweder deaktiviert (wenn sie mit einem FEHLER gekennzeichnet sind) oder herabgestuft (wenn sie mit einer WARNUNG gekennzeichnet sind). Gegen Entitätsprobleme mit einer Warnung kann kein Einspruch eingelegt werden. Warnungen können durch Behebung des zugrunde liegenden Problems behoben werden.

Problemtypen: Einspruch möglich oder nicht möglich

  1. Probleme, gegen die kein Einspruch eingelegt werden kann (technische Probleme, Probleme mit der Datenqualität und Warnungen):
    • Verursacht durch Schemafehler, fehlende Pflichtfelder, ungültige Koordinaten, fehlerhafte URLs, doppelte IDs oder nicht blockierende Inhaltswarnungen (z. B. Unternehmensnamen in nicht standardmäßigen Sprachen oder beliebige Sprachen für Beschreibungen, angezeigte Adressen und Einrichtungskategorien).
    • Lösung: Partner müssen die zugrunde liegenden Daten in ihrem Quellfeed korrigieren und eine aktualisierte Feeddatei hochladen.
  2. Probleme, bei denen Einspruch eingelegt werden kann (Blockieren von Inhalten und Richtlinienverstöße):
    • Wird ausgelöst, wenn erforderliche Text- oder Bild-Assets der Unterkunft die automatisierten Filter für die Inhaltssicherheit mit dem Schweregrad FEHLER nicht bestehen.
    • Lösung: Wenn die Inhalte den Plattformrichtlinien entsprechen, können Partner im Actions Center neben dem Problem auf den Button Einspruch einlegen klicken, um Einspruch einzulegen. Partner müssen einen Grund und eine Begründung angeben. Unser Einspruchsteam prüft die Anträge und genehmigt sie oder lehnt sie ab. Sie werden über das Tool und per E‑Mail über die Entscheidung informiert.

Katalog mit Problemen bei lokalen Aggregator-Bereichen

In der folgenden Tabelle sind alle Validierungsfehler und Richtlinienproblemcodes für Integrationen von lokalen Aggregator-Bereichen aufgeführt:

Problembeschreibung Schweregrad Problemcode Betroffenes Feld / betroffene Argumente Ist Einspruch möglich? Maßnahme / relevante Richtlinie
Fehlende POI-ID FEHLER MISSING_REQUIRED_FIELD poi_id Nein Geben Sie eine eindeutige poi_id an. Weitere Informationen finden Sie in der Spezifikation für POI-Feeds.
Fehlende Standardsprache für das Feld „name“ FEHLER MISSING_REQUIRED_FIELD name.default_locale Nein Geben Sie einen gültigen BCP 47-Sprachcode für die Standardsprache an. Siehe Mehrsprachige Unterstützung.
Keine Standardlokalisierung für das Feld „name“ gefunden FEHLER MISSING_REQUIRED_FIELD name.localizations Nein Geben Sie einen Wert für den lokalisierten Namen des POI an, der der deklarierten Sprache default_locale entspricht.
Fehlende Standardsprache für das Feld „description“ FEHLER MISSING_REQUIRED_FIELD description.default_locale Nein Geben Sie eine gültige BCP 47-Standardsprache für die Beschreibung der Unterkunft an.
Keine Standardlokalisierung für das Feld „description“ gefunden FEHLER MISSING_REQUIRED_FIELD description.localizations Nein Geben Sie einen Beschreibungstext in der angegebenen Sprache (default_locale) an.
Fehlende Standardsprache für das Feld „display_address“ FEHLER MISSING_REQUIRED_FIELD display_address.default_locale Nein Geben Sie eine gültige BCP 47-Standard-Spracheinstellung für die angezeigte Adresse an.
Keine Standardlokalisierung für das Feld „display_address“ gefunden FEHLER MISSING_REQUIRED_FIELD display_address.localizations Nein Geben Sie einen formatierten Adresstext in der angegebenen Sprache (default_locale) an.
Maximale Anzahl von Bildern überschritten WARNUNG EXCEEDED_MAX_COUNT images Nein Beschränken Sie die Bildeinträge auf maximal 5 Bilder pro POI. Überzählige Bilder werden verworfen.
Ungültige Breitengradkoordinate FEHLER INVALID_LATLNG location.latitude Nein Geben Sie einen gültigen Breitengrad zwischen -90.0 und +90.0 ein. Siehe Definition von geografischen Koordinaten.
Ungültige Längengradkoordinate FEHLER INVALID_LATLNG location.longitude Nein Geben Sie einen gültigen Längengrad zwischen -180.0 und +180.0 ein. Siehe Definition von geografischen Koordinaten.
Fehlende Breitengradkoordinate FEHLER MISSING_REQUIRED_FIELD location.latitude Nein Geben Sie den Breitengrad an, um das Koordinatenpaar zu vervollständigen. Siehe Definition von geografischen Koordinaten.
Längengradkoordinate fehlt FEHLER MISSING_REQUIRED_FIELD location.longitude Nein Geben Sie den Längengradwert an, um das Koordinatenpaar zu vervollständigen. Siehe Definition von geografischen Koordinaten.
Fehlende oder unstrukturierte Adresse FEHLER MISSING_REQUIRED_FIELD location.address Nein Geben Sie eine strukturierte Postanschrift mit Straße, Ort, Postleitzahl und Land an.
Fehlerhafte oder ungültige URL FEHLER INVALID_ATTRIBUTE_VALUE url Nein Achten Sie darauf, dass die Landingpage-URL ein unterstütztes HTTP-/HTTPS-Protokoll und eine gültige Syntax verwendet.
Ungültiges oder nicht erreichbares Bild WARNUNG INVALID_IMAGE image.url Nein Prüfen Sie, ob Bild-URLs öffentlich erreichbar sind und keine Authentifizierung erfordern oder 4xx-/5xx-Fehler zurückgeben.
Doppelte POI-ID FEHLER DUPLICATE_ENTITY poi_id Nein Jede poi_id muss in der Feed-Nutzlast eindeutig sein. Doppelte Einträge entfernen
Doppelte übereinstimmende Entität FEHLER DUPLICATE_MATCHED_ENTITY POI Nein Entfernen Sie doppelte Einträge aus Ihrem Feed oder verwenden Sie das Tool POI Entity Matching, um einzelne Unternehmen mit ihren unabhängigen Google Maps-Einträgen abzugleichen.
Nicht übereinstimmende Entität FEHLER UNMATCHED_ENTITY POI Nein Gleichen Sie den POI mithilfe des Tools POI-Entitätsabgleich mit einem Google Maps-Orteintrag ab.
Verstoß gegen die Richtlinien für Bilder FEHLER SAFE_SEARCH_POLICY_VIOLATION_IMAGE image Ja Entfernen oder ersetzen Sie das markierte Bild oder klicken Sie auf Einspruch einlegen, um eine Begründung einzureichen. Weitere Informationen finden Sie in der Inhaltsrichtlinie für Bilder in der Google Suche.
Text policy violation - Default Name FEHLER SAFE_SEARCH_POLICY_VIOLATION_TEXT name.localizations.*.text Ja Entfernen oder ersetzen Sie den markierten Namenstext oder klicken Sie auf Einspruch einlegen. Richtlinie für Textinhalte in der Google Suche
Richtlinienverstoß bei Text – nicht standardmäßiger Name WARNUNG SAFE_SEARCH_POLICY_VIOLATION_TEXT name.localizations.*.text Nein Entfernen oder ersetzen Sie den markierten Namenstext. Richtlinie für Textinhalte in der Google Suche
Richtlinienverstoß bei Text – Beschreibung WARNUNG SAFE_SEARCH_POLICY_VIOLATION_TEXT description.localizations.*.text Nein Entfernen oder ersetzen Sie den markierten Beschreibungstext. Richtlinie für Textinhalte in der Google Suche
Verstoß gegen die Richtlinien für Textanzeigen – angezeigte Adresse WARNUNG SAFE_SEARCH_POLICY_VIOLATION_TEXT display_address.localizations.*.text Nein Entfernen oder ersetzen Sie den Text der gekennzeichneten angezeigten Adresse. Richtlinie für Textinhalte in der Google Suche
Fehlende Standardsprache für die Kategorie „Einrichtung“ FEHLER MISSING_REQUIRED_FIELD local_data.establishment_category.default_locale Nein Geben Sie einen Wert für die lokalisierte Einrichtungskategorie des POI an, der der deklarierten Sprache default_locale entspricht.
Fehlender Tag bei den Öffnungszeiten FEHLER MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.open_day Nein Geben Sie einen gültigen Tag für die Öffnungszeiten an.
Fehlende Öffnungszeit FEHLER MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.open_time Nein Geben Sie eine gültige Öffnungszeit an.
Fehlende Öffnungszeiten (Ruhetag) FEHLER MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.close_day Nein Geben Sie einen gültigen Tag für die Schließung der Öffnungszeiten an.
Fehlende Schließzeit FEHLER MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.close_time Nein Geben Sie eine gültige Schließzeit für die Öffnungszeiten an.
Öffnungszeiten: Öffnungszeit ist später als Schließzeit FEHLER NOT_LESS_THAN_FIELD local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time Nein Geben Sie ein gültiges Paar aus Öffnungs- und Schließzeit an. Die Öffnungszeit muss vor der Schließzeit liegen.
Der Mindestwert der Preisspanne ist größer als der Höchstwert FEHLER INVALID_PRICE_RANGE local_data.price_range.min_price, local_data.price_range.max_price Nein Geben Sie eine gültige Preisspanne an, wobei der Mindestpreis niedriger als der Höchstpreis sein muss.
Fehlende Marken-ID FEHLER MISSING_REQUIRED_FIELD local_data.brand_landing_pages.brand_id Nein Geben Sie eine gültige Marken-ID an.
Duplizierte Marken-ID innerhalb eines POI FEHLER DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.brand_id Nein Jede brand_id muss in der POI-Nutzlast eindeutig sein. Doppelte Einträge entfernen
Fehlende Standard-URL der Marke FEHLER MISSING_REQUIRED_FIELD local_data.brand_landing_pages.default_url Nein Geben Sie eine gültige Standard-URL für die Marke an.
Fehlerhafte oder ungültige Marken-URL FEHLER INVALID_ATTRIBUTE_VALUE local_data.brand_landing_pages.default_url Nein Achten Sie darauf, dass die Standard-URL der Marke ein unterstütztes HTTP-/HTTPS-Protokoll und eine gültige Syntax verwendet.
Fehlende lokalisierte Landingpage-URL für die Marke FEHLER MISSING_REQUIRED_FIELD local_data.brand_landing_pages.localized_landing_pages.url Nein Geben Sie eine gültige URL für die lokalisierte Landingpage an.
Fehlerhafte oder ungültige URL der lokalisierten Landingpage für die Marke FEHLER INVALID_ATTRIBUTE_VALUE local_data.brand_landing_pages.localized_landing_pages.url Nein Achten Sie darauf, dass die Landingpage-URL ein unterstütztes HTTP-/HTTPS-Protokoll und eine gültige Syntax verwendet.
Doppelt vorhandene markenspezifische lokalisierte Landingpage-URL FEHLER DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.localized_landing_pages.url Nein Jede url muss für die lokalisierten Landingpages des POI eindeutig sein. Doppelte Einträge entfernen
Gebietsschema für lokalisierte Landingpage der Marke fehlt FEHLER MISSING_REQUIRED_FIELD local_data.brand_landing_pages.localized_landing_pages.locales Nein Geben Sie eine gültige Gruppe von Sprachen für die lokalisierte Landingpage an.
Doppelt vorhandene Sprache für die lokalisierte Landingpage der Marke FEHLER DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.localized_landing_pages.locales Nein Jede locale muss für die lokalisierten Landingpages des POI eindeutig sein. Doppelte Einträge entfernen
Richtlinienverstoß bei Text – Kategorie „Einrichtung“ WARNUNG SAFE_SEARCH_POLICY_VIOLATION_TEXT local_data.establishment_category.localizations.*.text Nein Entfernen oder ersetzen Sie den Text der gemeldeten Kategorie. Richtlinie für Textinhalte in der Google Suche

Problemcodes

In den folgenden Abschnitten finden Sie detaillierte Ursachen und Abhilfemaßnahmen für jeden Problemcode.

Pflichtfeld fehlt

Problemcode: MISSING_REQUIRED_FIELD
Schweregrad: Fehler (Auslieferung wird blockiert)
Einspruch möglich: Nein (Problem durch Aktualisierung des POI-Feeds beheben)

Dieser Fehler tritt auf, wenn bei einer aufgenommenen Entität mindestens ein obligatorisches Attribut fehlt, das gemäß der Feedspezifikationen für POI erforderlich ist.

Sehen Sie im Bereich „Problemdetails“ nach, welche Property fehlt, und wenden Sie dann die entsprechende Korrektur an:

1. POI-ID fehlt (poi_id)

  • Ursache: Das Feld poi_id ist leer, null oder fehlt im Stamm-Entitätsobjekt.
  • Abhilfe: Geben Sie eine persistente, eindeutige Stringkennung für das Attribut an.
{
  "poi_id": "test_restaurant_1"
}

2. Standardsprache oder lokalisierter Name fehlt (name)

  • Ursache: Im name-Objekt fehlt der default_locale-String oder das localizations-Array mit einer übereinstimmenden Sprache.
  • Abhilfe: Geben Sie sowohl den default_locale als auch mindestens einen Lokalisierungseintrag an, der mit diesem Gebietsschema übereinstimmt.
{
  "name": {
    "localizations": [
      {
        "locale": "en",
        "text": "Tasty Bites Test Restaurant"
      }
    ],
    "default_locale": "en"
  }
}

3. Fehlende Standardsprache oder lokalisierte Adresse (display_address)

  • Ursache: Im Objekt display_address fehlt der String default_locale oder das Array localizations.
  • Abhilfe: Geben Sie sowohl die default_locale als auch mindestens einen Lokalisierungseintrag an, der dieser Sprache für die formatierte Adresse entspricht.
{
  "display_address": {
    "localizations": [
      {
        "locale": "en",
        "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
      }
    ],
    "default_locale": "en"
  }
}

4. Standardsprache oder lokalisierte Beschreibung fehlt (description)

  • Ursache: Wenn das Objekt description enthalten ist, fehlt entweder default_locale oder die entsprechende Lokalisierung.
  • Abhilfe: Geben Sie sowohl default_locale als auch mindestens einen Lokalisierungseintrag an, der dieser Sprache für die Beschreibung entspricht.
{
  "description": {
    "localizations": [
      {
        "locale": "en",
        "text": "A mock restaurant for testing the POI feed ingestion."
      }
    ],
    "default_locale": "en"
  }
}

5. Fehlende geografische Koordinaten (location.latitude / location.longitude)

  • Ursache: Im location-Objekt fehlt entweder der numerische Wert latitude oder longitude.
  • Abhilfe: Geben Sie sowohl latitude als auch longitude als Gleitkommazahlen im Standard-WGS84-Dezimalgradformat an.
{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

6. Fehlende strukturierte Postanschrift (location.address)

  • Ursache: Im Objekt location.address fehlen obligatorische Adresskomponenten (country, locality oder postal_code).
  • Abhilfe: Füllen Sie das Objekt für die strukturierte Postanschrift gemäß den ISO-Standards aus.
{
  "location": {
    "address": {
      "country": "US",
      "locality": "Mountain View",
      "postal_code": "94043",
      "street_address": "1600 Amphitheatre Pkwy"
    }
  }
}

7. Standardsprache für die Kategorie der Einrichtung fehlt (local_data.establishment_category.default_locale)

  • Ursache: Das Objekt local_data.establishment_category ist vorhanden, aber default_locale fehlt, ist leer oder stimmt mit keinem Eintrag im Array localizations überein.
  • Abhilfe:Geben Sie ein gültiges BCP 47-Sprach-Tag für default_locale an und stellen Sie mindestens einen lokalisierten String bereit, der diesem Gebietsschema entspricht.
{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        }
      ]
    }
  }
}

8. Fehlender Öffnungstag (local_data.business_hours.time_ranges.open_day)

  • Ursache: In einem Eintrag in local_data.business_hours.time_ranges fehlt open_day oder er ist auf DAY_OF_WEEK_UNSPECIFIED festgelegt.
  • Abhilfe: Geben Sie einen gültigen String für den Wochentag an (z.B. "MONDAY", "TUESDAY" usw.).
{
  "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. Fehlende Öffnungszeit (local_data.business_hours.time_ranges.open_time)

  • Ursache: In einem Eintrag in local_data.business_hours.time_ranges fehlt das Objekt open_time.
  • Abhilfe: Geben Sie open_time mit hours (0–23) und minutes (0–59) an.
{
  "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. Fehlender Tag für die Schließzeit (local_data.business_hours.time_ranges.close_day)

  • Ursache: In einem Eintrag in local_data.business_hours.time_ranges fehlt close_day oder er ist auf DAY_OF_WEEK_UNSPECIFIED festgelegt.
  • Abhilfe: Geben Sie einen gültigen String für den Wochentag an (z.B. "MONDAY", "TUESDAY" usw.).
{
  "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. Fehlende Schließzeit der Öffnungszeiten (local_data.business_hours.time_ranges.close_time)

  • Ursache: In einem Eintrag in local_data.business_hours.time_ranges fehlt das Objekt close_time.
  • Abhilfe: Geben Sie close_time mit hours (0–23) und minutes (0–59) an.
{
  "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. Fehlende Marken-ID (local_data.brand_landing_pages.brand_id)

  • Ursache: Ein Eintrag in local_data.brand_landing_pages hat einen leeren, null- oder fehlenden brand_id.
  • Abhilfe:Geben Sie eine nicht leere String-ID an, die mit der Konfiguration Ihrer registrierten Partnermarke übereinstimmt.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

13. Fehlende Standard-URL für die Marke (local_data.brand_landing_pages.default_url)

  • Ursache: In einem Eintrag in local_data.brand_landing_pages fehlt default_url oder es handelt sich um einen leeren String.
  • Abhilfe:Geben Sie eine gültige Fallback-HTTP/HTTPS-Landingpage-URL für Nutzer an, deren Sprache nicht mit lokalisierten URLs übereinstimmt.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

14. Fehlende lokalisierte Landingpage-URL für die Marke (local_data.brand_landing_pages.localized_landing_pages.url)

  • Ursache: Bei einem Element in localized_landing_pages fehlt das Feld url oder es ist leer.
  • Abhilfe: Geben Sie eine gültige, vollständig qualifizierte HTTP-/HTTPS-URL für die lokalisierte Landingpage an.
{
  "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. Fehlende Sprache für die lokalisierte Landingpage der Marke (local_data.brand_landing_pages.localized_landing_pages.locales)

  • Ursache: Bei einem Element in localized_landing_pages fehlt das Array locales oder es ist leer.
  • Abhilfe:Geben Sie im Array locales mindestens einen gültigen BCP 47-Sprach- oder Gebietsschemacode an (z.B. ["en-US"]).
{
  "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"]
          }
        ]
      }
    ]
  }
}

Maximale Anzahl von Bildern überschritten

Problemcode: EXCEEDED_MAX_COUNT
Schweregrad: Warnung
Einspruch möglich: Nein (Problem durch Aktualisieren der Feed-Nutzlast beheben)

Dieser Fehler tritt auf, wenn eine POI-Entitätsnutzlast mehr als 5 Bildobjekte im images-Array enthält.

Behebung:

  • Kürzen Sie das images-Array so, dass es höchstens fünf hochwertige, repräsentative Fotos der Unterkunft enthält.
  • Bilder, die das Limit von 5 überschreiten, werden verworfen.

Ungültige geografische Koordinaten

Problemcode: INVALID_LATLNG
Schweregrad: Fehler (Auslieferung blockiert)
Einspruch möglich: Nein (Problem lässt sich durch Aktualisieren der Feed-Nutzlast beheben)

Dieser Fehler tritt auf, wenn die in location.latitude oder location.longitude angegebenen geografischen Koordinaten außerhalb der gültigen sphärischen Grenzen liegen oder nicht ausgefüllte Nullkoordinaten darstellen.

Häufige Ursachen und Abhilfe:

  • Breitengrad außerhalb des zulässigen Bereichs: Der Breitengrad muss eine Gleitkommazahl zwischen -90.0 und 90.0 (jeweils einschließlich) sein.
  • Längengrad außerhalb des zulässigen Bereichs: Der Längengrad muss eine Gleitkommazahl zwischen -180.0 und 180.0 (einschließlich) sein.
  • Null Island (0,0): Wenn Sie 0.0, 0.0 oder Platzhalter-Ganzzahlen (z. B. 999, 999) einreichen, werden die Koordinaten abgelehnt.
  • Vertauschte Koordinaten: Prüfen Sie, ob Breiten- und Längengrad in Ihrer Serialisierungspipeline vertauscht sind.

Beispiel für eine gültige Nutzlast:

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

Fehlerhafte oder ungültige URL

Problemcode: INVALID_ATTRIBUTE_VALUE
Schweregrad: Fehler (Auslieferung blockiert)
Einspruch möglich: Nein (Problem lässt sich durch Aktualisieren der Feed-Nutzlast beheben)

Dieser Fehler tritt auf, wenn ein Attributwert die Schemavalidierung nicht besteht. Am häufigsten ist dies der Fall, wenn die Landingpage-URL eines Partners oder eine Bild-URL syntaktisch ungültig ist.

Anforderungen:

  • Protokoll: URLs müssen explizit http:// oder https:// angeben (HTTPS wird dringend empfohlen).
  • Codierung: URLs, die Sonderzeichen, Leerzeichen oder Nicht-ASCII-Zeichen enthalten, müssen ordnungsgemäß prozentcodiert sein (RFC 3986).
  • Kanonische Domain: Die Domain muss vollständig qualifiziert sein (z. B. https://example.com/local/123, nicht example.com/local/123 oder www.example).

Beispiel für eine gültige Nutzlast:

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

Ungültiges oder nicht erreichbares Bild

Problemcode: INVALID_IMAGE
Schweregrad: Warnung
Einspruch möglich: Nein (Problem durch Aktualisieren der Feed-Nutzlast beheben)

Diese Warnung wird während der asynchronen Bildabrufphase angezeigt, wenn der Google-Crawler das Media-Asset von image.url nicht herunterladen, decodieren oder verifizieren kann. Das ungültige Bild wird zwar weggelassen, die Unterkunft kann aber weiterhin präsentiert werden.

Häufige Ursachen und Abhilfe:

  • HTTP-Fehler (404 / 403 / 500): Die Bild-URL gibt einen HTTP-Statuscode zurück, der nicht 200 ist. Achten Sie darauf, dass Bilder ohne Authentifizierung, Cookie-Walls oder IP-Zulassungslisten öffentlich zugänglich sind.
  • Blockierung durch robots.txt: Achten Sie darauf, dass Ihr Content Delivery Network (CDN) die User-Agents Googlebot und Googlebot-Image zulässt.
  • Nicht unterstütztes Dateiformat: Bilder müssen in Standard-Rasterformaten (JPEG, PNG, WebP) vorliegen. Animierte GIFs, SVGs und RAW-Kameraformate werden nicht unterstützt. Weitere Informationen finden Sie in unseren Richtlinien für Bilder.
  • SSL-Zertifikatsfehler: Prüfen Sie, ob der Hostserver des Bildes eine gültige SSL-Zertifikatskette hat.

Doppelte POI-ID

Problemcode: DUPLICATE_ENTITY
Schweregrad: Fehler (Auslieferung blockiert)
Einspruch möglich: Nein (Problem lässt sich durch Aktualisieren der Feed-Nutzlast beheben)

Dieser Fehler tritt auf, wenn derselbe poi_id-String mehrmals in einem einzelnen Feed-Dateisatz vorkommt.

Behebung:

  • Achten Sie darauf, dass jeder lokale Eintrag in Ihrem Feed eine eindeutige, deterministische poi_id hat.
  • Wenn eine lokale Unterkunft mehrere Zimmertypen oder Preise hat, fassen Sie diese unter einer einzigen Stamm-POI-Entität zusammen, anstatt doppelte Entitätseinträge mit identischen IDs zu erstellen.

Doppelte übereinstimmende Entität

Problemcode: DUPLICATE_MATCHED_ENTITY
Schweregrad: Fehler (Auslieferung wird blockiert)
Einspruch möglich: Nein (Problem lässt sich durch Aktualisieren der Feed-Nutzlast oder mithilfe von Tools für den Abgleich von POI-Entitäten beheben)

Dieser Fehler tritt auf, wenn zwei oder mehr unterschiedliche poi_id-Einträge in Ihrem Feed mit demselben kanonischen Google Maps-Ortseintrag übereinstimmen. Wenn mehrere Unternehmen derselben Google-Entität zugeordnet sind, werden alle kollidierenden Einträge blockiert, bis das Problem behoben ist.

Problemlösung:

  1. Kollidierende Properties identifizieren: Öffnen Sie den Ingestion Viewer (Ingestion > Verlauf), wählen Sie die letzte Aufnahme aus und maximieren Sie den Bereich Validierungen. Klicken Sie auf die Zeile DUPLICATE_MATCHED_ENTITY mit derselben Gruppen-ID für Probleminformationen, um alle poi_id-Einträge aufzurufen, die mit derselben Google-Entität übereinstimmen.
  2. Doppelte Einträge aus dem Feed entfernen:Wenn die kollidierenden poi_id-Einträge denselben physischen Unternehmensstandort darstellen, entfernen Sie die doppelten Einträge aus dem Feed, sodass nur ein einziger poi_id-Eintrag für dieses Unternehmen eingereicht wird.
  3. Falsche Zuordnungen für unabhängige Unternehmen korrigieren:Wenn die kollidierenden poi_id-Einträge separate, unabhängige Unternehmen darstellen, die fälschlicherweise derselben Google-Entität zugeordnet wurden, öffnen Sie das falsch zugeordnete Unternehmen in der Inventaransicht und klicken Sie auf Zuordnung bearbeiten, um den entsprechenden Google Maps-Ortseintrag auszuwählen oder vorzuschlagen. Eine detaillierte Anleitung finden Sie im Leitfaden POI-Entitätsabgleich.

Nicht zugeordnete Entität

Problemcode: UNMATCHED_ENTITY
Schweregrad: Fehler (Auslieferung wird blockiert)
Einspruch möglich: Nein (Verwenden Sie die Tools für den Abgleich von POI-Entitäten oder korrigieren Sie die Entitätsmetadaten)

Dieses Problem weist darauf hin, dass die Abgleichspipeline von Google Ihren lokalen Eintrag nicht mit einem kanonischen Ort in Google Maps abgleichen konnte.

Problemlösung:

  1. Wichtige Attribute prüfen:Achten Sie darauf, dass name, display_address, location.address, url, telephone und location.latitude/location.longitude des Lokals den tatsächlichen Standort der Unterkunft genau widerspiegeln.
  2. Informationen zu Übereinstimmungen prüfen:Sehen Sie sich die Spalte Informationen zu Übereinstimmungen in der Inventaransicht an, um mögliche Orte zu finden.
  3. Tool zur Korrektur von POI-Übereinstimmungen verwenden:Klicken Sie im Actions Center auf Übereinstimmung bearbeiten, um manuell nach der richtigen Google-Orts-ID zu suchen und sie zu bestätigen. Eine detaillierte Anleitung finden Sie im Leitfaden zum POI-Entitätsabgleich.

Verstoß gegen die Bildrichtlinien der Google Suche

Problemcode: SAFE_SEARCH_POLICY_VIOLATION_IMAGE
Schweregrad: FEHLER (Auslieferung blockiert)
Einspruch möglich: Ja

Relevante Richtlinienproblemcodes: Richtlinie für Bilder in Inhalten der Google Suche

Wenn Sie der Meinung sind, dass das Image fälschlicherweise gemeldet wurde (falsch positiv), klicken Sie im Bereich „Problemdetails“ auf Einspruch einlegen.

Verstoß gegen die Richtlinie für Textinhalte in der Google Suche – Name

Problemcode: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Schweregrad: Der Schweregrad variiert je nach Feld (siehe Details unten)
Betroffenes Feld: name.localizations.*.text
Einspruch möglich: Ja (nur FEHLER bei Standardsprache); Nein (Warnung bei nicht standardmäßiger Sprache)

  • Standardsprache (name.default_locale): FEHLER (Auslieferung blockiert). Der gesamte POI wird nicht mehr ausgeliefert. Wenn Sie der Meinung sind, dass der Text für den Standardnamen fälschlicherweise gekennzeichnet wurde (falsch positiv), klicken Sie im Bereich „Problemdetails“ auf Einspruch einlegen.
  • Nicht standardmäßiges Gebietsschema: Warnung (Auslieferung wird nicht blockiert). Nur die gemeldete Lokalisierung wird weggelassen, während der POI weiterhin ausgeliefert werden kann. Gegen Warnungen zu nicht standardmäßigen Sprachen kann kein Einspruch eingelegt werden. Sie können sie beheben, indem Sie die Feed-Nutzlast aktualisieren.

Hier finden Sie die entsprechenden Richtlinienproblemcodes: Richtlinie für Textinhalte in der Google Suche

Google Search Content Text policy violation - Description

Problemcode: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Schweregrad: Warnung (Auslieferung wird nicht blockiert)
Betroffenes Feld: description.localizations.*.text
Einspruch möglich: Nein (Problem durch Aktualisierung der Feednutzlast beheben)

Diese Warnung wird angezeigt, wenn Text in description.localizations wegen eines Verstoßes gegen die Inhaltsrichtlinien für die Google Suche gemeldet wird. Die gemeldete Lokalisierung der Beschreibung (oder das gesamte Feld description, wenn die Standard-Spracheinstellung gemeldet wird) wird weggelassen, der POI kann aber weiterhin ausgeliefert werden.

Hier finden Sie die entsprechenden Richtlinienproblemcodes: Richtlinie für Textinhalte in der Google Suche

Verstoß gegen die Inhaltsrichtlinien für die Google Suche – Angezeigte Adresse

Problemcode: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Schweregrad: Warnung (Auslieferung wird nicht blockiert)
Betroffenes Feld: display_address.localizations.*.text
Einspruch möglich: Nein (Problem durch Aktualisierung der Feednutzlast beheben)

Diese Warnung wird angezeigt, wenn der formatierte Adresstext in display_address.localizations Inhalte enthält, die gemäß der Inhaltsrichtlinie für die Google Suche verboten sind. Die markierte Adresslokalisierung (oder das gesamte display_address-Feld, wenn die Standard-Spracheinstellung markiert ist) wird zwar weggelassen, der POI kann aber weiterhin ausgeliefert werden.

Hier finden Sie die entsprechenden Richtlinienproblemcodes: Richtlinie für Textinhalte in der Google Suche

Die Öffnungszeit liegt nach der Schließzeit

Problemcode: NOT_LESS_THAN_FIELD
Schweregrad: Fehler (Auslieferung wird blockiert)
Betroffene Felder: local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time
Einspruch möglich: Nein (Problem durch Aktualisierung der Feednutzlast beheben)

Dieser Fehler tritt auf, wenn die Öffnungszeit open_time für dasselbe Tagesintervall nach oder gleich close_time ist.

Häufige Ursachen und Abhilfe:

  • Inversion am selben Tag:open_time muss vor close_time liegen (z.B. 09:00 bis 17:00).
  • Nachtschichten:Wenn ein Geschäft an einem Tag öffnet und nach Mitternacht am nächsten Tag schließt (z.B. 21:00 bis 02:00 Uhr), legen Sie für close_day den folgenden Tag fest (z.B. open_day: "FRIDAY", close_day: "SATURDAY").

Beispiel für eine gültige Nutzlast:

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

Der Mindestwert der Preisspanne ist größer als der Höchstwert

Problemcode: INVALID_PRICE_RANGE
Schweregrad: Fehler (Auslieferung wird blockiert)
Betroffene Felder: local_data.price_range.min_price, local_data.price_range.max_price
Einspruch möglich: Nein (Problem durch Aktualisierung der Feednutzlast beheben)

Dieser Fehler tritt auf, wenn der Wert von min_price den Wert von max_price überschreitet oder wenn für min_price und max_price unterschiedliche Währungscodes angegeben sind.

Häufige Ursachen und Abhilfe:

  • Invertierte Werte: Achten Sie darauf, dass min_price kleiner oder gleich max_price ist.
  • Währungsabweichung: Prüfen Sie, ob sowohl min_price.currency_code als auch max_price.currency_code mit demselben dreistelligen ISO 4217-Währungscode (z.B. "USD") übereinstimmen.

Beispiel für eine gültige Nutzlast:

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

Doppelte eindeutige Unterkunft innerhalb eines POI

Problemcode: DUPLICATE_UNIQUE_PROPERTY
Schweregrad: Fehler (Auslieferung blockiert)
Einspruch möglich: Nein (Problem lässt sich durch Aktualisieren der Feed-Nutzlast beheben)

Dieser Fehler tritt auf, wenn ein Feld oder Unterelement, das für eine einzelne POI-Entität eindeutig sein muss, doppelte Einträge enthält.

Prüfen Sie im Bereich „Problemdetails“, welches Attribut gegen die Eindeutigkeit verstößt:

1. Duplizierte Marken-ID innerhalb eines POI (local_data.brand_landing_pages.brand_id)

  • Ursache: Derselbe brand_id-String wird in mehreren brand_landing_pages-Einträgen für einen einzelnen POI angezeigt.
  • Abhilfe: Fassen Sie alle Landingpages für diese Marke in einem einzigen brand_landing_pages-Objekt zusammen.

Beispiel für eine gültige Nutzlast:

{
  "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. Duplizierte Landingpage-URL der Marke (local_data.brand_landing_pages.localized_landing_pages.url)

  • Ursache: Dieselbe Landingpage-URL ist mehrmals unter localized_landing_pages für dieselbe Marke definiert.
  • Abhilfe:Achte darauf, dass jeder URL-Eintrag eindeutig ist, oder verknüpfe mehrere Sprachen im locales-Array eines einzelnen URL-Eintrags.

Beispiel für eine gültige Nutzlast:

{
  "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. Duplizierte Sprache der lokalisierten Landingpage der Marke (local_data.brand_landing_pages.localized_landing_pages.locales)

  • Ursache: Derselbe Sprachcode (z.B. "en-US") wird in mehreren Einträgen in localized_landing_pages für dieselbe Marke wiederholt.
  • Abhilfe:Weisen Sie jedes Sprach-Tag genau einer lokalisierten Landingpage zu.

Beispiel für eine gültige Nutzlast:

{
  "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"]
          }
        ]
      }
    ]
  }
}

Fehlerhafte oder ungültige Marken-URL

Problemcode: INVALID_ATTRIBUTE_VALUE
Schweregrad: Fehler (Anzeigenbereitstellung blockiert)
Einspruch möglich: Nein (Problem durch Aktualisierung der Feed-Nutzlast beheben)
Betroffene Felder: local_data.brand_landing_pages.default_url, local_data.brand_landing_pages.localized_landing_pages.url

Dieser Fehler tritt auf, wenn die Standard-URL einer Marke oder die URL einer lokalisierten Landingpage die URI-Syntaxprüfung nicht besteht.

Anforderungen:

  • Protokoll: Es muss explizit http:// oder https:// angegeben werden (https:// ist für die Bereitstellung in der Produktion erforderlich).
  • Syntax: Muss eine gültige, prozentcodierte, RFC 3986-konforme URL mit einem voll qualifizierten Domainnamen sein.

Beispiel für eine gültige Nutzlast:

{
  "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"]
          }
        ]
      }
    ]
  }
}

Verstoß gegen die Inhaltsrichtlinien für die Google Suche – Kategorie „Einrichtung“

Problemcode: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Schweregrad: Warnung (Auslieferung wird nicht blockiert)
Einspruch möglich: Nein (Problem durch Aktualisierung der Feed-Nutzlast beheben)
Betroffenes Feld: local_data.establishment_category.localizations.*.text

Diese Warnung wird angezeigt, wenn der lokalisierte Text der Kategorie „Einrichtung“ die automatischen SafeSearch-Inhaltsfilter nicht besteht. Während die Lokalisierung der gemeldeten Einrichtungskategorie (oder das gesamte establishment_category-Feld, wenn die Standard-Spracheinstellung gemeldet wird) weggelassen wird, kann der POI weiterhin ausgeliefert werden.

Behebung:

  • Richtlinienkonformität:Entfernen oder ersetzen Sie den Text der markierten Einrichtungskategorie durch Standardbegriffe für Unternehmenskategorien, die den Inhaltsrichtlinien für die Google Suche entsprechen.

Beispiel für eine gültige Nutzlast:

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