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

Utworzenie pliku danych

Kanał multimediów to obiekt JSON zawierający zbiór encji reprezentujących treści multimedialnych w Twoim katalogu, na przykład seriali telewizyjnych, filmów, utworów czy albumów. Pierwszy krok proces rejestracji to rozpoczęcie tworzenia plików danych. Gdy pliki będą gotowe, musisz hostować pliku danych za pomocą jednej z obsługiwanych metod hostingu, które Google może pobierać regularnie.

Wymagania dotyczące formatu pliku danych

Pliki danych muszą spełniać te wymagania:

Plik danych musi mieć rozszerzenie nazwy .json.
Nie szyfruj pliku danych.
Zakoduj plik danych w formacie UTF-8 (sprawdź ustawienia edytora plików).
Jeśli plik danych 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 itp.).
- Jeśli któryś z tych plików przekracza 1 GB, podziel jego jednostki na kilka pliki (na przykład 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 uwzględnić w jednym pliku.
Upewnij się, że plik jest zakodowany bez BOM, zgodnie ze specyfikacją JSON. Aby można było przeprowadzić kontrolę w systemie operacyjnym Linux, pole hexdump file.json | head -n 1 nie może rozpoczynać się od BBEF pod adresem 0x00.

Rodzaje plików danych

Plik danych produkcyjnych

Reprezentuje on zbiór plików danych JSON, które razem reprezentują cały Twój katalog które chcą udostępnić w Google. W sekcji poniżej dowiesz się, jak utworzyć plik danych.
Jest to jedyny kanał, którego potrzebujesz w przypadku pierwszej integracji z Google.
Po przesłaniu do Google kanał zostanie dokładnie przeanalizowany i przeredagowany aby osiągnąć wyższą jakość, m.in.ilość zapisywanych informacji przed jego ostateczną przetwarzaniem i uruchomieniem.

Testowy plik danych

Istnieją pewne przypadki użycia, które wymagają rozszerzenia produkcyjnego pliku danych. Kilka przykładów takich scenariuszy to:
- Rozszerzenie pliku danych o nowe typy elementów, które nie zostały wprowadzone wcześniej.
- Rozszerzenie kanału o dużą liczbę nowych elementów/metadanych do udostępnienia w nowych ustawienia regionalne.
- Udostępnienie pliku danych na platformach nowych typów. Jeśli na przykład plik danych produkcyjnych to tylko działają w wyszukiwarce Google, a teraz chcesz wprowadzić ją w Google TV.
W takich przypadkach wymagany jest przejściowy plik danych. Ten plik danych to kopia pliku danych produkcyjnych, z tym wyjątkiem, że: ma dodatkowe metadane, np. precyzyjne linki do nowej platformy, metadane w nowym języku. i tak dalej.
Podobnie jak w przypadku pliku danych o produktach, ten plik zostanie dokładnie przeanalizowany i powtarzany kilka razy, i osiągnąć wyższą jakość pod względem ilości zgromadzonych informacji i ich poprawności. Po osiągnięciu progu jakości ten plik danych zastąpi bieżący plik danych o produkcji i stanie się nowy plik danych produkcyjnych.
Plik ten pozwala nam oddzielić początkowe wprowadzenie od wprowadzenia dodatkowych, a następnie osiągnąć wymagane testy bez wpływu na plik danych o produktach. Dzięki temu nie będzie żadnych zakłóceń użytkowników.

Aby uzyskać odpowiedzi na wszelkie 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 za pomocą małego zestawu elementów

Przed utworzeniem pliku danych, który zawiera wszystkie treści z Twojego katalogu, zalecamy utworzenie pliku danych przykładowego pliku danych z niewielkim zestawem elementów. Podczas pracy nad plikiem danych natrafisz na problemów. Ograniczenie rozmiaru zbioru encji pozwoli na debugowanie tych błędów ostrzeżenia.
Weryfikowanie przykładowego pliku danych

Udostępniamy narzędzia, dzięki którym Twój plik danych jest zgodny ze specyfikacjami. Zalecamy za pomocą tych narzędzi, aby usunąć wszystkie błędy i ostrzeżenia w przykładowym pliku danych.
Tworzenie pliku danych o produktach

Gdy upewnisz się, że masz dobrą strukturę dla niewielkiego zbioru elementów, utwórz plik danych dla całego katalogu.

Tworzenie przykładowego pliku danych

Wybierz 1 reprezentatywny podmiot z katalogu. Wybierz element o prawidłowo złożonej strukturze, ale nadal typowym dla elementu w katalogu.

Użyj narzędzia do weryfikacji pliku danych, aby sprawdzić, czy nie ma błędów składniowych i brakujących wymaganych właściwości. (Szczegółowe informacje znajdziesz w następnej sekcji).

Przykład pliku danych z pojedynczym 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"
        }
      ]
    }
  ]
}

Weryfikowanie przykładowego pliku danych

Aby zweryfikować przykładowy plik danych z uporządkowanymi danymi Google, możesz skorzystać z tych narzędzi dla kanałów multimedialnych.

Narzędzie do weryfikacji pliku danych

Narzędzie do weryfikacji pliku danych pozwala zweryfikować tylko jeden element naraz. Użyj tego narzędzia, aby sprawdzić próbkę z Twojego katalogu pod kątem błędów strukturalnych i typowych błędów w treści. Więcej informacji na ten temat znajdziesz o tym narzędziu znajdziesz tutaj.
Narzędzie do sprawdzania poprawności schematu JSON

Narzędzie do walidacji schematu JSON może sprawdzić wszystkie pliki w pliku danych. Używaj tego narzędzia w trakcie podczas opracowywania pliku danych, by uniknąć typowych błędów strukturalnych. Więcej informacji na temat tutaj.

Tworzenie produkcyjnego pliku danych

Po usunięciu wszystkich błędów i ostrzeżeń w przykładowym pliku danych rozwiń go, aby uwzględnić wszystkie błędy. elementów w katalogu.
Użyj narzędzia do weryfikacji pliku danych. aby sprawdzić jednocześnie niewielką liczbę elementów w kanale (wklejając dużą liczbę elementy w narzędziu mogą zablokować przeglądarkę). Sprawdź, czy plik danych zawiera wszystkie elementy w katalogu, porównując liczbę elementów w pliku danych z liczbą elementów w pliku danych katalogu.