Właściwości znaczników treści na kanałach telewizyjnych na żywo

W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści BroadcastService, CableOrSatelliteService, TelevisionChannel i Organization. Aby lepiej zrozumieć zależności między tymi typami, zapoznaj się z koncepcjami kanałów na żywo.

Tabela specyfikacji BroadcastService

Usługa Oczekiwany typ Opis
@context tekstowy. Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
  • Gdzie „xx” to język ciągów znaków w pliku danych. Każdy kontekst główny jednostki powinien mieć ustawiony odpowiedni język w formacie @language w formacie BCP 47. Jeśli np. język to hiszpański, zakłada się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów jest w języku angielskim.
@type tekstowy. Wymagane – zawsze ma wartość BroadcastService.
@id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Niepowtarzalny na całym świecie katalog
  • Statyczny – identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli właściwość adresu URL programu się zmienia). Będzie on traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem.
  • W formie identyfikatora ujednoliconego zasobu (URI)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie właściwości url jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
url Adres URL Wymagany, jeśli ma to zastosowaniekanoniczny adres URL nadawcy, jeśli kanał jest dostępny do wyświetlania w internecie. Jest opcjonalne w przypadku usług kablowych/satelitarnych/naziemnych. Google używa tego adresu URL do dopasowania zawartości Twojego pliku danych do zawartości baz danych Google.
url musi spełniać te wymagania:
  • url musi być globalnie niepowtarzalna
  • url musi zawierać działający kanoniczny URL, który Google może indeksować.
Szczegółowe informacje o precyzyjnych linkach odtwarzania znajdziesz w opisie właściwości target obiektu urlTemplate.
name tekstowy. Wymagane – nazwa sieci.
  • Użyj tablicy do wyświetlenia nazw w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że w przypadku każdego języka obsługiwana jest tylko jedna nazwa (para język–kraj).
broadcastDisplayName tekstowy. Wymagany – wyświetlana nazwa sieci, którą użytkownicy mogą zwykle zobaczyć w przewodnikach po programach itp. Wartość może być taka sama jak wartość nazwy.
callSign tekstowy. Oficjalny znak wywoławczy usługi transmisji.
inLanguage Tekst lub Język Zdecydowanie zalecane dlaczego? Podstawowy język transmisji na kanale. Użyj jednego z kodów języków dostępnych w standardzie IETF BCP 47.
category tekstowy. Zdecydowanie zalecane dlaczego? Kategoria elementu. Większe znaki lub ukośniki mogą ułatwiać hierarchię kategorii, np. sport, sport > piłka nożna, wiadomości, filmy, muzyka, filmy dokumentalne.
contentRating Tekst lub Ocena Wymagany w przypadku usług telewizyjnych tylko dla dorosłych – najbardziej restrykcyjna ocena treści przesyłanych na kanał. Jeśli ocena treści jest podana w postaci ciągu tekstowego, agencja musi dołączyć do oceny odstęp między nimi. Na przykład ocena „TV-Y” od agencji „TVPG” w Stanach Zjednoczonych jest opisana jako „TVPG TV-Y”. Zobacz listę agencji.
contentRating.author Tekst lub Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej.
contentRating.ratingValue tekstowy. Wymagany, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode tekstowy. Kod porad dotyczących treści. Możliwe wartości to D, FV, L, S i V. D = dialog, FV = przemoc fantasy, L = język, S = treści o charakterze seksualnym, V = przemoc.
description tekstowy. Opis usługi transmisji. Limit: 300 znaków. Użyj tablicy, aby podać opisy w wielu językach lub o różnej długości.
slogan tekstowy. Hasło usługi telewizyjnej.
areaServed Kraj, Stan, Miasto lub GeoShape Wymagany, jeśli ma zastosowanie – wymagany, jeśli przełącznik kanału jest realizowany przez dostawcę usług telewizyjnych – obszar, w którym użytkownicy mogą spodziewać się danej usługi telewizyjnej. Aby określić kraje, użyj kodu kraju w formacie ISO 3166-1.
  • Użyj tablicy do reprezentowania wielu obszarów.
  • Nie mieszaj opcji Country, State, City z wartością GeoShape.
  • logo ImageObject Wymagany, jeśli integracja z Google TV. Zdecydowanie zalecane w innym przypadku Dlaczego? Obraz przedstawiający tę usługę radiową.
    • Integracje z Google TV wymagają jednego logo, którego można używać na ciemnym tle. Tło powinno być przezroczyste, a logo powinno być kolorowe lub białe.
    • Obraz logo powinien mieć współczynnik proporcji 1:1, 4:3 lub 16:9 (w tej kolejności) i rozdzielczość 80 x 80 pikseli lub większą.
    • Użyj wartości forDarkBackground dla właściwości niestandardowej contentAttributes w ramach właściwości additionalProperty, aby wskazać typ tła, na którym chcesz użyć logo.
    • Aby zachować współczynnik proporcji, dozwolone jest dodawanie długości lub szerokości (ale nie obu tych elementów).
    • Inne wymagania i specyfikacje znajdziesz w sekcji Obraz.
    Przykład poniżej
    potentialAction WatchAction (oglądanie) Wymagany, jeśli ma zastosowanieobiekt znaczników działania, który zawiera szczegółowe informacje o działaniu. Więcej informacji znajdziesz we właściwościach znaczników działania.
    videoFormat tekstowy. Najwyższa definicja jakości obsługiwana przez tę usługę transmisji, na przykład
    • „SD” – do standardowej definicji.
    • „HD” – wysoka rozdzielczość
    • „2K” w przypadku rozdzielczości 2K.
    • „4K” w rozdzielczości 4K.
    • „8K” w rozdzielczości 8K.
    broadcastTimezone tekstowy. Strefa czasowa tej usługi emisji w formacie IANA, np. Ameryka/Los_Angeles. Użyj tablicy dla wielu stref czasowych.
    broadcastAffiliateOf Organizacja Wymagane – sieć telewizyjna, która oferuje programowanie tej organizacji naziemnej lub organizacja, do której należy dana usługa.
    broadcastAffiliateOf.@id tekstowy. Wymagane – ustaw na @id sieci telewizyjnej.
    broadcastAffiliateOf.@type tekstowy. Wymagane – zawsze ma wartość Organization.
    identifier PropertyValue Zdecydowanie zalecane dlaczego? – zewnętrzny lub inny identyfikator, który identyfikuje ten podmiot, np. _PARTNER_ID_. Dozwolonych jest wiele identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
    popularityScore Specyfikacjapopularności Zdecydowanie zalecane dlaczego? Wynik wykorzystywany przez Google wraz z innymi sygnałami do określania, które multimedia są odtwarzane użytkownikom. Wynik pokazuje popularność treści w porównaniu z innymi treściami w Twoim katalogu – dlatego skala wyniku musi być spójna we wszystkich kanałach w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
    popularityScore.@type tekstowy. Zawsze ustawiona na PopularityScoreSpecification.
    popularityScore.value Number Nieujemna wartość liczbowa, która wskazuje popularność danego elementu; wyższy wynik oznacza większą popularność.
    popularityScore.eligibleRegion Kraj Regiony, w których dany wynik popularności ma zastosowanie. Jeśli wynik popularności ma zastosowanie globalnie, ustaw wartość EARTH. Domyślnie ta właściwość ma wartość EARTH.
    Note: Popularność w poszczególnych regionach ma pierwszeństwo przed globalną (EARTH) popularnością

    Przykład BroadcastService

    {
        "@context": [
            "http://schema.org",
            {
                "@language": "en"
            }
        ],
        "@type": "BroadcastService",
        "@id": "http://example.com/stations/example-tv",
        "name": "EXAMPLE-TV",
        "broadcastDisplayName": "ABCD",
        "url": "http://example.com/stations/example-tv",
        "callSign": "EXA-TV",
        "videoFormat": "SD",
        "inLanguage": "en",
        "broadcastTimezone": "America/Los_Angeles",
        "broadcastAffiliateOf": {
            "@type": "Organization",
            "@id": "http://example.com/networks/abcd-network"
        },
        "identifier": [
            {
                "@type": "PropertyValue",
                "propertyID": "TMS_ID",
                "value": "12258"
            },
            {
                "@type": "PropertyValue",
                "propertyID": "_PARTNER_ID_",
                "value": "exampletv-123456"
            }
        ],
        "popularityScore": {
            "@type": "PopularityScoreSpecification",
            "value": 178,
            "eligibleRegion": [
                {
                    "@type": "Country",
                    "name": "US"
                }
            ]
        },
        "potentialAction": {
            "@type": "WatchAction",
            "target": {
                "@type": "EntryPoint",
                "urlTemplate": "http://example.com/livestream",
                "actionPlatform": [
                    "http://schema.org/DesktopWebPlatform",
                    "http://schema.org/MobileWebPlatform",
                    "http://schema.org/AndroidPlatform",
                    "http://schema.org/IOSPlatform",
                    "http://schema.googleapis.com/GoogleVideoCast",
                    "http://schema.org/AndroidTVPlatform"
                ]
            },
            "actionAccessibilityRequirement": {
                "@type": "ActionAccessSpecification",
                "category": "externalsubscription",
                "availabilityStarts": "2018-07-21T10:35:29Z",
                "availabilityEnds": "2019-10-21T10:35:29Z",
                "requiresSubscription": {
                    "@type": "MediaSubscription",
                    "@id": "http://example.com/subscription",
                    "name": "ABCD",
                    "sameAs": "http://example.com/subscription",
                    "authenticator": {
                        "@type": "Organization",
                        "name": "TVE"
                    }
                },
                "eligibleRegion": [
                    {
                        "@type": "Country",
                        "name": "US"
                    }
                ]
            }
        },
        "logo": [
            {
                "@context": "http://schema.org",
                "@type": "ImageObject",
                "name": "Example Logo Light",
                "contentUrl": "http://example.com/images/example-logo-light.jpg",
                "additionalProperty": [
                    {
                        "@type": "PropertyValue",
                        "name": "contentAttributes",
                        "value": [
                            "forLightBackground"
                        ]
                    }
                ]
            },
            {
                "@context": "http://schema.org",
                "@type": "ImageObject",
                "name": "Example Logo Dark",
                "contentUrl": "http://example.com/images/example-logo-dark.jpg",
                "additionalProperty": [
                    {
                        "@type": "PropertyValue",
                        "name": "contentAttributes",
                        "value": [
                            "forDarkBackground"
                        ]
                    }
                ]
            }
        ]
    }
    

    Tabela specyfikacji CableOrateService

    Usługa Oczekiwany typ Opis
    @context tekstowy. Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
    • Gdzie „xx” to język ciągów znaków w pliku danych. Każdy kontekst główny jednostki powinien mieć ustawiony odpowiedni język w formacie @language w formacie BCP 47. Jeśli np. język to hiszpański, zakłada się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów jest w języku angielskim.
    @type tekstowy. Wymagane – zawsze ma wartość CableOrSatelliteService.
    @id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
    @id musi spełniać te wymagania:
    • Niepowtarzalny na całym świecie katalog
    • Statyczny
    • W formie identyfikatora ujednoliconego zasobu (URI)
    url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie właściwości url jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
    name tekstowy. Wymagane – nazwa usługi telewizyjnej.
    • Użyj tablicy do wyświetlenia nazw w różnych językach. Zobacz przykład Wiele regionów i języków.
    • Pamiętaj, że w przypadku każdego języka obsługiwana jest tylko jedna nazwa (para język–kraj).
    areaServed Kraj, Stan, Miasto lub GeoShape Wymagany – obszar, w którym użytkownicy mogą spodziewać się usługi transmisji.
    provider Organizacja Wymagane – dostawca nadrzędny usługi (w stosownych przypadkach). Na przykład firma ExampleTV jest dostawcą usług regionalnych ExampleTV San Francisco i ExampleTV San Diego.
    provider.@id tekstowy. Wymagane – identyfikator operatora telewizyjnego.
    provider.@type tekstowy. Wymagane – zawsze ma wartość Organization.
    identifier PropertyValue Zdecydowanie zalecane dlaczego? – zewnętrzny lub inny identyfikator, który identyfikuje ten podmiot, np. identyfikator Gracenote TMS w przypadku tej usługi transmisji. Dozwolonych jest wiele identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.

    Przykłady telewizji kablowej lub satelitarnej

    Przykład usługi telewizji kablowej lub satelitarnej:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"CableOrSatelliteService",
      "@id":"http://example.com/provider-lineups/exampletv-san-francisco",
      "name":"ExampleTV San Francisco",
      "provider": {
        "@type": "Organization",
        "@id": "http://example.com/providers/exampletv"
      },
      "areaServed":[
        {
          "@type":"GeoShape",
          "@id": "http://example.com/area1"
        }
      ],
      "identifier": {
        "@type": "PropertyValue",
        "propertyID": "TMS_ID",
        "value": "12345"
      }
    }
    
    {
      "@type": "GeoShape",
      "@id": "http://example.com/area1",
      "addressCountry": "US",
      "postalCode": [
        "94118",
        "94119"
      ]
    }
    

    Przykład wirtualnego dystrybutora treści wideo (vMVPD):

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"CableOrSatelliteService",
      "@id":"http://example.com/providers/my-online-example-tv",
      "name":"My Online Example TV",
      "provider": {
        "@type": "Organization",
        "@id": "http://my-online-tv.com"
      },
      "areaServed":[
        {
          "@type":"Country",
          "name": "US",
        },
        {
          "@type":"Country",
          "name": "CA",
        }
      ]
    }
    

    Tabela specyfikacji TelevisionChannel

    Usługa Oczekiwany typ Opis
    @context tekstowy. Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
    • Gdzie „xx” to język ciągów znaków w pliku danych. Każdy kontekst główny jednostki powinien mieć ustawiony odpowiedni język w formacie @language w formacie BCP 47. Jeśli np. język to hiszpański, zakłada się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów jest w języku angielskim.
    @type tekstowy. Wymagane – zawsze ma wartość TelevisionChannel.
    @id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
    @id musi spełniać te wymagania:
    • Niepowtarzalny na całym świecie katalog
    • Statyczny
    • W formie identyfikatora ujednoliconego zasobu (URI)
    url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie właściwości url jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
    broadcastChannelId tekstowy. Wymagany – unikalny identyfikator, na podstawie którego produkt BroadcastService może być identyfikowany jako usługa telewizji kablowej, satelitarnej lub internetowej.
    • W Stanach Zjednoczonych jest to zwykle liczba telewizji kablowej lub satelitarnej.
    • W przypadku usługi telewizyjnej (np. vMVPD) wpisz nazwę kanału.
    channelOrder Number Wymagane w przypadku Google TV, w przeciwnym razie – ta właściwość wskazuje kolejność, w jakiej kanały mają być wyświetlane w elektronicznym przewodniku po integracji z Google TV.

    Wartość channelOrder powinna być unikalna dla wszystkich kanałów w kanale i powinna zacząć się od 1. channelOrder nie może mieć wartości ujemnej ani zero.
    broadcastServiceTier tekstowy. Użyj tych wartości:
    • Free dla kanału, który nie wymaga subskrypcji.
    • Standard w przypadku kanałów objętych subskrypcją podstawową.
    • Premium w przypadku kanałów, które wymagają płatności za subskrypcję podstawową.
    Użyj tablicy, aby podać wiele wartości.
    inBroadcastLineup Usługa kablowa Wymagane@id z CableOrSatelliteService, które zapewniają kanał.
    providesBroadcastService BroadcastService Wymagany – element @id kanału BroadcastService, którego program jest udostępniany na tym kanale.

    Przykłady kanałów telewizyjnych

    Przykład kanału telewizji kablowej lub satelitarnej:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"TelevisionChannel",
      "@id":"http://example.com/channels/exampleTV/example-tv-7",
      "broadcastChannelId":"7",
      "channelOrder": 1,
      "broadcastServiceTier":["Premium", "Standard"],
      "inBroadcastLineup":{
        "@type":"CableOrSatelliteService",
        "@id":"http://example.com/providers/exampleTV-san-francisco"
      },
      "providesBroadcastService":{
        "@type":"BroadcastService",
        "@id":"http://example.com/stations/example-tv"
      }
    }
    

    Przykład dla kanału telewizyjnego online:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"TelevisionChannel",
      "@id":"http://example.com/channels/my-online-example-tv/sport-channel",
      "broadcastChannelId":"sport-channel",
      "channelOrder": 3,
      "broadcastServiceTier":"Premium",
      "inBroadcastLineup":{
        "@type":"CableOrSatelliteService",
        "@id":"http://example.com/providers/my-online-example-tv"
      },
      "providesBroadcastService":{
        "@type":"BroadcastService",
        "@id":"http://example.com/stations/sport-channel"
      }
    }
    

    Tabela specyfikacji organizacji

    Usługa Oczekiwany typ Opis
    @context tekstowy. Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
    • Gdzie „xx” to język ciągów znaków w pliku danych. Każdy kontekst główny jednostki powinien mieć ustawiony odpowiedni język w formacie @language w formacie BCP 47. Jeśli np. język to hiszpański, zakłada się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów jest w języku angielskim.
    @type tekstowy. Wymagane – zawsze ma wartość Organization.
    @id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
    @id musi spełniać te wymagania:
    • Niepowtarzalny na całym świecie katalog
    • Statyczny
    • W formie identyfikatora ujednoliconego zasobu (URI)
    url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie właściwości url jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
    name tekstowy. Wymagane – nazwa sieci telewizyjnej, dostawcy treści telewizyjnych lub operatora telewizyjnego.
    • Użyj tablicy do wyświetlenia nazw w różnych językach. Zobacz przykład Wiele regionów i języków.
    • Pamiętaj, że w przypadku każdego języka obsługiwana jest tylko jedna nazwa (para język–kraj).
    description tekstowy. Opis organizacji. Limit: 300 znaków. Użyj tablicy, aby podać opisy w wielu językach lub o różnej długości.
    sameAs Adres URL Zdecydowanie zalecane dlaczego? Adres URL strony Wikipedii umożliwiającej identyfikację sieci telewizyjnej. Musi być ona inna niż właściwość adresu URL. Wypełnij tylko stronę Wikipedii poświęconą pojedynczemu podmiotowi. Pamiętaj, że strony Wikipedii mogą używać terminów „kanał”.
    potentialAction WatchAction (oglądanie) Wymagany, jeśli ma zastosowanie – wymagany, jeśli masz wiele kanałów (BroadcastService) związanych z organizacją. Obiekt znaczników działań, który zawiera szczegółowe informacje o działaniu. Więcej informacji znajdziesz we właściwościach znaczników działania.
    url Adres URL Adres URL organizacji. Google używa tego adresu URL do uzgodnienia tej organizacji z organizacją w bazach danych Google.
    identifier PropertyValue Zdecydowanie zalecane dlaczego? – zewnętrzny lub inny identyfikator, który identyfikuje dany podmiot, np. identyfikator TMS tej organizacji. Dozwolonych jest wiele identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
    popularityScore Specyfikacjapopularności Zdecydowanie zalecane dlaczego? Wynik wykorzystywany przez Google wraz z innymi sygnałami do określania, które multimedia są odtwarzane użytkownikom. Wynik pokazuje popularność treści w porównaniu z innymi treściami w Twoim katalogu – dlatego skala wyniku musi być spójna we wszystkich kanałach w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
    popularityScore.@type tekstowy. Zawsze ustawiona na PopularityScoreSpecification.
    popularityScore.value Number Nieujemna wartość liczbowa, która wskazuje popularność danego elementu; wyższy wynik oznacza większą popularność.
    popularityScore.eligibleRegion Kraj Regiony, w których dany wynik popularności ma zastosowanie. Jeśli wynik popularności ma zastosowanie globalnie, ustaw wartość EARTH. Domyślnie ta właściwość ma wartość EARTH.
    Note: Popularność w poszczególnych regionach ma pierwszeństwo przed globalną (EARTH) popularnością

    Przykład organizacji

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"Organization",
      "@id":"http://example.com/networks/abcd-network",
      "name":"ABCD",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "TMS_ID",
          "value": "12345"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "_PARTNER_ID_",
          "value": "exampletv-12345"
        }
      ],
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://example.com/networkstream",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast",
            "http://schema.org/AndroidTVPlatform"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "externalsubscription",
          "availabilityStarts": "2018-07-21T10:35:29Z",
          "availabilityEnds": "2050-10-21T10:35:29Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://example.com/subscription",
            "name": "ABCD",
            "sameAs": "http://example.com/subscription",
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            }
          ]
        }
      },
      "popularityScore": {
        "@type": "PopularityScoreSpecification",
        "value": 178,
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          }
        ]
      }
    }
    

    Zajrzyj na te tematy, aby znaleźć materiały związane z tymi właściwościami: