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

W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści w przypadku typów elementów BroadcastService, CableOrSatelliteService, TelevisionChannel i Organization. Aby lepiej zrozumieć związek między tymi typami, zapoznaj się z koncepcją kanałów z telewizją na żywo.

Tabela specyfikacji BroadcastService

Właściwość Oczekiwany typ Opis
@context Text Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
    .
  • Gdzie „xx” reprezentuje język ciągów w pliku danych. Każdy kontekst elementu wyższego rzędu powinien mieć atrybutu @language ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład ustawisz język hiszpański, nazwy będą w tym języku, nawet jeśli język napisów lub dubbingu to angielski.
@type Text Wymagany – 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 w katalogu.
  • Statyczny; identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość adresu URL programu). Jest on traktowany jako ciąg nieprzejrzysty, więc nie musi być działającym linkiem.
  • w formie ujednoliconego identyfikatora zasobu (URI);
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Ponieważ url podmiotu spełnia wszystkie wymagania dotyczące identyfikatorów, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
url Adres URL Wymagany w odpowiednich przypadkach: kanoniczny adres URL usługi transmisji, jeśli kanał jest dostępny w internecie. W przypadku usług dostarczanych przez kabel, satelitę lub bezprzewodowo jest to opcjonalne. Google używa tego adresu URL do dopasowywania treści z Twojego pliku danych do treści z baz danych Google.
url musi spełniać te wymagania:
  • url musi być globalnie niepowtarzalny
  • url musi zawierać działający kanoniczny adres URL, który Google może zindeksować.
Aby uzyskać dostęp do precyzyjnego linku odtwarzania, użyj właściwości urlTemplate obiektu docelowego.
name Text Wymagany – nazwa sieci.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład dotyczący wielu regionów i języków.
  • Pamiętaj, że w przypadku każdej lokalizacji (pary język-kraj) obsługiwana jest tylko jedna nazwa.
broadcastDisplayName Text Wymagany – wyświetlana nazwa sieci, którą użytkownicy mogą zobaczyć w przewodnikach programowych itp. Wartość może być taka sama jak wartość nazwy.
callSign Text Oficjalna nazwa nadawcy nadawana przez instytucję państwową.
inLanguage Tekst lub Język Zdecydowanie zalecane (dlaczego?) Główny język transmisji na kanale. Użyj jednego z kodów języków ze standardu IETF BCP 47.
category Text Zdecydowanie zalecane (dlaczego?) Kategoria produktu. Aby nieformalnie wskazać hierarchię kategorii, można użyć znaków większych lub ukośników. Przykład: Sporty, Sporty > Piłka nożna, Wiadomości, Film, Muzyka, Dokument.
contentRating Tekst lub Ocena Wymagany w przypadku usługi transmisji telewizyjnej dla dorosłych – najbardziej restrykcyjna ocena treści nadawanych na kanale. Jeśli ocena treści jest podana w postaci ciągu tekstowego, przed oceną należy dodać nazwę agencji oceniającej, rozdzielając je spacją. Na przykład ocena „TV-Y” agencji „TVPG” w Stanach Zjednoczonych jest opisywana jako „TVPG TV-Y”. Zobacz listę agencji.
contentRating.author Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji ratingowej.
contentRating.ratingValue Text Wymagane, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Text Kod ostrzeżenia dotyczącego treści. Akceptowane wartości to D, FV, L, S i V. D = dialog, FV = przemoc w fantastyce, L = język, S = treści o podtekście seksualnym, V = przemoc.
description Text Opis usługi transmisji. Limit 300 znaków. Aby podać opisy w różnych językach lub o różnej długości, użyj tablicy.
slogan Text Slogan usługi nadawania.
areaServed Country, State, City lub GeoShape Wymagany w odpowiednich przypadkach – wymagane, jeśli przełączanie kanałów jest realizowane przez dostawcę usługi telewizji – obszar, w którym użytkownicy mogą otrzymać usługę transmisji. Aby określić kraje, użyj kodu kraju w formacie ISO 3166-1.
  • Użyj tablicy do reprezentowania wielu obszarów.
  • Nie mieszaj Country (kraj), State (stan) i City (miasto) z GeoShape.
  • logo ImageObject Wymagany w przypadku integracji z Google TV. Zdecydowanie polecam Dlaczego? Obraz, który reprezentuje tę usługę transmisji.
    • Integracje z Google TV wymagają jednego logo, które można użyć na ciemnym tle. Powinno mieć przezroczyste tło z kolorowym lub białym logo, które jest wyraźnie widoczne na ciemnym tle.
    • Obraz logo powinien mieć proporcje 1:1, 4:3 lub 16:9 (w podanej kolejności) oraz rozdzielczość co najmniej 80 x 80 pikseli.
    • Aby wskazać typ tła, na którym powinno być używane logo, użyj wartości forDarkBackground dla nazwy właściwości niestandardowej contentAttributes w ramach właściwości additionalProperty.
    • Dopełnienie w dłuży lub szerokości (ale nie w obu wymiarach) jest dopuszczalne, jeśli ma na celu zachowanie proporcji.
    • Inne wymagania i specyfikacje znajdziesz w sekcji Obraz.
    Zobacz przykład poniżej
    potentialAction WatchAction (oglądanie) Wymagany w odpowiednich przypadkach – obiekt oznaczenia działania, który zawiera szczegóły działania. Więcej informacji znajdziesz w właściwościach znaczników akcji.
    videoFormat Text Najwyższa jakość obsługiwana przez tę usługę transmisji; na przykład
    • „SD” oznacza standardową rozdzielczość.
    • „HD” oznacza wysoką rozdzielczość.
    • „2K” oznacza rozdzielczość 2K.
    • „4K” dla rozdzielczości 4K.
    • „8K” dla rozdzielczości 8K.
    broadcastTimezone Text Strefa czasowa tej usługi transmisji w formacie IANA, np. Ameryka/Los_Angeles. Użyj tablicy dla wielu stref czasowych.
    broadcastAffiliateOf Organizacja Wymagany – sieć telewizyjna, która zapewnia programowanie dla tej usługi transmisji lub organizacja, do której należy ta usługa transmisji.
    broadcastAffiliateOf.@id Text Wymagany – ustaw na @id sieci telewizyjnej.
    broadcastAffiliateOf.@type Text Wymagany – zawsze ma wartość Organization.
    identifier PropertyValue Zdecydowanie zalecane (dlaczego?) – zewnętrzny lub inny identyfikator identyfikujący tę jednostkę, np. _PARTNER_ID_. Dozwolone są liczne identyfikatory. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatorów.
    popularityScore PopularityScoreSpecification Zdecydowanie zalecane (dlaczego?) Wynik, który Google używa razem z innymi sygnałami do określania, które multimedia wyświetlać użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w katalogu. Dlatego skala wyniku musi być spójna w przypadku wszystkich plików danych i wszystkich elementów w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
    popularityScore.@type Text Zawsze ustawiona na PopularityScoreSpecification.
    popularityScore.value Number Wartość liczbowa większa od zera, która wskazuje popularność elementu. Im wyższa wartość, tym większa popularność.
    popularityScore.eligibleRegion Kraj Regiony, w których obowiązuje ten wynik popularności. Jeśli wynik popularności jest stosowany globalnie, ustaw go na EARTH. Domyślnie ta właściwość jest ustawiona na EARTH.
    Note: Popularność w danym regionie ma pierwszeństwo przed popularnością globalną (EARTH).

    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 usługi CableOrSatelliteService

    Właściwość Oczekiwany typ Opis
    @context Text Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
      .
    • Gdzie „xx” reprezentuje język ciągów w pliku danych. Każdy kontekst elementu wyższego rzędu powinien mieć atrybutu @language ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład ustawisz język hiszpański, nazwy będą w tym języku, nawet jeśli język napisów lub dubbingu to angielski.
    @type Text Wymagany – 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 w katalogu.
    • Statyczny
    • w formie ujednoliconego identyfikatora zasobu (URI);
    Ponieważ url podmiotu spełnia wszystkie wymagania dotyczące identyfikatorów, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
    name Text Wymagany – nazwa usługi telewizyjnej.
    • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład dotyczący wielu regionów i języków.
    • Pamiętaj, że w przypadku każdej lokalizacji (pary język-kraj) obsługiwana jest tylko jedna nazwa.
    areaServed Country, State, City lub GeoShape Wymagany – obszar, na którym użytkownicy mogą otrzymać usługę transmisji.
    provider Organizacja Wymagany – dostawca nadrzędny usługi (jeśli dotyczy). Na przykład usługodawca ExampleTV oferuje usługi regionalne ExampleTV San Francisco i ExampleTV San Diego.
    provider.@id Text Wymagany – identyfikator operatora telewizji.
    provider.@type Text Wymagany – zawsze ma wartość Organization.
    identifier PropertyValue Zdecydowanie zalecane (dlaczego?) – zewnętrzny lub inny identyfikator identyfikujący tę usługę, np. identyfikator TMS Gracenote dla tej usługi transmisji. Dozwolone są liczne identyfikatory. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatorów.

    Przykłady usługi CableOrSatelliteService

    Przykład usługi 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 wielokanałowego dystrybutora programów 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

    Właściwość Oczekiwany typ Opis
    @context Text Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
      .
    • Gdzie „xx” reprezentuje język ciągów w pliku danych. Każdy kontekst elementu wyższego rzędu powinien mieć atrybutu @language ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład ustawisz język hiszpański, nazwy będą w tym języku, nawet jeśli język napisów lub dubbingu to angielski.
    @type Text Wymagany – 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 w katalogu.
    • Statyczny
    • w formie ujednoliconego identyfikatora zasobu (URI);
    Ponieważ url podmiotu spełnia wszystkie wymagania dotyczące identyfikatorów, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
    broadcastChannelId Text Wymagany – unikalny identyfikator, dzięki któremu można zidentyfikować tę usługę BroadcastService jako usługę telewizyjną przez kabel, satelitę lub internet.
    • W Stanach Zjednoczonych jest to zwykle numer telewizji kablowej lub satelitarnej.
    • W przypadku usługi telewizji internetowej (np. vMVPD) podaj nazwę kanału.
    channelOrder Number Wymagane w przypadku Google TV, opcjonalne w innych przypadkach – użyj tej właściwości, aby wskazać kolejność wyświetlania kanałów w przewodniku po programach w przypadku integracji z Google TV.

    Wartość channelOrder powinna być unikalna dla wszystkich kanałów w pliku danych i najlepiej zaczynać się od 1. Wartość channelOrder nie może być ujemna ani równa 0.
    broadcastServiceTier Text Użyj tych wartości:
    • Free dla kanału, który nie wymaga subskrypcji.
    • Standard w przypadku kanałów dostępnych w ramach subskrypcji podstawowej.
    • Premium w przypadku kanałów, które wymagają płatności dodatkowej do subskrypcji podstawowej.
    Aby podać wiele wartości, użyj tablicy.
    inBroadcastLineup CableOrSatelliteService Wymagany: @id usługi CableOrSatelliteService, która udostępnia ten kanał widzom.
    providesBroadcastService BroadcastService Wymagany@id BroadcastService, którego programowanie jest dostępne na tym kanale.

    Przykłady kanału telewizyjnego

    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

    Właściwość Oczekiwany typ Opis
    @context Text Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
      .
    • Gdzie „xx” reprezentuje język ciągów w pliku danych. Każdy kontekst elementu wyższego rzędu powinien mieć atrybutu @language ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład ustawisz język hiszpański, nazwy będą w tym języku, nawet jeśli język napisów lub dubbingu to angielski.
    @type Text Wymagany – 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 w katalogu.
    • Statyczny
    • w formie ujednoliconego identyfikatora zasobu (URI);
    Ponieważ url podmiotu spełnia wszystkie wymagania dotyczące identyfikatorów, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
    name Text Wymagany – nazwa sieci telewizyjnej, dostawcy treści telewizyjnych lub operatora telewizyjnego.
    • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład dotyczący wielu regionów i języków.
    • Pamiętaj, że w przypadku każdej lokalizacji (pary język-kraj) obsługiwana jest tylko jedna nazwa.
    description Text Opis organizacji. Limit 300 znaków. Aby podać opisy w różnych językach lub o różnej długości, użyj tablicy.
    sameAs Adres URL Zdecydowanie zalecane (dlaczego?) Adres URL strony w Wikipedii, która może identyfikować sieć telewizyjną. Musi się ona różnić od właściwości url. Wypełnij tylko stronę Wikipedii, która dotyczy pojedynczego kanału lub nadawcy. Pamiętaj, że strony w Wikipedii mogą używać terminu „kanał”.
    potentialAction WatchAction (oglądanie) Wymagane w odpowiednich przypadkach – jest to wymagane, jeśli masz wiele kanałów (BroadcastService) odwołujących się do organizacji. Obiekt ActionMarkup zawierający szczegóły działania. Więcej informacji znajdziesz w właściwościach znaczników akcji.
    url Adres URL Adres URL organizacji. Google używa tego adresu URL, aby dokładnie porównać tę organizację z organizacją w bazach danych Google.
    identifier PropertyValue Zdecydowanie zalecane (dlaczego?) – zewnętrzny lub inny identyfikator, który identyfikuje tę organizację, np. identyfikator TMS tej organizacji. Dozwolone są liczne identyfikatory. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatorów.
    popularityScore PopularityScoreSpecification Zdecydowanie zalecane (dlaczego?) Wynik, który Google używa razem z innymi sygnałami do określania, które multimedia wyświetlać użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w katalogu. Dlatego skala wyniku musi być spójna w przypadku wszystkich plików danych i wszystkich elementów w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
    popularityScore.@type Text Zawsze ustawiona na PopularityScoreSpecification.
    popularityScore.value Number Wartość liczbowa większa od zera, która wskazuje popularność elementu. Im wyższa wartość, tym większa popularność.
    popularityScore.eligibleRegion Kraj Regiony, w których obowiązuje ten wynik popularności. Jeśli wynik popularności jest stosowany globalnie, ustaw go na EARTH. Domyślnie ta właściwość jest ustawiona na EARTH.
    Note: Popularność w danym regionie ma pierwszeństwo przed popularnością globalną (EARTH).

    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"
          }
        ]
      }
    }
    

    Aby dowiedzieć się więcej o tych usługach, zapoznaj się z tymi stronami: