Utworzenie pliku danych

Plik danych multimedialnych to obiekt JSON, który zawiera kolekcję elementów reprezentujących treści multimedialne w Twoim katalogu, takie jak seriale telewizyjne, filmy, utwory, albumy i inne. Pierwszym krokiem w procesie wprowadzania jest rozpoczęcie tworzenia kanałów. Gdy pliki będą gotowe, musisz hostować plik danych, korzystając z jednej z obsługiwanych metod hostingu, aby Google mogło go regularnie pobierać.

Wymagania dotyczące formatu pliku danych

Wymagania dotyczące plików danych:

  • Plik danych musi mieć rozszerzenie nazwy pliku .json.
  • Nie szyfruj pliku danych.

  • Zakoduj plik danych w formacie UTF-8 (sprawdź ustawienia edytora plików).

    alt_text

  • Jeśli plik danych jest większy niż 1 GB (nieskompresowany), podziel go na kilka plików.

  • Zalecamy utworzenie 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 (np. tvepisodes_01.json, tvepisodes_02.json itd.).
    • 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.

  • Upewnij się, że plik jest zakodowany bez 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 o produktach

  • Jest to zestaw plików danych JSON, które razem reprezentują cały katalog, który chcesz udostępnić w Google. W sekcji poniżej dowiesz się, jak utworzyć plik danych.
  • Jeśli przeprowadzasz integrację z Google po raz pierwszy, potrzebujesz tylko tego pliku danych.
  • Po przesłaniu tego pliku danych do Google zostanie on dokładnie przeanalizowany i kilkakrotnie sprawdzony, aby zapewnić wyższą jakość pod względem ilości i poprawności rejestrowanych informacji, zanim zostanie ostatecznie przetworzony i uruchomiony.

Plik danych w trybie przejściowym

  • W niektórych przypadkach konieczne jest rozszerzenie pliku danych o produkcji. 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 elementów i metadanych w celu wprowadzenia usługi w nowych regionach.
    • Rozszerzenie pliku danych na nowe typy platform. Na przykład gdy plik danych o produktach produkcyjnych jest uruchomiony tylko w wyszukiwarce Google, a teraz chcesz rozszerzyć jego działanie na Google TV.
  • W takich przypadkach wymagany jest plik danych przejściowych. Ten plik danych o produktach jest kopią produkcyjnego pliku danych o produktach, ale zawiera dodatkowe metadane, np. precyzyjne linki do nowej platformy, metadane dla nowego regionu itp.
  • Podobnie jak w przypadku pliku danych o produktach, zostanie on dokładnie przeanalizowany i kilka razy powtórzony, aby osiągnąć wyższy poziom jakości w odniesieniu do ilości przechwytywanych informacji i ich poprawności. Po osiągnięciu odpowiedniego poziomu jakości ten plik danych o produktach zastępuje bieżący plik danych o produktach i staje się nowym plikiem danych o produktach.
  • Ten plik danych o produktach pozwala nam oddzielić pierwsze uruchomienie od kolejnych i przeprowadzić wszystkie wymagane testy bez wpływu na produkcyjny plik danych o produktach. Dzięki temu nie zakłócisz działania usługi dla użytkowników.

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:

  1. Tworzenie przykładowego pliku danych z niewielkim zestawem elementów

    Zanim utworzysz plik danych zawierający wszystkie treści z Twojego katalogu, zalecamy utworzenie przykładowego pliku danych z niewielkim zestawem elementów. Podczas pracy nad kanałem możesz napotkać problemy. Ograniczenie rozmiaru zbioru elementów ułatwi debugowanie tych błędów i ostrzeżeń.

  2. Sprawdzanie przykładowego pliku danych

    Udostępniamy narzędzia, które pomogą Ci zadbać o zgodność pliku danych ze specyfikacją. Zalecamy użycie tych narzędzi do rozwiązania wszystkich błędów i ostrzeżeń znalezionych w przykładowym pliku danych.

  3. Tworzenie pliku danych o produktach

    Gdy upewnisz się, że struktura małego zestawu elementów jest prawidłowa, utwórz plik danych dla całego katalogu.

Tworzenie przykładowego pliku danych

  1. Wybierz 1 reprezentatywny podmiot z katalogu. Wybierz encję o dość złożonej strukturze, ale typową dla encji w katalogu.
  2. Użyj narzędzia do sprawdzania poprawności schematu JSON, aby sprawdzić, czy nie ma błędów składni i brakujących wymaganych właściwości. (więcej informacji 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 przykładowego pliku danych

Aby sprawdzić przykładowy plik danych pod kątem zgodności ze specyfikacjami uporządkowanych danych Google dotyczącymi plików danych multimedialnych, możesz użyć tych narzędzi:

  • Narzędzie do sprawdzania poprawności schematu JSON

    Narzędzie do sprawdzania poprawności schematu JSON sprawdza wszystkie pliki w pliku danych lokalnie przed przesłaniem. Używaj tego narzędzia podczas tworzenia pliku danych, aby uniknąć typowych błędów strukturalnych i błędów typu. Więcej informacji o tym narzędziu znajdziesz tutaj.

  • Usługi katalogu w Search Console

    Gdy przedstawiciel Google włączy usługę katalogu w Search Console, a Twój przykładowy lub testowy plik danych zostanie przetworzony, użyj usług katalogu w Search Console, aby sprawdzić błędy weryfikacji na poziomie encji, ostrzeżenia i diagnostykę przetwarzania.

Tworzenie produkcyjnego pliku danych o produktach

  1. Po usunięciu wszystkich błędów i ostrzeżeń strukturalnych w przykładowym pliku danych rozszerz go, aby zawierał wszystkie elementy z Twojego katalogu.
  2. Uruchom narzędzie do sprawdzania poprawności schematu JSON na rozszerzonych plikach kanału i po przesłaniu sprawdź właściwości katalogu w Search Console, aby upewnić się, że nie ma błędów weryfikacji. Sprawdź, czy plik danych zawiera wszystkie elementy z katalogu, porównując liczbę elementów w pliku danych z liczbą elementów w katalogu.
Wstecz
Określ cenę
Dalej
Udostępnianie kanału