Błędy zbiorczego pliku danych

Wsadowe pozyskiwanie danych z plików danych umożliwia udostępnianie restauracji, usług i menu w ramach usługi Zamów z wyprzedzeniem.

Google pobiera pliki danych przechowywane na platformie hostingowej i przetwarza je. Po pomyślnym przetworzeniu usługa sterowania zamówieniem od początku do końca podaje m.in. informacje o stanie przetworzenia, przesłanych nowych plikach, łącznej liczbie plików oraz błędach i ostrzeżeniach.

Z tego artykułu dowiesz się więcej o większości błędach w pliku danych zbiorczego w Centrum działań, o tym, co oznaczają i jak je naprawić. Hiperlinki przekierowują Cię na stronę z relacyjnymi schematami danych, na której znajdziesz więcej informacji, np. akceptowany typ danych i przykłady dotyczące konkretnych pól i podmiotów.

Gdzie w Centrum działań można zobaczyć błędy w plikach zbiorczych?

Pliki danych umożliwiają udostępnienie restauracji, usług i menu w ramach usługi Zamów z dostawą. Więcej informacji o hostowaniu plików danych znajdziesz w artykule Przetwarzanie partii.

Po przesłaniu plików danych są one pobierane i przetwarzane przez Google. Jeśli wystąpią jakieś problemy, zostaną one wyświetlone jako błędy. Aby wyświetlić błędy w plikach zbiorczych w Centrum działań:

  1. W panelu głównym w Centrum działań otwórz sekcję Pliki danych > Historia. Historia przetwarzania błędów w plikach danych zbiorczych

  2. Wybierz środowisko (produkcyjne lub piaskownicę) i kliknij kartę Historia przetwarzania.

  3. Podaj okres ważności, aby wyświetlić historię przetwarzania z ostatnich X dni

  4. Aby uzyskać więcej informacji o błędach podczas przetwarzania konkretnego pliku danych, kliknij strzałkę (→).

  5. Możesz wtedy zobaczyć więcej szczegółów dotyczących błędów i ostrzeżeń Szczegóły wsadowego pliku danych
Błędy

Oto lista błędów w plikach zbiorczych:

Błąd Znaczenie Rozwiązanie
Brak danych – MenuItem Menu musi zawierać co najmniej 1 pozycję MenuItem Menu zostało zdefiniowane bez MenuItem Znajdź w pliku danych identyfikator błędnego elementu Menu i dodaj pozycje menu.
Nieprawidłowe dane – maxPriceNieprawidłowe dane w polu maxPrice Wartość pola maxPrice jest nieprawidłowa Sprawdź, czy w przypadku identyfikatora wymienionego w opisie błędu wartość pola maxPrice jest większa niż 0.
Nieprawidłowe dane – eligibleQuantityMaxNieprawidłowe dane w polu eligibleQuantityMax Wartość pola eligibleQuantityMax jest nieprawidłowa Sprawdź, czy wartość pola eligibleQuantityMax jest większa od 0 w przypadku wymienionego identyfikatora.
Nieprawidłowe dane – leadTimeMaxNieprawidłowe dane w polu leadTimeMax Pole leadTimeMax wymaga podania liczby całkowitej. Przykład: 12. Wyrzuca błąd dla dowolnego innego typu danych, nawet podwójnego (15.0) W przypadku identyfikatora jednostki wymienionego w komunikacie o błędzie sprawdź wartość właściwości leadTimeMax i upewnij się, że jest to liczba całkowita.
Nieprawidłowe dane – validFromNieprawidłowe dane w polu validFrom Wartość pola validFrom musi być w formacie sygnatury czasowej ISO i typu String. W przypadku identyfikatora encji w komunikacie o błędzie w polu validFrom upewnij się, że wartość jest ciągiem znaków sygnatury czasowej.

Przykład: „2022-01-02T00:00:00-07:00”.
Brakujące dane – ServiceHours

OperationHour nie zawiera zagnieżdżonych ServiceHours
Zdefiniowano element OperationHours, ale nie ma odpowiadającego mu prawidłowego elementu ServiceHours. W przypadku identyfikatora jednostki wymienionego w komunikacie o błędzie sprawdź, czy istnieje odpowiadająca mu właściwie zdefiniowana jednostka ServiceHours.

Przykład: jeśli komunikat o błędzie brzmi „Identyfikator elementu: store-1:DELIVERY OperationHour nie zawiera zagnieżdżonych elementów ServiceHours” i zakładając, że identyfikator elementu OperationHours to „store-1:DELIVERY:operation_hours”, sprawdź, czy istnieje element serviceHours powiązany z elementem „store-1:DELIVERY” ServiceID i „store-1:DELIVERY:operation_hours” OperationHoursID
Nieprawidłowe dane – advanceBookingRequirementMinNieprawidłowe dane w polu advanceBookingRequirementMin Pole advanceBookingRequirementMin wymaga podania liczby całkowitej. Przykład: 12.

Wyrzuca błąd w przypadku dowolnego innego typu danych, nawet podwójnej precyzji (15.0)
W przypadku identyfikatora jednostki wymienionego w komunikacie o błędzie sprawdź wartość właściwości advanceBookingRequirementMin i upewnij się, że jest to liczba całkowita.
Nieprawidłowe dane – availabilityStartsNieprawidłowe dane w polu availabilityStarts Wartość pola availabilityStarts musi być w formacie sygnatury czasowej ISO i typu String. W przypadku identyfikatora encji w komunikacie o błędzie w polu availabilityStarts upewnij się, że jego wartość to ciąg znaków sygnatury czasowej.

Przykład: „2022-01-02T00:00:00-07:00”.
Nieprawidłowe dane – closesNieprawidłowe dane w polu closes Wartość pola closes musi być w formacie sygnatury czasowej ISO i typu String. W przypadku identyfikatora encji w komunikacie o błędzie w polu closes sprawdź, czy wartość jest ciągiem znaków sygnatury czasowej.

Przykład: „2022-01-02T00:00:00-07:00”.
Nieprawidłowe dane – dateModifiedNieprawidłowe dane w polu dateModified Wartość pola dateModified musi być w formacie sygnatury czasowej ISO i typu String. W przypadku identyfikatora encji w komunikacie o błędzie w polu dateModified upewnij się, że wartość jest ciągiem znaków sygnatury czasowej.

Przykład: „2022-01-02T00:00:00-07:00”.
Nieprawidłowe dane – discountNieprawidłowe dane w polu discount Pole discount wymaga wartości liczbowej W przypadku identyfikatora jednostki w komuniku o błędzie w polu discount upewnij się, że wartość jest liczbowa.

Przykład: 10
Nieprawidłowe dane – discountPercentageNieprawidłowe dane w polu discountPercentage Pole discountPercentage wymaga wartości liczbowej W przypadku identyfikatora jednostki w komunikacie o błędzie w polu discountPercentage upewnij się, że wartość jest liczbowa.

Przykład: 15
Nieprawidłowe dane – geoRadiusNieprawidłowe dane w polu geoRadius Pole geoRadius wymaga podania dodatniej liczby całkowitej. W przypadku identyfikatora jednostki wymienionego w komunikacie o błędzie sprawdź wartość właściwości geoRadius i upewnij się, że jest to liczba całkowita.

Przykład: 10000
Nieprawidłowe dane – imageNieprawidłowe dane w polu image Pole image wymaga prawidłowego adresu URL i wyrzuca błąd, jeśli wykryje cokolwiek innego. Sprawdź, czy wartość pola image to prawidłowy ciąg znaków adresu URL.
Nieprawidłowe dane – latitudeNieprawidłowe dane w polu latitude Typ wartości w polu latitude musi być podwójny. W przypadku identyfikatora obiektu typu Restauracja wymienionego w opisie błędu sprawdź, czy wartość pola latitude jest typu double.

Przykład: 35,4565
Nieprawidłowe dane – leadTimeMinNieprawidłowe dane w polu leadTimeMin Pole leadTimeMin wymaga podania liczby całkowitej. Przykład: 12.

Wyrzuca błąd w przypadku dowolnego innego typu danych, nawet podwójnej precyzji (15.0)
W przypadku identyfikatora jednostki wymienionego w komunikacie o błędzie sprawdź wartość właściwości leadTimeMin i upewnij się, że jest to liczba całkowita.
Nieprawidłowe dane – longitudeNieprawidłowe dane w polu longitude Typ wartości pola longitude musi być podwójnie zmienny. W przypadku identyfikatora obiektu typu Restauracja wymienionego w opisie błędu sprawdź, czy wartość pola longitude jest typu double.

Przykład: 35,4565
Nieprawidłowe dane – menuIdNieprawidłowe dane w polu menuId Wartość pola menuId musi być niepustym ciągiem znaków. W przypadku identyfikatora elementu wymienionego w opisie błędu sprawdź, czy jego wartość jest typu String i nie jest pusta.
Nieprawidłowe dane – nameNieprawidłowe dane w polu name Wartość w polu name powinna być niepustym ciągiem znaków. Sprawdź, czy wartość identyfikatora elementu wymienionego w komunikacie o błędzie jest niepustym ciągiem znaków.
Nieprawidłowe dane – nutrition.caloriesNieprawidłowe dane w polu nutrition.calories Wartość w polu calories musi być ciągiem znaków w formacie „NN lat” Upewnij się, że w przypadku identyfikatora w komunikacie o błędzie wartość jest dodatnią liczbą w prawidłowym formacie.

Przykład: „123,32 cal”
Nieprawidłowe dane – opensNieprawidłowe dane w polu opens Wartość pola opens musi być w formacie sygnatury czasowej ISO i typu String. W przypadku identyfikatora encji w komunikacie o błędzie w polu opens upewnij się, że wartość jest ciągiem znaków sygnatury czasowej.

Przykład: „2022-01-02T00:00:00-07:00”.
Nieprawidłowe dane – priceNieprawidłowe dane w polu price Pole price wymaga wartości liczbowej W przypadku identyfikatora jednostki w komunikacie o błędzie w polu price upewnij się, że wartość jest liczbowa.

Przykład: 15,4
Nieprawidłowe dane – skuNieprawidłowe dane w polu sku Wartość pola sku powinna być niepustym ciągiem znaków. Sprawdź, czy wartość identyfikatora elementu wymienionego w komunikacie o błędzie jest niepustym ciągiem znaków.
Nieprawidłowe dane – validFromNieprawidłowe dane w polu validFrom Wartość pola validFrom musi być w formacie sygnatury czasowej ISO i typu String. Wartość parametru validFrom powinna być mniejsza lub równa wartości validThrough. W przypadku identyfikatora encji wymienionego w opisie błędu sprawdź, czy wartość pola validFrom to ciąg znaków sygnatury czasowej.

"2022-01-02T00:00:00-07:00"

Upewnij się też, że wartość parametru validFrom jest mniejsza lub równa validThrough.
Nieprawidłowe dane – validThroughNieprawidłowe dane w polu validThrough Wartość pola validThrough musi być w formacie sygnatury czasowej ISO i typu String. Wartość parametru validThrough powinna być większa lub równa validFrom. W przypadku identyfikatora encji wymienionego w opisie błędu sprawdź, czy wartość pola validThrough to ciąg znaków sygnatury czasowej.

"2022-01-02T00:00:00-07:00"

Sprawdź też, czy wartość parametru validThrough jest większa lub równa validFrom.
Nieprawidłowe dane – valueNieprawidłowe dane w polu value Pole value jest wymagane tylko wtedy, gdy zdefiniowano Optiontype. Oczekuje ciągu znaków lub typu Enum value. Pamiętaj, że wartości typu Enum są specyficzne dla typu opcji PIZZA_SIDE. W przypadku identyfikatora entityID wymienionego w opisie błędu sprawdź, czy pole value zawiera niepusty ciąg znaków.
Menu jest za duże

Rozmiar menu przekracza maksymalny limit
Ten błąd występuje, gdy rozmiar pliku menu przekracza dopuszczalny rozmiar. Każdy plik, który może zawierać wiele elementów, nie może przekraczać 200 MB. Elementy najwyższego poziomu Restaurant, Service i Menu wraz z ich elementami podrzędnymi nie mogą razem przekraczać 4 MB. Upewnij się, że rozmiar pliku menu mieści się w limitach określonych w dokumentacji.
Brak danych – addressCountryBrak wymaganego pola addressCountry w danych wejściowych. addressCountry to wymagane pole, które jest puste w entytecie Restaurant W przypadku identyfikatora wymienionego w opisie błędu sprawdź, czy pole addressCountry zawiera niepusty ciąg znaków.
Brak danych – addressLocalityBrak wymaganego pola addressLocality w danych wejściowych. addressLocality to wymagane pole, które jest puste w entytecie Restaurant. W przypadku identyfikatora wymienionego w opisie błędu sprawdź, czy pole addressLocality zawiera niepusty ciąg znaków.
Brak danych – addressRegionBrak wymaganego pola addressRegion w danych wejściowych. addressRegion to wymagane pole, które jest puste w entytecie Restaurant W przypadku identyfikatora wymienionego w opisie błędu sprawdź, czy pole addressRegion zawiera niepusty ciąg znaków.
Brakujące dane – opłata

Usługa dostawy/wynosna nie ma żadnych opłat za dostawę
Element typu Opłata nie jest powiązany z żadnym elementem typu price dla usługi dostawy lub odbioru osobistego W przypadku identyfikatora jednostki wymienionego w opisie błędu sprawdź, czy jednostka Opłata jest prawidłowo skonfigurowana pod kątem dostawy/wynosów ServiceType zgodnie z instrukcjami podanymi tutaj.
Brak danych – FeeValueW danych wejściowych wymagane jest jedno z pol price, pricePerMeter, percentageOfCart. W przypadku wartości Opłata musi być ustawiona dokładnie jedna z opcji price, pricePerMeter or percentageOfCart . W przypadku identyfikatora zasobu wymienionego w opisie błędu sprawdź, czy ustawiony jest dokładnie jeden z parametrów price, pricePerMeter or percentageOfCart .
Brak danych – geoMidpointLatitudeBrak wymaganego pola geoMidpointLatitude w danych wejściowych. Podczas definiowania ServiceArea wymagany jest element geoMidpointLatitude, gdy używany jest element geoMidpointLongitude, a element geoRadius. W przypadku identyfikatora zasobu wymienionego w opisie błędu sprawdź, czy wartość pola geoMidpointLatitude jest zdefiniowana i ma typ double.

Przykład: 35,4565
Brak danych – geoMidpointLongitude geoMidpointLongitude w danych wejściowych. Podczas definiowania ServiceArea wymagany jest parametr geoMidpointLongitude, a jeśli używany jest parametr geoMidpointLatitude, wymagany jest parametr geoRadius. W przypadku identyfikatora zasobu wymienionego w opisie błędu sprawdź, czy wartość pola geoMidpointLatitude jest zdefiniowana i ma typ double.

Przykład: 122.4565
Brakujące dane – MenuItemOption

MenuItemOffer jest wymagany w MenuItemOption
Dla każdego elementu MenuItemOption musi istnieć odpowiedni element MenuItemOffer. Upewnij się, że w przypadku wszystkich identyfikatorów elementów menu w opisie błędu wszystkie elementy MenuItemOption mają prawidłowo zdefiniowany element MenuItemOffer.
Brak danych – OperationHours

Usługi brakuje godzin otwarcia
W encji usługi dostawy/wywozu na wynos brakuje odpowiadającej jej encji OperationHours. OperationHours określa okno na składanie zamówień, w którym użytkownicy mogą uzyskać dostęp do procesu i uzyskać możliwość złożenia zamówienia ASAP lub zamówienia na przyszłość. W przypadku identyfikatora jednostki wymienionego w opisie błędu sprawdź, czy jednostka OperationHours jest prawidłowo zdefiniowana.
Brak danych – postalCodeBrak wymaganego pola postalCode w danych wejściowych. postalCode to wymagane pole, które jest puste w entytecie Restaurant W przypadku identyfikatora wymienionego w opisie błędu sprawdź, czy pole postalCode zawiera niepusty ciąg znaków.
Brak danych – priceCurrencyBrak wymaganego pola priceCurrency w danych wejściowych. Pole priceCurrency jest puste lub zawiera nieprawidłową wartość. Wymaga 3-literowego kodu waluty w formacie ISO 4217. W przypadku identyfikatora jednostki opisanego w opisie błędu upewnij się, że pole priceCurrency zawiera niepusty ciąg znaków z 3-literowym kodem waluty ISO 4217.

Przykład: PLN, EUR
Brak danych – ServiceArea

Usługa dostawy nie ma obszarów dostawy
Element ServiceArea musi zostać zaimplementowany, jeśli powiązany element Service ma wartość serviceType ustawioną na „DELIVERY”. Upewnij się, że dla identyfikatora jednostki Usługa wymienionego w komunikacie o błędzie istnieje prawidłowo zdefiniowana jednostka ServiceArea.
Brak danych – streetAddressBrak wymaganego pola streetAddress w danych wejściowych. streetAddress to wymagane pole, którego brakuje w elemencie Restaurant Znajdź element Restaurant (Restauracje) według identyfikatora podanego w opisie błędu. Sprawdź, czy pole streetAddress zawiera niepusty ciąg znaków.
Nieaktualny element Podczas przetwarzania kanału danych usługa End-to-End Ordering porównuje sygnaturę czasową zmodyfikowanej daty każdego przychodzącego elementu z sygnaturami czasowymi wcześniej przetworzonych elementów. Jeśli element w plikach danych nie jest nowszy, jest on oznaczany jako nieaktualny. W przypadku wszystkich identyfikatorów wymienionych w opisie błędu Google musi zadbać o to, aby znacznik czasu w pliku danych był nowszy niż znacznik czasu ustawiony w poprzednich aktualizacjach elementów wysłanych do Google. Więcej informacji znajdziesz w sekcji wersje jednostek.