Plik danych to obiekt JSON zawierający zbiór elementów reprezentujących treść multimedialną w Twoim katalogu, takich jak seriale, filmy, piosenki, albumy itp. Pierwszym krokiem w procesie wdrażania jest rozpoczęcie tworzenia plików danych. Gdy pliki będą gotowe, musisz hostować plik danych, korzystając z jednej z obsługiwanych metod hostingu, aby umożliwić Google regularne pobieranie plików.
Wymagania dotyczące formatu pliku danych
Oto wymagania dotyczące plików danych:
- Plik danych musi mieć rozszerzenie
.json
. - Nie szyfruj pliku danych.
Zakoduj plik danych w formacie UTF-8 (sprawdź ustawienia edytora plików).
Jeśli plik jest większy niż 1 GB (po zdekompresowaniu), podziel go na kilka plików.
Zalecamy utworzenie pliku według typu encji (np.
tvseries.json
,tvseasons.json
,tvepisodes.json
,movies.json
).- Jeśli którykolwiek z tych plików jest większy niż 1 GB, podziel go na kilka plików (np.
tvepisodes_01.json
,tvepisodes_02.json
itp.). - Jeśli rozmiar pliku jest mniejszy niż 1 GB, nie ma ograniczeń co do liczby elementów, które można umieścić w jednym pliku.
- Jeśli którykolwiek z tych plików jest większy niż 1 GB, podziel go na kilka plików (np.
Sprawdź, czy plik jest kodowany bez pliku BOM, zgodnie ze specyfikacją JSON. Aby sprawdzić system operacyjny Linux,
hexdump file.json | head -n 1
nie może zaczynać się odBBEF
pod adresem 0x00.
Rodzaje plików danych
Plik danych produkcyjnych
- Jest to zestaw plików danych json, które reprezentują cały katalog do uruchomienia w Google. Informacje o tworzeniu pliku danych znajdziesz w sekcji poniżej.
- Jest to jedyny plik danych, którego potrzebujesz, jeśli przeprowadzasz integrację z Google po raz pierwszy.
- Gdy prześlesz ten plik danych do Google, zostanie on dokładnie przeanalizowany i poddany kilkukrotnym powtórzeniom w celu zapewnienia wyższej jakości, m.in.ilości gromadzonych informacji i ich poprawności przed ich przetworzeniem i uruchomieniem.
Plik danych o stanie oczekiwania
- Istnieją pewne przypadki użycia, które wymagają rozwinięcia produkcyjnego pliku danych. Oto kilka przykładów:
- Rozszerzenie kanału, aby uwzględnić nowe typy elementów, które nie zostały wcześniej wprowadzone na rynek.
- Rozszerzenie kanału w celu uwzględnienia dużej liczby nowych elementów/metadanych do wprowadzenia w nowych językach.
- Rozszerzenie kanału na nowe typy platform. Na przykład, gdy kanał produkcyjny zostanie uruchomiony w wyszukiwarce Google, a teraz chcesz rozszerzyć go na Google TV.
- W takich przypadkach plik danych jest wymagany. Ten plik jest kopią pliku produkcyjnego, z wyjątkiem dodatkowych metadanych, takich jak precyzyjne linki do nowej platformy czy metadane dla nowego języka i tak dalej.
- Podobnie jak w przypadku pliku danych produkcyjnych jest on szczegółowo analizowany i powtarzany kilka razy, aby uzyskać pasek wyższej jakości z większą ilością gromadzonych informacji i prawidłowością. Gdy pasek jakości zostanie osiągnięty, zastąpimy bieżący kanał produkcyjny nowym plikiem.
- Dzięki temu możemy oddzielić wstępne uruchomienie od dodatkowych uruchomień i przeprowadzić wszystkie wymagane testy bez wpływu na plik produkcyjny. Dzięki temu nie wystąpią przerwy w działaniu usług dla użytkowników.
Jeśli masz pytania na ten temat, skontaktuj się z przedstawicielem Google.
Tworzenie pliku danych
Podczas tworzenia pliku danych postępuj zgodnie z tymi sprawdzonymi metodami:
Tworzenie przykładowego pliku danych z niewielkim zestawem elementów
Zanim utworzysz plik danych z całą zawartością katalogu, zalecamy utworzenie przykładowego pliku danych z małym zestawem elementów. Podczas pracy z plikiem danych mogą wystąpić problemy. Ograniczenie rozmiaru zestawu encji umożliwi debugowanie tych błędów i ostrzeżeń.
Sprawdzanie przykładowego pliku danych
Udostępniamy narzędzia, które gwarantują, że Twój plik danych jest zgodny ze specyfikacją. Użyj tych narzędzi, aby naprawić wszystkie błędy i ostrzeżenia w przykładowym pliku danych.
Tworzenie produkcyjnego pliku danych
Gdy upewnisz się, że wszystko jest w porządku dla niewielkiego zbioru jednostek, utwórz plik danych dla całego katalogu.
Tworzenie przykładowego pliku danych
- Wybierz z katalogu jeden podmiot. Wybierz jednostkę o rozsądnie złożonej strukturze, która jednak jest typowa w przypadku elementów w katalogu.
- Użyj narzędzia do weryfikacji pliku danych, aby sprawdzić, czy nie występują błędy składni i brakuje wymaganych właściwości. (Więcej informacji znajdziesz w następnej sekcji).
Przykład kanału z 1 elementem
Movie
{ "@context": "http://schema.org", "@type": "DataFeed", "dateModified": "2018-07-20T00:44:51Z", "dataFeedElement": [ { "@context": ["http://schema.org", {"@language": "en"}], "@type": "Movie", "@id": "http://www.example.com/my_favorite_movie", "url": "http://www.example.com/my_favorite_movie", "name": "My Favorite Movie", "potentialAction": { "@type": "WatchAction", "target": { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true", "inLanguage": "en", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/MobileWebPlatform", "http://schema.org/AndroidPlatform", "http://schema.org/AndroidTVPlatform", "http://schema.org/IOSPlatform", "http://schema.googleapis.com/GoogleVideoCast" ] }, "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "subscription", "requiresSubscription": { "@type": "MediaSubscription", "name": "Example Package", "commonTier": true, "@id": "[partner determined string]" }, "availabilityStarts": "2018-07-21T10:35:29Z", "availabilityEnds": "2019-10-21T10:35:29Z", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "CA" } ] } }, "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie", "releasedEvent": { "@type": "PublicationEvent", "startDate": "2008-01-20", "location": { "@type": "Country", "name": "US" } }, "description": "This is my favorite movie.", "actor": [ { "@type": "Person", "name": "John Doe", "sameAs": "https://en.wikipedia.org/wiki/John_Doe" }, { "@type": "Person", "name": "Jane Doe", "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe" } ], "identifier": [ { "@type": "PropertyValue", "propertyID": "IMDB_ID", "value": "tt0123456" } ] } ] }
Sprawdzanie przykładowego pliku danych
Dzięki tym narzędziom możesz sprawdzić poprawność przykładowego pliku danych za pomocą specyfikacji uporządkowanych danych Google w kanałach multimedialnych.
Narzędzie do weryfikacji pliku danych
Narzędzie do weryfikacji kanału danych może jednorazowo zweryfikować pojedynczy element. Użyj tego narzędzia, aby zweryfikować przykładową jednostkę z katalogu pod kątem błędów strukturalnych i typowych błędów zawartości. Więcej informacji na temat tego narzędzia znajdziesz tutaj.
Narzędzie do weryfikacji schematu JSON
Narzędzie JSON Schema Validation może sprawdzić wszystkie pliki w kanale. Podczas tworzenia pliku danych używaj tego narzędzia, aby uniknąć typowych błędów strukturalnych. Więcej informacji na temat tego narzędzia znajdziesz tutaj.
Tworzenie produkcyjnego pliku danych
- Po naprawieniu wszystkich błędów i ostrzeżeń w przykładowym kanale rozwiń kanał, aby uwzględnić w nim wszystkie elementy z katalogu.
- Często używaj narzędzia do weryfikacji kanału danych, aby weryfikować małą liczbę jednostek w kanale naraz (wklejenie dużej liczby elementów w tym narzędziu może zablokować przeglądarkę). Sprawdź, czy kanał zawiera wszystkie elementy z katalogu, porównując liczbę elementów w pliku z liczbą elementów w katalogu.