Ü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.localizationsgeparst. - 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 UnitaufSearch). - Auslieferungsstatus: Aktueller
Enabled- oderDisabled-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,ApprovedoderRejected).
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) oderNo(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
- 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.
- 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_idist 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 derdefault_locale-String oder daslocalizations-Array mit einer übereinstimmenden Sprache. - Abhilfe: Geben Sie sowohl den
default_localeals 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_addressfehlt der Stringdefault_localeoder das Arraylocalizations. - Abhilfe: Geben Sie sowohl die
default_localeals 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
descriptionenthalten ist, fehlt entwederdefault_localeoder die entsprechende Lokalisierung. - Abhilfe: Geben Sie sowohl
default_localeals 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 Wertlatitudeoderlongitude. - Abhilfe: Geben Sie sowohl
latitudeals auchlongitudeals Gleitkommazahlen im Standard-WGS84-Dezimalgradformat an.
{
"location": {
"latitude": 37.422,
"longitude": -122.084
}
}
6. Fehlende strukturierte Postanschrift (location.address)
- Ursache: Im Objekt
location.addressfehlen obligatorische Adresskomponenten (country,localityoderpostal_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_categoryist vorhanden, aberdefault_localefehlt, ist leer oder stimmt mit keinem Eintrag im Arraylocalizationsüberein. - Abhilfe:Geben Sie ein gültiges BCP 47-Sprach-Tag für
default_localean 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_rangesfehltopen_dayoder er ist aufDAY_OF_WEEK_UNSPECIFIEDfestgelegt. - 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_rangesfehlt das Objektopen_time. - Abhilfe: Geben Sie
open_timemithours(0–23) undminutes(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_rangesfehltclose_dayoder er ist aufDAY_OF_WEEK_UNSPECIFIEDfestgelegt. - 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_rangesfehlt das Objektclose_time. - Abhilfe: Geben Sie
close_timemithours(0–23) undminutes(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_pageshat einen leeren, null- oder fehlendenbrand_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_pagesfehltdefault_urloder 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_pagesfehlt das Feldurloder 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_pagesfehlt das Arraylocalesoder es ist leer. - Abhilfe:Geben Sie im Array
localesmindestens 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.0und90.0(jeweils einschließlich) sein. - Längengrad außerhalb des zulässigen Bereichs: Der Längengrad muss eine Gleitkommazahl zwischen
-180.0und180.0(einschließlich) sein. - Null Island (0,0): Wenn Sie
0.0, 0.0oder 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://oderhttps://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, nichtexample.com/local/123oderwww.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
GooglebotundGooglebot-Imagezulä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_idhat. - 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:
- 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_ENTITYmit derselben Gruppen-ID für Probleminformationen, um allepoi_id-Einträge aufzurufen, die mit derselben Google-Entität übereinstimmen. - 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 einzigerpoi_id-Eintrag für dieses Unternehmen eingereicht wird. - 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:
- Wichtige Attribute prüfen:Achten Sie darauf, dass
name,display_address,location.address,url,telephoneundlocation.latitude/location.longitudedes Lokals den tatsächlichen Standort der Unterkunft genau widerspiegeln. - Informationen zu Übereinstimmungen prüfen:Sehen Sie sich die Spalte Informationen zu Übereinstimmungen in der Inventaransicht an, um mögliche Orte zu finden.
- 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_timemuss vorclose_timeliegen (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_dayden 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_pricekleiner oder gleichmax_priceist. - Währungsabweichung: Prüfen Sie, ob sowohl
min_price.currency_codeals auchmax_price.currency_codemit 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 mehrerenbrand_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_pagesfü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 inlocalized_landing_pagesfü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://oderhttps://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"
}
]
}
}
}