Sprawdzanie semantyki pliku danych
Semantyka pliku danych z opiniami jest nieco bardziej złożona:
W przypadku plików danych do sprawdzania zrzutów:
- Jeśli w pliku danych z opiniami znajduje się usługodawca, który nie jest obecnie w bazie danych dostawców Reklam Usług Lokalnych, jego opinie nie zostaną przetworzone.
- W przypadku każdego usługodawcy w pliku danych z opiniami, który jest obecnie w bazie danych dostawców Reklam Usług Lokalnych, opinie o nim będą przetwarzane w ten sposób:
- Jeśli w przypadku opinii w pliku danych odpowiednia opinia nie istnieje w pamięci LSA, należy ją utworzyć.
- Jeśli w pliku danych znajduje się opinia, a w pamięci LSA istnieje odpowiadająca jej opinia, zostanie ona zaktualizowana o nowe informacje.
- Jeśli w pliku danych nie ma opinii, a odpowiednia opinia znajduje się w pamięci LSA, zostanie ona usunięta.
- W przypadku każdego usługodawcy, którego nie ma w kanale opinii, a który obecnie znajduje się w bazie danych dostawców Usług Lokalnych, opinie zostaną usunięte, a usługodawca przestanie wyświetlać reklamy.
- Pamiętaj, że dostawca, który nie ma żadnych opinii, również powinien mieć wpis w plikach danych o opiniach (zamiast być pominiętym), aby mógł wyświetlać reklamy (patrz przykładowy plik danych o opiniach – listingId 2).
Pamiętaj, że w przypadku kanałów opinii nie jest obsługiwane dodawanie przyrostowe. Do każdego pliku danych o profilach wymagany jest odpowiedni plik danych z opiniami.
Obsługa błędów w przypadku opinii
Jeśli element pliku danych z opiniami jest nieprawidłowy, pominiemy jego przetwarzanie i będziemy kontynuować przetwarzanie pozostałych prawidłowych elementów pliku danych.
Jeśli plik danych z opiniami jest nieprawidłowy (np. niezgodny ze schematem), przestaniemy przetwarzać cały plik danych z opiniami.
Sprawdzanie pól
| Nazwa pola | Typ | Opis | Przykład | Wymagane | Ograniczenia |
|---|---|---|---|---|---|
| serviceProviderId | liczba | Unikalny identyfikator wizytówki (usługodawcy). | 12345 | Tak | Musi mieścić się w zakresie typu int64 |
| ratingCount | liczba całkowita | Liczba zweryfikowanych ocen konsumenckich | 10 | Tak | Wartość musi być równa 0 lub większa. |
| autor | ciąg znaków | Imię i nazwisko autora opinii | „Jack L.” | Nie | |
| reviewId | ciąg znaków | Unikalny identyfikator opinii. Jeśli każda opinia nie ma unikalnego identyfikatora, poproś dostawcę o wygenerowanie unikalnego identyfikatora dla każdej opinii (np.skrótu tekstu opinii i użytkownika), który będzie unikalny przynajmniej wśród wszystkich opinii od jednego dostawcy. | „123” | Tak | |
| reviewText | ciąg znaków | Sprawdź tekst napisany przez autora | „Dobra robota!” | Nie | |
| ocena | liczba całkowita | Ocena (musi być liczbą całkowitą z zakresu od 1 do 5) | 4 | Tak | Musi być liczbą całkowitą z zakresu od 1 do 5. |
| serviceLocationCity | ciąg znaków | Miasto, w którym wykonano usługę | „New York” | Nie | |
| reviewTimestampMicros | liczba całkowita | Sygnatura czasowa napisania opinii w formacie mikrosekund. | 1.45142E+15 | Nie | |
| serviceTimestampMicros | liczba całkowita | Sygnatura czasowa zakończenia usługi w mikrosekundach. | 1,45132E+15 | Nie | |
| language | ciąg znaków | Język tekstu opinii w formacie kodu języka ISO 639-1 (małe litery, 2-literowy). Musi być zgodny z językiem kierowania dostawcy. | „en” | Nie | Musi być zgodny z językiem kierowania określonym dla powiązanego dostawcy. Jeśli nie zostanie podany, domyślnie przyjmuje wartość „en”. |
| kategoria | obiekt | struktura kategorii, | Nie | ||
| category->categoryId | enum | typ wyliczeniowy | kategoria usługi (w mapie kategorii LSA); | „garage_door_pro” | Nie | |
| kategoria->zadanie | enum | typ wyliczeniowy | Typ zlecenia (zadania) usługi (w taksonomii LSA) | „Naprawa drzwi garażowych” | Nie | |
| confirmedCustomer | Wartość logiczna | Jeśli opinia pochodzi od potwierdzonego klienta (z potencjalnym klientem) | PRAWDA | Nie |