Ta strona została przetłumaczona przez Cloud Translation API.

Utworzenie pliku danych

Plik danych z multimediami to obiekt JSON zawierający zbiór elementów reprezentujących treści multimedialne w Twoim katalogu, np. seriale, filmy, piosenki, albumy itp. Pierwszym krokiem w procesie rejestracji jest rozpoczęcie tworzenia plików danych. Gdy pliki będą gotowe, musisz hostować kanał za pomocą jednej z obsługiwanych metod hostowania, aby Google mogło regularnie pobierać pliki.

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 pliku danych jest większy niż 1 GB (nieskompresowany), podziel go na kilka plików.
Zalecamy utworzenie osobnego pliku dla każdego typu encji (np. tvseries.json, tvseasons.json, tvepisodes.json, movies.json itd.).
- Jeśli którykolwiek z tych plików przekracza 1 GB, podziel jego elementy na kilka plików (na przykład tvepisodes_01.json, tvepisodes_02.json itp.).
- Dopóki rozmiar pliku nie przekracza 1 GB, nie ma limitu liczby elementów, które możesz umieścić w jednym pliku.
Upewnij się, że plik jest zakodowany bez BOM zgodnie ze specyfikacją JSON. W systemie operacyjnym Linux hexdump file.json | head -n 1 nie może zaczynać się od BBEF na adresie 0x00.

Rodzaje plików danych

Plik danych produkcyjnych

Jest to zbiór plików plików danych w formacie JSON, które razem stanowią cały katalog, który chcesz wprowadzić na Google. W sekcji poniżej dowiesz się, jak utworzyć plik danych.
Jeśli integracja z Google jest przeprowadzana po raz pierwszy, potrzebujesz tylko tego pliku danych.
Gdy ten plik danych zostanie przesłany do Google, zostanie dokładnie przeanalizowany i kilkakrotnie powtórzony, aby osiągnąć wyższy poziom jakości pod względem ilości uchwycionych informacji i ich poprawności, zanim zostanie ostatecznie przetworzony i uruchomiony.

Plik danych w wersji testowej

W niektórych przypadkach konieczne jest rozszerzenie pliku danych produkcyjnych. Oto kilka przykładów takich sytuacji:
- Rozszerzenie pliku danych o nowe typy elementów, które nie były wcześniej dostępne.
- Rozszerzenie pliku danych o ogromną liczbę nowych jednostek i metadanych, które mają być dostępne w nowych lokalizacjach.
- Rozszerzenie pliku danych na nowe typy platform. Może to być na przykład sytuacja, gdy plik danych produkcyjnych jest dostępny tylko w wyszukiwarce Google, a teraz chcesz go udostępnić w Google TV.
W takich przypadkach wymagany jest plik danych w wersji testowej. Ten plik danych jest kopią wersji produkcyjnej, ale zawiera dodatkowe metadane, takie jak precyzyjne linki do nowej platformy, metadane dla nowego regionu itp.
Podobnie jak w przypadku pliku danych produkcyjnych, zostanie on dokładnie przeanalizowany i kilkakrotnie powtórzony, aby osiągnąć wyższą jakość pod względem ilości uchwycionych informacji i ich poprawności. Gdy osiągniesz wymagany poziom jakości, ten plik danych zastąpi obecny plik danych w wersji produkcyjnej i stanie się nowym plikiem danych w wersji produkcyjnej.
Ten plik danych pozwala nam oddzielić początkowe wdrożenie od dodatkowych wdrożeń i przeprowadzić wszystkie wymagane testy bez wpływu na plik danych w wersji produkcyjnej. Zapewnia to płynne działanie aplikacji.

Jeśli masz pytania dotyczące powyższych informacji, skontaktuj się z przedstawicielem Google.

Tworzenie pliku danych

Podczas tworzenia pliku danych postępuj zgodnie z tymi sprawdzonymi metodami:

Tworzenie przykładowego pliku danych za pomocą niewielkiego zbioru jednostek

Przed utworzeniem pliku danych zawierającego wszystkie treści z katalogu zalecamy utworzenie przykładowego pliku danych z małym zestawem elementów. Podczas pracy nad kanałem możesz napotkać problemy. Ograniczenie rozmiaru zbioru jednostek ułatwi Ci debugowanie tych błędów i ostrzeżeń.
Sprawdzanie przykładowego pliku danych

Udostępniamy narzędzia, które zapewniają zgodność pliku danych z wymaganiami. Zalecamy użycie tych narzędzi do naprawienia wszystkich błędów i ostrzeżeń znalezionych w próbnym pliku danych.
Tworzenie pliku danych produkcyjnego

Po sprawdzeniu, czy masz odpowiednią strukturę dla małego zbioru jednostek, utwórz plik danych dla całego katalogu.

Tworzenie przykładowego pliku danych

Wybierz jeden reprezentatywny element z katalogu. Wybierz element o dość złożonej strukturze, ale nadal typowej dla elementu w katalogu.

Użyj narzędzia do sprawdzania pliku danych, aby sprawdzić, czy nie występują w nim błędy składni ani brak wymaganych właściwości. (szczegóły znajdziesz w następnej sekcji).

Przykład pliku danych z jednym 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 poprawności przykładowego pliku danych

Aby sprawdzić, czy przykładowy plik danych jest zgodny ze specyfikacją uporządkowanych danych Google dotyczącą plików danych z multimediami, możesz użyć tych narzędzi.

Narzędzie do weryfikacji pliku danych

Narzędzie do weryfikacji pliku danych może weryfikować tylko jeden element naraz. Użyj tego narzędzia, aby sprawdzić, czy w przykładowym elemencie z katalogu nie ma błędów strukturalnych i typowych błędów treści. Więcej informacji o tym narzędziu znajdziesz tutaj.
Narzędzie do walidacji schematu JSON

Narzędzie do weryfikacji schematu JSON może weryfikować wszystkie pliki w kanale danych. Używaj tego narzędzia podczas tworzenia pliku danych, aby uniknąć typowych błędów strukturalnych. Więcej informacji o tym narzędziu znajdziesz tutaj.

Tworzenie pliku danych produkcyjnego

Gdy wszystkie błędy i ostrzeżenia w przykładowym pliku danych zostaną naprawione, rozszerz plik danych, aby uwzględnić wszystkie elementy w katalogu.
Często używaj narzędzia do weryfikacji pliku danych, aby weryfikować w jednym czasie niewielką liczbę encji w pliku danych (wklejanie dużej liczby encji w narzędziu może spowodować zawieszenie przeglądarki). Sprawdź, czy Twój plik danych zawiera wszystkie elementy w katalogu, porównując liczbę elementów w pliku danych z liczbą elementów w katalogu.