Przegląd
Przeglądarka asortymentu w Centrum działań zapewnia wgląd w stan pozyskiwania, stan dopasowania miejsca i uprawnienia do wyświetlania lokalnego asortymentu w ciekawym miejscu.
Ta przeglądarka wyświetla problemy niezależnie od poszczególnych operacji pozyskiwania – problemy stanowe reprezentujące aktywny stan wyświetlania każdego dostawcy usług, w tym wszelkie możliwe tryby awarii (zasady, ostrzeżenia, błędy itp.), które mogą wystąpić.
za pomocą tego narzędzia możesz:
- Wyszukiwanie i sprawdzanie wszystkich dostawców usług i ich stanu wyświetlania na żywo.
- diagnozować błędy weryfikacji danych i naruszenia zasad dotyczących treści;
- Przesyłaj odwołania dotyczące naruszeń zasad i śledź ich stan.
- Sprawdzanie diagnostyki dopasowywania dostawców usług i przesyłanie propozycji ręcznego dopasowania.
- Sprawdź nieprzetworzone ładunki JSON z ostatnich przetworzeń kanału.
Kolumny tabeli asortymentu
Widok listy wyświetla wszystkich przesłanych dostawców usług z pliku danych o ciekawych miejscach, uporządkowanych hierarchicznie według podmiotu. Możesz filtrować według identyfikatora lokalnego miejsca, stanu dopasowania, integracji i platformy.
| Kolumny tabeli podsumowania | Opis |
|---|---|
| Identyfikator lokalnego miejsca | Unikalny identyfikator lokalnej usługi podany w pliku danych (poi_id). |
| Nazwa miejsca w języku lokalnym | Zlokalizowana nazwa właściwości lokalnej wyodrębniona z pliku danych. |
| Stan dopasowania | Wskazuje, czy ciekawe miejsce zostało dopasowane do wizytówki w Mapach Google: • Tak (zielona plakietka): dopasowano do miejsca w Mapach Google. • Nie (czerwona plakietka): brak dopasowania; wymaga sprawdzenia lub propozycji dopasowania. |
| Integracja | To jest integracja z jednostką agregującą lokalne oferty. |
| Surface | Docelowa platforma wyświetlania (np. wyszukiwarka). |
| Stan wyświetlania | Stan kwalifikowania się do wyświetlania w czasie rzeczywistym: • Włączone (zielony wskaźnik): kwalifikuje się do wyświetlania i jest aktywnie wyświetlane na platformach Google. • Wyłączone (czerwony wskaźnik): wyświetlanie jest zablokowane z powodu błędów weryfikacji, naruszeń zasad lub stanu niedopasowania. |
| Błędy | Liczba aktywnych problemów o poziomie ważności „Błąd”. Jeśli w przypadku danej usługi wystąpi jakikolwiek błąd, nie będzie ona mogła wyświetlać się na żadnej platformie. |
| Ostrzeżenia | Liczba aktywnych problemów o poziomie ważności Ostrzeżenie. Miejsca zakwaterowania z ostrzeżeniami nadal mogą się wyświetlać. |
| Informacje o meczu | Zawiera przycisk Edytuj dopasowanie, który otwiera interaktywny panel poprawiania dopasowania. |
Widok szczegółów ciekawego miejsca
Kliknięcie dowolnego identyfikatora ciekawego miejsca w widoku listy powoduje przejście na stronę z informacjami o danym elemencie.
Widok szczegółów składa się z 4 rozwijanych sekcji:
1. Informacje podstawowe
Podsumowuje metadane encji wysokiego poziomu:
- Nazwa ciekawego miejsca: nazwa firmy wyodrębniona z
data[].name.localizations. - Identyfikator miejsca: unikalny identyfikator podmiotu partnera (
poi_id). - Źródło danych: dokładna nazwa pliku danych, z którego została pobrana ta encja.
2. Stan wyświetlania
Podział możliwości wyświetlania według integracji i miejsca docelowego:
- Integracja i platforma: branża i platforma docelowa (np.
Local Aggregator UnitnaSearch). - Stan wyświetlania: bieżący stan
EnabledlubDisabled. - Problemy: wyświetla plakietki problemów dla wszystkich aktywnych błędów lub ostrzeżeń (np.
Unmatched entity,Policy Violation). Kliknięcie plakietki problemu powoduje otwarcie panelu szczegółów problemu. - Odwołania: wyświetla stany unieważnienia lub odwołania (
Under review,ApprovedlubRejected).
3. Informacje o dopasowaniu
Wyświetla diagnostykę dopasowywania miejsc:
- Dane wejściowe dopasowania: sformatowany adres pocztowy wyodrębniony z pliku danych (
street_address,locality,region,postal_code,country). - Typ dopasowania: mechanizm dopasowywania (np.
Location). - Przestrzeń nazw dopasowania: branża, do której będą stosowane zmiany dopasowania (np.
Local Aggregator Unit). - Stan dopasowania:
Yes(zielony) lubNo(czerwony). - Dane wyjściowe dopasowania: nazwa miejsca, adres i identyfikator miejsca w Mapach Google.
- Edytuj dopasowanie: przycisk otwierający okno propozycji dopasowania.
4. Nieprzetworzony kod JSON
Udostępnia interaktywną przeglądarkę kodu z numerami wierszy i wyróżnianiem składni, która wyświetla pełny przeanalizowany ładunek JSON (item_proto) w celu szybkiego debugowania i weryfikacji schematu. Wartości danych przedstawione tutaj będą odzwierciedlać wartości otrzymane z pliku danych o ważnych miejscach.
Przepływ pracy dotyczący problemów i klasyfikacji
Elementy, w których wykryto problemy, są wyłączone (jeśli oznaczono je jako BŁĄD) lub mają obniżoną jakość (jeśli oznaczono je jako OSTRZEŻENIE). Od ostrzeżeń dotyczących problemów z elementami nie można się odwołać. Można je rozwiązać, naprawiając problem, którego dotyczą.
Typy problemów: odwołanie możliwe i niemożliwe
- Problemy, od których nie można się odwołać (problemy techniczne, problemy z jakością danych i ostrzeżenia):
- Spowodowane błędami schematu, brakiem wymaganych pól, nieprawidłowymi współrzędnymi, uszkodzonymi adresami URL, zduplikowanymi identyfikatorami lub nieblokującymi ostrzeżeniami dotyczącymi treści (takimi jak nazwy firm w języku innym niż domyślny lub dowolne języki w opisach, adresach wyświetlanych i kategoriach placówek).
- Rozwiązanie: partnerzy muszą poprawić dane w źródłowym pliku danych i przesłać zaktualizowany plik danych.
- Problemy, od których można się odwołać (blokowanie treści i naruszenia zasad):
- Uruchamiany, gdy wymagane komponenty tekstowe lub graficzne usługi nie przejdą automatycznych filtrów bezpieczeństwa treści z poziomem ważności BŁĄD.
- Rozwiązanie: jeśli treści są zgodne z zasadami platformy, partnerzy mogą kliknąć przycisk Odwołaj się obok problemu w Centrum działań, aby przesłać odwołanie. Partnerzy muszą podać powód i uzasadnienie, a nasz zespół ds. odwołań sprawdzi i zatwierdzi lub odrzuci prośby. O podjętych decyzjach poinformujemy Cię za pomocą narzędzia i e-maila.
Katalog problemów z jednostką agregującą lokalnie
W tabeli poniżej znajdziesz pełny zestaw błędów weryfikacji i kodów problemów ze zgodnością z zasadami dotyczących integracji z jednostką agregującą:
| Opis problemu | Poziom ważności | Kod problemu | Pole, którego dotyczy problem / argumenty | Czy można się odwołać? | Działanie / odpowiednia zasada |
|---|---|---|---|---|---|
| Brak identyfikatora POI | ERROR | MISSING_REQUIRED_FIELD
|
poi_id
|
Nie | Podaj unikalną wartość: poi_id. Zobacz specyfikację pliku danych o ciekawych miejscach. |
| Brak domyślnych ustawień regionalnych w polu „name” | ERROR | MISSING_REQUIRED_FIELD
|
name.default_locale
|
Nie | Podaj prawidłowy kod języka w formacie BCP 47 dla domyślnych ustawień regionalnych. Zobacz Pomoc w wielu językach. |
| Nie znaleziono domyślnej lokalizacji dla pola „name” | ERROR | MISSING_REQUIRED_FIELD
|
name.localizations
|
Nie | Podaj wartość zlokalizowanej nazwy ciekawego miejsca zgodną z zadeklarowanym językiem (default_locale).
|
| Brak domyślnego języka w polu „description” | ERROR | MISSING_REQUIRED_FIELD
|
description.default_locale
|
Nie | Podaj prawidłowy domyślny język opisu usługi zgodny ze standardem BCP 47. |
| Nie znaleziono domyślnej lokalizacji dla pola „description” | ERROR | MISSING_REQUIRED_FIELD
|
description.localizations
|
Nie | Podaj tekst opisu zgodny z językiem: default_locale.
|
| Brak domyślnych ustawień regionalnych w polu „display_address” | ERROR | MISSING_REQUIRED_FIELD
|
display_address.default_locale
|
Nie | Określ prawidłowe domyślne ustawienia regionalne w formacie BCP 47 dla wyświetlanego adresu. |
| Nie znaleziono domyślnej lokalizacji dla pola „display_address” | ERROR | MISSING_REQUIRED_FIELD
|
display_address.localizations
|
Nie | Podaj sformatowany tekst adresu zgodny z zadeklarowanym językiem (default_locale).
|
| Przekroczono maksymalną liczbę obrazów | OSTRZEŻENIE | EXCEEDED_MAX_COUNT
|
images
|
Nie | Ogranicz liczbę zdjęć do maksymalnie 5 na każde ciekawe miejsce. Nadmiarowe obrazy są odrzucane. |
| Nieprawidłowa współrzędna szerokości geograficznej | ERROR | INVALID_LATLNG
|
location.latitude
|
Nie | Wpisz prawidłową szerokość geograficzną z zakresu od -90.0 do +90.0. Zobacz Definicja współrzędnych geograficznych.
|
| Nieprawidłowa współrzędna długości geograficznej | ERROR | INVALID_LATLNG
|
location.longitude
|
Nie | Wpisz prawidłową długość geograficzną z zakresu od -180.0 do +180.0. Zobacz Definicja współrzędnych geograficznych.
|
| Brak współrzędnej szerokości geograficznej | ERROR | MISSING_REQUIRED_FIELD
|
location.latitude
|
Nie | Podaj wartość szerokości geograficznej, aby uzupełnić parę współrzędnych. Zobacz Definicja współrzędnych geograficznych. |
| Brak współrzędnej długości geograficznej | ERROR | MISSING_REQUIRED_FIELD
|
location.longitude
|
Nie | Podaj wartość długości geograficznej, aby uzupełnić parę współrzędnych. Zobacz Definicja współrzędnych geograficznych. |
| Brak adresu lub adres nieustrukturyzowany | ERROR | MISSING_REQUIRED_FIELD
|
location.address
|
Nie | Podaj uporządkowany adres pocztowy, w tym ulicę, miejscowość, kod pocztowy i kraj. |
| Nieprawidłowy lub niepoprawny adres URL | ERROR | INVALID_ATTRIBUTE_VALUE
|
url
|
Nie | Upewnij się, że URL strony docelowej używa obsługiwanego protokołu HTTP/HTTPS i prawidłowej składni. |
| Nieprawidłowy lub niedostępny obraz | OSTRZEŻENIE | INVALID_IMAGE
|
image.url
|
Nie | Sprawdź, czy adresy URL obrazów są publicznie dostępne i nie wymagają uwierzytelnienia ani nie zwracają błędów 4xx/5xx. |
| Zduplikowany identyfikator miejsca | ERROR | DUPLICATE_ENTITY
|
poi_id
|
Nie | Upewnij się, że każdy identyfikator (poi_id) jest unikalny w całym pliku danych. usuniesz zduplikowane wpisy,
|
| Zduplikowany dopasowany element | ERROR | DUPLICATE_MATCHED_ENTITY
|
POI
|
Nie | Usuń z pliku danych zduplikowane wpisy lub użyj narzędzia Dopasowywanie elementów ciekawych miejsc, aby dopasować różne firmy do ich niezależnych wizytówek w Mapach Google. |
| Niedopasowany element | ERROR | UNMATCHED_ENTITY
|
POI
|
Nie | Dopasuj ciekawe miejsce do wizytówki miejsca w Mapach Google za pomocą narzędzia Dopasowywanie ciekawych miejsc. |
| Naruszenie zasad dotyczących obrazów | ERROR | SAFE_SEARCH_POLICY_VIOLATION_IMAGE
|
image
|
Tak | Usuń lub zastąp oznaczone zdjęcie albo kliknij Odwołaj się, aby przesłać uzasadnienie. Zobacz zasady dotyczące obrazów w treściach w wyszukiwarce Google. |
| Naruszenie zasad dotyczących tekstu – nazwa domyślna | ERROR | SAFE_SEARCH_POLICY_VIOLATION_TEXT
|
name.localizations.*.text
|
Tak | Usuń lub zastąp tekst oznaczonej nazwy albo kliknij Odwołaj się. Zobacz zasady dotyczące treści tekstowych w wyszukiwarce Google. |
| Naruszenie zasad dotyczących tekstu – nazwa inna niż domyślna | OSTRZEŻENIE | SAFE_SEARCH_POLICY_VIOLATION_TEXT
|
name.localizations.*.text
|
Nie | Usuń lub zastąp tekst oznaczonej nazwy. Zobacz zasady dotyczące treści tekstowych w wyszukiwarce Google. |
| Naruszenie zasad dotyczących tekstu – opis | OSTRZEŻENIE | SAFE_SEARCH_POLICY_VIOLATION_TEXT
|
description.localizations.*.text
|
Nie | Usuń lub zastąp oznaczony tekst opisu. Zobacz zasady dotyczące treści tekstowych w wyszukiwarce Google. |
| Naruszenie zasad dotyczących tekstu – wyświetlany adres | OSTRZEŻENIE | SAFE_SEARCH_POLICY_VIOLATION_TEXT
|
display_address.localizations.*.text
|
Nie | Usuń lub zastąp oznaczony tekst wyświetlanego adresu. Zobacz zasady dotyczące treści tekstowych w wyszukiwarce Google. |
| Brak domyślnych ustawień regionalnych dla kategorii placówki | ERROR | MISSING_REQUIRED_FIELD
|
local_data.establishment_category.default_locale
|
Nie | Podaj wartość zlokalizowanej kategorii placówki dla miejsca, które odpowiada zadeklarowanemu językowi default_locale.
|
| Brak dnia otwarcia w godzinach otwarcia | ERROR | MISSING_REQUIRED_FIELD
|
local_data.business_hours.time_ranges.open_day
|
Nie | Podaj prawidłowy dzień otwarcia w godzinach otwarcia. |
| Brak godziny otwarcia w godzinach pracy | ERROR | MISSING_REQUIRED_FIELD
|
local_data.business_hours.time_ranges.open_time
|
Nie | Podaj prawidłowe godziny otwarcia firmy. |
| Brak dnia zamknięcia w godzinach otwarcia | ERROR | MISSING_REQUIRED_FIELD
|
local_data.business_hours.time_ranges.close_day
|
Nie | Podaj prawidłowy dzień zamknięcia godzin otwarcia. |
| Brak godziny zamknięcia firmy | ERROR | MISSING_REQUIRED_FIELD
|
local_data.business_hours.time_ranges.close_time
|
Nie | Podaj prawidłową godzinę zamknięcia godzin otwarcia. |
| Godziny otwarcia: godzina otwarcia jest późniejsza niż godzina zamknięcia | ERROR | NOT_LESS_THAN_FIELD
|
local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time
|
Nie | Podaj prawidłową parę godzin otwarcia i zamknięcia, upewniając się, że godzina otwarcia jest wcześniejsza niż godzina zamknięcia. |
| Minimalna wartość przedziału cenowego jest większa niż wartość maksymalna | ERROR | INVALID_PRICE_RANGE
|
local_data.price_range.min_price, local_data.price_range.max_price
|
Nie | Podaj prawidłowy przedział cenowy, w którym cena minimalna jest niższa niż cena maksymalna. |
| Brak identyfikatora marki | ERROR | MISSING_REQUIRED_FIELD
|
local_data.brand_landing_pages.brand_id
|
Nie | Podaj prawidłowy identyfikator marki. |
| Zduplikowany identyfikator marki w miejscu | ERROR | DUPLICATE_UNIQUE_PROPERTY
|
local_data.brand_landing_pages.brand_id
|
Nie | Upewnij się, że każdy identyfikator (brand_id) jest unikalny w ramach danych miejsca. usuniesz zduplikowane wpisy,
|
| Brak domyślnego adresu URL marki | ERROR | MISSING_REQUIRED_FIELD
|
local_data.brand_landing_pages.default_url
|
Nie | Podaj prawidłowy domyślny adres URL marki. |
| Nieprawidłowy format lub nieprawidłowy adres URL marki | ERROR | INVALID_ATTRIBUTE_VALUE
|
local_data.brand_landing_pages.default_url
|
Nie | Upewnij się, że domyślny adres URL marki używa obsługiwanego protokołu HTTP/HTTPS i prawidłowej składni. |
| Brak adresu URL zlokalizowanej strony docelowej marki | ERROR | MISSING_REQUIRED_FIELD
|
local_data.brand_landing_pages.localized_landing_pages.url
|
Nie | Podaj prawidłowy adres URL zlokalizowanej strony docelowej. |
| Nieprawidłowy lub niepoprawny adres URL strony docelowej zlokalizowanej dla marki | ERROR | INVALID_ATTRIBUTE_VALUE
|
local_data.brand_landing_pages.localized_landing_pages.url
|
Nie | Upewnij się, że adres URL zlokalizowanej strony docelowej używa obsługiwanego protokołu HTTP/HTTPS i prawidłowej składni. |
| Zduplikowany URL strony docelowej zlokalizowanej dla marki | ERROR | DUPLICATE_UNIQUE_PROPERTY
|
local_data.brand_landing_pages.localized_landing_pages.url
|
Nie | Upewnij się, że każdy element url jest unikalny na stronach docelowych zlokalizowanych dla danego miejsca. usuniesz zduplikowane wpisy,
|
| Brak języka zlokalizowanej strony docelowej marki | ERROR | MISSING_REQUIRED_FIELD
|
local_data.brand_landing_pages.localized_landing_pages.locales
|
Nie | Podaj prawidłowy zestaw języków dla zlokalizowanej strony docelowej. |
| Zduplikowane ustawienia regionalne strony docelowej zlokalizowanej pod kątem marki | ERROR | DUPLICATE_UNIQUE_PROPERTY
|
local_data.brand_landing_pages.localized_landing_pages.locales
|
Nie | Upewnij się, że każdy element locale jest unikalny na stronach docelowych zlokalizowanych dla danego miejsca. usuniesz zduplikowane wpisy,
|
| Naruszenie zasad dotyczących tekstu – kategoria placówki | OSTRZEŻENIE | SAFE_SEARCH_POLICY_VIOLATION_TEXT
|
local_data.establishment_category.localizations.*.text
|
Nie | Usuń lub zastąp tekst oznaczony jako kategoria placówki. Zobacz zasady dotyczące treści tekstowych w wyszukiwarce Google. |
Kody problemów
W sekcjach poniżej znajdziesz szczegółowe informacje o przyczynach i sposobach rozwiązania problemów związanych z poszczególnymi kodami.
Brakuje wymaganego pola
Kod problemu: MISSING_REQUIRED_FIELD
Waga: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując plik danych o ciekawych miejscach)
Ten błąd występuje, gdy w przetworzonym elemencie brakuje co najmniej jednego atrybutu wymaganego przez specyfikację pliku danych o punktach zainteresowania.
Sprawdź w panelu Szczegóły problemu, której konkretnie właściwości brakuje, a następnie zastosuj odpowiednie rozwiązanie:
1. Brak identyfikatora ważnego miejsca (poi_id)
- Przyczyna: pole
poi_idjest puste, ma wartość null lub brakuje go w obiekcie encji głównej. - Rozwiązanie: podaj trwały, unikalny identyfikator właściwości w postaci ciągu znaków.
{
"poi_id": "test_restaurant_1"
}
2. Brak domyślnego języka lub zlokalizowanej nazwy (name)
- Przyczyna: w obiekcie
namebrakuje ciągu tekstowegodefault_localelub tablicylocalizationsz pasującymi ustawieniami językowymi. - Rozwiązanie: podaj zarówno
default_locale, jak i co najmniej 1 wpis lokalizacji pasujący do tego języka.
{
"name": {
"localizations": [
{
"locale": "en",
"text": "Tasty Bites Test Restaurant"
}
],
"default_locale": "en"
}
}
3. Brak domyślnego języka lub zlokalizowanego adresu (display_address)
- Przyczyna: w obiekcie
display_addressbrakuje ciągu znakówdefault_localelub tablicylocalizations. - Rozwiązanie: podaj zarówno
default_locale, jak i co najmniej 1 wpis lokalizacyjny pasujący do tego języka w przypadku sformatowanego adresu.
{
"display_address": {
"localizations": [
{
"locale": "en",
"text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
}
],
"default_locale": "en"
}
}
4. Brak domyślnego języka lub zlokalizowanego opisu (description)
- Przyczyna: gdy obiekt
descriptionjest uwzględniony, brakujedefault_localelub pasującej lokalizacji. - Rozwiązanie: podaj zarówno
default_locale, jak i co najmniej 1 wpis lokalizacyjny pasujący do tego języka w opisie.
{
"description": {
"localizations": [
{
"locale": "en",
"text": "A mock restaurant for testing the POI feed ingestion."
}
],
"default_locale": "en"
}
}
5. Brak współrzędnych geograficznych (location.latitude / location.longitude)
- Przyczyna: w obiekcie
locationbrakuje wartości liczbowejlatitudelublongitude. - Rozwiązanie: podaj wartości
latitudeilongitudejako liczby zmiennoprzecinkowe w standardowych stopniach dziesiętnych WGS84.
{
"location": {
"latitude": 37.422,
"longitude": -122.084
}
}
6. Brak uporządkowanego adresu pocztowego (location.address)
- Przyczyna: obiekt
location.addressnie zawiera obowiązkowych komponentów adresu (country,localitylubpostal_code). - Rozwiązanie: wypełnij obiekt uporządkowanego adresu pocztowego zgodnie ze standardami ISO.
{
"location": {
"address": {
"country": "US",
"locality": "Mountain View",
"postal_code": "94043",
"street_address": "1600 Amphitheatre Pkwy"
}
}
}
7. Brak domyślnego języka dla kategorii placówki (local_data.establishment_category.default_locale)
- Przyczyna: obiekt
local_data.establishment_categoryjest obecny, ale brakuje obiektudefault_locale, jest on pusty lub nie pasuje do żadnego wpisu w tablicylocalizations. - Rozwiązanie: podaj prawidłowy tag języka w formacie BCP 47 dla
default_localei podaj co najmniej 1 zlokalizowany ciąg znaków pasujący do tego języka.
{
"local_data": {
"establishment_category": {
"default_locale": "en",
"localizations": [
{
"locale": "en",
"text": "Restaurant"
}
]
}
}
}
8. Brak dnia otwarcia w godzinach otwarcia (local_data.business_hours.time_ranges.open_day)
- Przyczyna: brakuje wpisu w
local_data.business_hours.time_rangesopen_daylub jest on ustawiony naDAY_OF_WEEK_UNSPECIFIED. - Rozwiązanie: podaj prawidłowy ciąg znaków dnia tygodnia (np.
"MONDAY","TUESDAY").
{
"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. Brak godziny otwarcia w godzinach pracy (local_data.business_hours.time_ranges.open_time)
- Przyczyna: we wpisie w
local_data.business_hours.time_rangesbrakuje obiektuopen_time. - Działanie naprawcze: określ
open_time, podająchours(0–23) iminutes(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. Brak dnia zamknięcia w godzinach otwarcia (local_data.business_hours.time_ranges.close_day)
- Przyczyna: brakuje wpisu w
local_data.business_hours.time_rangesclose_daylub jest on ustawiony naDAY_OF_WEEK_UNSPECIFIED. - Rozwiązanie: podaj prawidłowy ciąg znaków dnia tygodnia (np.
"MONDAY","TUESDAY").
{
"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. Brak godziny zamknięcia w godzinach otwarcia (local_data.business_hours.time_ranges.close_time)
- Przyczyna: we wpisie w
local_data.business_hours.time_rangesbrakuje obiektuclose_time. - Działanie naprawcze: określ
close_time, podająchours(0–23) iminutes(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. Brak identyfikatora marki (local_data.brand_landing_pages.brand_id)
- Przyczyna: wpis w
local_data.brand_landing_pagesma pustą lub brakującą wartośćbrand_idalbo wartość null. - Rozwiązanie: podaj niepusty ciąg znaków identyfikatora, który pasuje do konfiguracji zarejestrowanej marki partnera.
{
"local_data": {
"brand_landing_pages": [
{
"brand_id": "tasty_bites_brand",
"default_url": "https://www.tastybitestest.com"
}
]
}
}
13. Brak domyślnego adresu URL marki (local_data.brand_landing_pages.default_url)
- Przyczyna: brakuje wpisu w
local_data.brand_landing_pagesdefault_urllub jest on pustym ciągiem znaków. - Rozwiązanie: podaj prawidłowy zastępczy adres URL strony docelowej HTTP/HTTPS dla użytkowników, których region nie pasuje do zlokalizowanych adresów URL.
{
"local_data": {
"brand_landing_pages": [
{
"brand_id": "tasty_bites_brand",
"default_url": "https://www.tastybitestest.com"
}
]
}
}
14. Brak adresu URL zlokalizowanej strony docelowej marki (local_data.brand_landing_pages.localized_landing_pages.url)
- Przyczyna: element w obiekcie
localized_landing_pagesma brakujące lub puste poleurl. - Rozwiązanie: podaj prawidłowy, pełny adres URL HTTP/HTTPS zlokalizowanej strony docelowej.
{
"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. Brak języka strony docelowej zlokalizowanej dla marki (local_data.brand_landing_pages.localized_landing_pages.locales)
- Przyczyna: w elemencie
localized_landing_pagesbrakuje tablicylocaleslub jest ona pusta. - Rozwiązanie: podaj co najmniej 1 prawidłowy kod języka lub regionu w formacie BCP 47 (np.
["en-US"]) w tablicylocales.
{
"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"]
}
]
}
]
}
}
Przekroczono maksymalną liczbę obrazów
Kod problemu: EXCEEDED_MAX_COUNT
Waga: ostrzeżenie
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
Ten błąd występuje, gdy ładunek encji POI zawiera więcej niż 5 obiektów graficznych w tablicy images.
Działanie naprawcze:
- Przytnij tablicę
images, aby zawierała maksymalnie 5 wysokiej jakości reprezentatywnych zdjęć lokalnego obiektu. - Wszystkie obrazy przekraczające limit 5 zostaną odrzucone.
Nieprawidłowe współrzędne geograficzne
Kod problemu: INVALID_LATLNG
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
Ten błąd występuje, gdy współrzędne geograficzne podane w polu location.latitude lub location.longitude wykraczają poza prawidłowe granice sferyczne lub reprezentują niezaludnione współrzędne o wartości null.
Typowe przyczyny i rozwiązania:
- Szerokość geograficzna poza zakresem: szerokość geograficzna musi być liczbą w reprezentacji zmiennoprzecinkowej z zakresu od
-90.0do90.0włącznie. - Długość geograficzna poza zakresem: Długość geograficzna musi być liczbą w reprezentacji zmiennoprzecinkowej z zakresu od
-180.0do180.0(włącznie). - Null Island (0,0): przesłanie wartości
0.0, 0.0lub liczb całkowitych zastępczych (takich jak999, 999) powoduje odrzucenie współrzędnych. - Zamienione współrzędne: sprawdź, czy szerokość i długość geograficzna nie są odwrócone w potoku serializacji.
Przykład prawidłowego ładunku:
{
"location": {
"latitude": 37.422,
"longitude": -122.084
}
}
Nieprawidłowy format adresu URL lub nieprawidłowy adres URL
Kod problemu: INVALID_ATTRIBUTE_VALUE
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
Ten błąd występuje, gdy wartość atrybutu nie przejdzie weryfikacji schematu. Najczęściej dzieje się tak, gdy adres URL strony docelowej partnera lub adres URL obrazu jest nieprawidłowy pod względem składni.
Wymagania:
- Protokół: adresy URL muszą wyraźnie określać
http://lubhttps://(zdecydowanie zalecamy HTTPS). - Kodowanie: adresy URL zawierające znaki specjalne, spacje lub znaki spoza zestawu ASCII muszą być prawidłowo zakodowane za pomocą znaku procenta (RFC 3986).
- Domena kanoniczna: upewnij się, że domena jest w pełni kwalifikowana (np.
https://example.com/local/123, a nieexample.com/local/123lubwww.example).
Przykład prawidłowego ładunku:
{
"url": "https://www.tastybitestest.com/en"
}
Nieprawidłowy lub niedostępny obraz
Kod problemu: INVALID_IMAGE
Waga: ostrzeżenie
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
To ostrzeżenie pojawia się na etapie asynchronicznego pobierania obrazu, gdy robot Google nie może pobrać, zdekodować ani zweryfikować zasobu multimedialnego z: image.url.
Nieprawidłowy obraz zostanie pominięty, ale obiekt nadal będzie mógł się wyświetlać.
Typowe przyczyny i rozwiązania:
- Błędy HTTP (404 / 403 / 500): adres URL obrazu zwraca kod stanu HTTP inny niż 200. Upewnij się, że obrazy są dostępne publicznie bez uwierzytelniania, ścian cookie lub ograniczeń dotyczących listy dozwolonych adresów IP.
- Blokowanie przez plik robots.txt: upewnij się, że Twoja sieć dostarczania treści (CDN) zezwala na dostęp klientom użytkownika
GooglebotiGooglebot-Image. - Nieobsługiwany format pliku: obrazy muszą być w standardowych formatach rastrowych (
JPEG,PNG,WebP). Animowane GIF-y, pliki SVG i nieprzetworzone formaty z aparatu nie są obsługiwane. Więcej informacji znajdziesz we wskazówkach dotyczących obrazów. - Błędy certyfikatu SSL: sprawdź, czy serwer hostujący obrazy ma prawidłowy łańcuch certyfikatów SSL.
Zduplikowany identyfikator ważnego miejsca
Kod problemu: DUPLICATE_ENTITY
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
Ten błąd występuje, gdy ten sam ciąg znaków poi_id pojawia się więcej niż raz w jednym zbiorze plików kanału.
Działanie naprawcze:
- Upewnij się, że każda lokalna wizytówka w pliku danych ma unikalny, deterministyczny identyfikator
poi_id. - Jeśli lokalny obiekt ma kilka typów pokoi lub stawek, skonsoliduj je w ramach jednego elementu nadrzędnego POI, zamiast generować duplikaty rekordów elementów z identycznymi identyfikatorami.
Zduplikowany dopasowany element
Kod problemu: DUPLICATE_MATCHED_ENTITY
Waga: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych lub korzystając z narzędzi do dopasowywania elementów ciekawych miejsc)
Ten błąd występuje, gdy co najmniej 2 różne wpisy poi_id w pliku danych pasują do tej samej kanonicznej wizytówki miejsca w Mapach Google. Gdy kilka firm jest mapowanych na ten sam podmiot Google, wszystkie kolidujące wpisy są blokowane do czasu usunięcia duplikatu.
Jak rozwiązać ten problem:
- Zidentyfikuj właściwości, które powodują konflikt: otwórz Przeglądarkę pozyskiwania (Pozyskiwanie > Historia), wybierz ostatnie pozyskiwanie i rozwiń panel Weryfikacje. Kliknij wiersz
DUPLICATE_MATCHED_ENTITY, który ma ten sam identyfikator grupy Informacje o problemie, aby wyświetlić wszystkie rekordypoi_id, które pasują do tego samego podmiotu Google. - Usuń z pliku danych zduplikowane informacje: jeśli kolidujące wpisy
poi_idreprezentują tę samą fizyczną lokalizację firmy, usuń z pliku danych zduplikowane wpisy, aby przesłać tylko 1 wpispoi_iddotyczący tej placówki. - Popraw nieprawidłowe dopasowania w przypadku niezależnych firm: jeśli kolidujące wpisy
poi_idreprezentują oddzielne, niezależne firmy, które zostały nieprawidłowo dopasowane do tego samego podmiotu Google, otwórz nieprawidłowo dopasowaną firmę w widoku asortymentu i kliknij Edytuj dopasowanie, aby wybrać lub zaproponować dedykowaną wizytówkę miejsca w Mapach Google. Szczegółowe instrukcje znajdziesz w przewodniku po dopasowywaniu elementów w miejscach.
Niedopasowany element
Kod problemu: UNMATCHED_ENTITY
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (użyj narzędzi do dopasowywania elementów ciekawych miejsc lub popraw metadane elementu)
Ten problem oznacza, że potok dopasowywania Google nie był w stanie uzgodnić Twojej wizytówki lokalnej z kanonicznym miejscem w Mapach Google.
Jak rozwiązać ten problem:
- Sprawdź atrybuty podstawowe: upewnij się, że atrybuty
name,display_address,location.address,url,telephoneilocation.latitude/location.longitudedokładnie odzwierciedlają lokalizację fizyczną obiektu. - Sprawdź informacje o dopasowaniu: w kolumnie Informacje o dopasowaniu w widoku asortymentu sprawdź potencjalne miejsca.
- Użyj narzędzia do poprawiania dopasowania ważnych miejsc: w Centrum działań kliknij Edytuj dopasowanie, aby ręcznie wyszukać i potwierdzić prawidłowy identyfikator miejsca Google. Szczegółowe instrukcje znajdziesz w przewodniku po dopasowywaniu elementów ciekawych miejsc.
Naruszenie zasad dotyczących obrazów w wyszukiwarce Google
Kod problemu: SAFE_SEARCH_POLICY_VIOLATION_IMAGE
Waga: BŁĄD (blokuje wyświetlanie)
Możliwość odwołania: tak
Kody problemów związanych z zasadami: zasady dotyczące obrazów w treściach w wyszukiwarce Google.
Jeśli uważasz, że obraz został oznaczony przez pomyłkę (fałszywy alarm), w panelu Szczegóły problemu kliknij Utwórz odwołanie.
Naruszenie zasad dotyczących treści tekstowych w wyszukiwarce Google – nazwa
Kod problemu: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Ważność: różni się w zależności od pola (szczegóły poniżej)
Pole, którego dotyczy problem: name.localizations.*.text
Możliwość odwołania: tak (tylko w przypadku BŁĘDU w domyślnych ustawieniach regionalnych); nie (w przypadku ostrzeżenia w niedomyślnych ustawieniach regionalnych)
- Domyślne ustawienia regionalne (
name.default_locale): BŁĄD (blokuje wyświetlanie). Wyświetlanie całego miejsca docelowego jest zablokowane. Jeśli uważasz, że tekst nazwy domyślnego ustawienia regionalnego został oznaczony przez pomyłkę (fałszywy alarm), w panelu Szczegóły problemu kliknij Utwórz odwołanie. - Ustawienia regionalne inne niż domyślne: ostrzeżenie (nie blokuje wyświetlania). Pominięta zostanie tylko oznaczona lokalizacja, a ciekawe miejsce nadal będzie mogło się wyświetlać. Od ostrzeżeń dotyczących języków innych niż domyślny nie można się odwołać. Można je rozwiązać, aktualizując dane w pliku danych.
Kody problemów związanych z zasadami: Zasady dotyczące treści w wyszukiwarce Google
Naruszenie zasad dotyczących tekstu w treściach w wyszukiwarce Google – opis
Kod problemu: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Waga: ostrzeżenie (nie blokuje wyświetlania)
Pole, którego dotyczy problem: description.localizations.*.text
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
To ostrzeżenie pojawia się, gdy tekst w description.localizations zostanie oznaczony jako naruszający zasady dotyczące tekstu w wyszukiwarce Google. Chociaż oznaczone tłumaczenie opisu (lub całe pole description, jeśli oznaczono domyślne ustawienia regionalne) jest pomijane, miejsce nadal może się wyświetlać.
Kody problemów związanych z zasadami: Zasady dotyczące treści w wyszukiwarce Google
Naruszenie zasad dotyczących tekstu treści w wyszukiwarce Google – adres wyświetlany
Kod problemu: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Waga: ostrzeżenie (nie blokuje wyświetlania)
Pole, którego dotyczy problem: display_address.localizations.*.text
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
To ostrzeżenie pojawia się, gdy sformatowany tekst adresu w display_address.localizations zawiera treści zabronione przez zasady dotyczące treści tekstowych w wyszukiwarce Google. Chociaż oznaczona lokalizacja adresu (lub całe pole display_address, jeśli oznaczono domyślne ustawienia regionalne) zostanie pominięta, ciekawe miejsce nadal będzie mogło się wyświetlać.
Kody problemów związanych z zasadami: Zasady dotyczące treści w wyszukiwarce Google
Godzina otwarcia firmy jest późniejsza niż godzina zamknięcia
Kod problemu: NOT_LESS_THAN_FIELD
Waga: błąd (blokuje wyświetlanie)
Pola, których dotyczy problem: local_data.business_hours.time_ranges.open_time,
local_data.business_hours.time_ranges.close_time
Możliwość odwołania: nie (rozwiąż problem, aktualizując dane w pliku danych)
Ten błąd występuje, gdy godziny otwarcia open_time są późniejsze niż close_time lub równe tej wartości dla tego samego przedziału dnia.
Typowe przyczyny i rozwiązania:
- Odwrócenie tego samego dnia: upewnij się, że godzina
open_timejest wcześniejsza niżclose_time(np. 09:00–17:00). - Zmiany nocne: jeśli lokal jest otwierany jednego dnia i zamykany po północy następnego dnia (np. od 21:00 do 2:00), ustaw
close_dayna następny dzień (np.open_day:"FRIDAY",close_day:"SATURDAY").
Przykład prawidłowego ładunku:
{
"local_data": {
"business_hours": {
"time_ranges": [
{
"open_day": "MONDAY",
"open_time": { "hours": 9, "minutes": 0 },
"close_day": "MONDAY",
"close_time": { "hours": 17, "minutes": 0 }
}
]
}
}
}
Minimalna wartość przedziału cenowego jest większa niż wartość maksymalna
Kod problemu: INVALID_PRICE_RANGE
Waga: błąd (blokuje wyświetlanie)
Pola, których dotyczy problem: local_data.price_range.min_price,
local_data.price_range.max_price
Możliwość odwołania: nie (rozwiąż problem, aktualizując dane w pliku danych)
Ten błąd występuje, gdy wartość min_price przekracza wartość max_price lub gdy min_price i max_price mają różne kody waluty.
Typowe przyczyny i rozwiązania:
- Odwrócone wartości: upewnij się, że wartość
min_pricejest mniejsza lub równa wartościmax_price. - Niezgodność waluty: sprawdź, czy parametry
min_price.currency_codeimax_price.currency_codemają ten sam trzyliterowy kod waluty według normy ISO 4217 (np."USD").
Przykład prawidłowego ładunku:
{
"local_data": {
"price_range": {
"min_price": {
"currency_code": "USD",
"units": 15,
"nanos": 0
},
"max_price": {
"currency_code": "USD",
"units": 45,
"nanos": 0
}
}
}
}
Zduplikowana unikalna usługa w ramach ważnego miejsca
Kod problemu: DUPLICATE_UNIQUE_PROPERTY
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
Ten błąd występuje, gdy pole lub element podrzędny, który musi być unikalny w obrębie pojedynczej encji POI, zawiera zduplikowane wpisy.
Sprawdź w panelu Szczegóły problemu, która właściwość narusza unikalność:
1. Zduplikowany identyfikator marki w miejscu (local_data.brand_landing_pages.brand_id)
- Przyczyna: ten sam ciąg znaków
brand_idpojawia się w wielu wpisachbrand_landing_pagesdla jednego miejsca. - Rozwiązanie: skonsoliduj wszystkie strony docelowe tej marki w jednym obiekcie
brand_landing_pages.
Przykład prawidłowego ładunku:
{
"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. Zduplikowany adres URL zlokalizowanej strony docelowej marki (local_data.brand_landing_pages.localized_landing_pages.url)
- Przyczyna: ten sam adres URL strony docelowej jest zdefiniowany wielokrotnie w elemencie
localized_landing_pagesdla tej samej marki. - Rozwiązanie: upewnij się, że każdy wpis adresu URL jest unikalny, lub powiąż wiele języków w tablicy
localespojedynczego wpisu adresu URL.
Przykład prawidłowego ładunku:
{
"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. Zduplikowany język strony docelowej zlokalizowanej dla marki (local_data.brand_landing_pages.localized_landing_pages.locales)
- Przyczyna: ten sam kod języka (np.
"en-US") powtarza się w wielu wpisach w plikulocalized_landing_pagesdla tej samej marki. - Rozwiązanie: przypisz każdy tag języka do dokładnie jednej zlokalizowanej strony docelowej.
Przykład prawidłowego ładunku:
{
"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"]
}
]
}
]
}
}
Nieprawidłowy lub niepoprawnie sformatowany adres URL marki
Kod problemu: INVALID_ATTRIBUTE_VALUE
Ważność: błąd (blokuje wyświetlanie)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
Pola, których dotyczy problem: local_data.brand_landing_pages.default_url,
local_data.brand_landing_pages.localized_landing_pages.url
Ten błąd występuje, gdy domyślny adres URL marki lub adres URL zlokalizowanej strony docelowej nie przejdzie weryfikacji składni identyfikatora URI.
Wymagania:
- Protokół: musisz wyraźnie określić
http://lubhttps://(https://jest wymagany w przypadku wyświetlania w środowisku produkcyjnym). - Składnia: musi to być prawidłowy, zakodowany procentowo adres URL zgodny ze standardem RFC 3986 z pełną i jednoznaczną nazwą domeny.
Przykład prawidłowego ładunku:
{
"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"]
}
]
}
]
}
}
Naruszenie zasad dotyczących tekstu w treściach w wyszukiwarce Google – kategoria placówki
Kod problemu: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Waga: ostrzeżenie (nie blokuje wyświetlania)
Możliwość odwołania: nie (rozwiąż problem, aktualizując ładunek pliku danych)
Pole, którego dotyczy problem: local_data.establishment_category.localizations.*.text
To ostrzeżenie pojawia się, gdy tekst kategorii lokalnej placówki nie przechodzi automatycznych filtrów treści SafeSearch. Jeśli lokalizacja kategorii oznaczonej placówki (lub całe pole establishment_category, jeśli oznaczono domyślne ustawienia regionalne) zostanie pominięta, ciekawe miejsce nadal będzie mogło się wyświetlać.
Działanie naprawcze:
- Zgodność z zasadami: usuń lub zastąp tekst oznaczonej kategorii placówki standardowymi terminami dotyczącymi kategorii działalności, które są zgodne z zasadami dotyczącymi tekstu w wyszukiwarce Google.
Przykład prawidłowego ładunku:
{
"local_data": {
"establishment_category": {
"default_locale": "en",
"localizations": [
{
"locale": "en",
"text": "Restaurant"
},
{
"locale": "fr",
"text": "Restaurant gastronomique"
}
]
}
}
}