Utworzenie pliku danych

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).

    alt_text

  • 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.
  • 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ę od BBEF 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:

  1. 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ń.

  2. 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.

  3. 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

  1. 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.
  2. 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

  1. Po naprawieniu wszystkich błędów i ostrzeżeń w przykładowym kanale rozwiń kanał, aby uwzględnić w nim wszystkie elementy z katalogu.
  2. 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.