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 typach elementów BroadcastService, CableOrSatelliteService, TelevisionChannel i Organization. Aby lepiej zrozumieć zależności między tymi typami treści, zapoznaj się z pojęciami dotyczącymi kanałów telewizji na żywo.

Tabela specyfikacji BroadcastService

Właściwość Oczekiwany typ Opis
@context Tekst Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
    .
  • Gdzie „xx” odpowiada językowi ciągów znaków w pliku danych. W przypadku każdego kontekstu elementu głównego parametr @language powinien być ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, przyjmuje się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów lub dubbingu jest w języku angielskim.
@type Tekst 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:
  • Produkt unikalny w całym katalogu
  • statyczny; Identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmienia się właściwość URL programu). Zostanie on potraktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W formacie URI (Unified Resource Identifier)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Atrybut url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
url Adres URL Wymagany (w stosownych przypadkach)kanoniczny URL transmisji, jeśli kanał jest dostępny w internecie. W przypadku usług dostarczanych przez telewizję kablową, satelitarną lub bezprzewodową jest to opcjonalne. Google używa tego adresu URL do dopasowywania treści w pliku danych do zawartości baz danych Google.
url musi spełniać te wymagania:
  • Pole url musi być unikalne globalnie
  • Plik url musi zawierać działający kanoniczny URL, który Google może zindeksować.
W przypadku precyzyjnego linku odtwarzania zapoznaj się z właściwością urlTemplate obiektu docelowego.
name Tekst Wymagane – nazwa sieci.
  • Użyj tablicy, aby wyświetlić nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że dla każdego języka (para język-kraj) obsługiwana jest tylko jedna nazwa.
broadcastDisplayName Tekst Wymagane – wyświetlana nazwa sieci, którą użytkownicy zwykle mogą zobaczyć w przewodnikach po programach. Wartość może być taka sama jak nazwa.
callSign Tekst Oficjalny znak wywoławczy sieci telewizyjnej wydany przez organ państwowy.
inLanguage Text lub Language Dlaczego warto wybrać Główny język transmisji na kanale. Użyj jednego z kodów języka standardu IETF BCP 47.
category Tekst Dlaczego warto wybrać Kategoria elementu. Większe znaki lub ukośniki mogą służyć do nieformalnego określenia hierarchii kategorii. np.Sport, Sport > Piłka nożna, wiadomości, film, muzyka, filmy dokumentalne.
contentRating Tekst lub Ocena Wymagany w przypadku transmisji telewizyjnych tylko dla dorosłych – najbardziej restrykcyjna ocena treści na danym kanale. Jeśli ocena treści jest podana w postaci ciągu tekstowego, do oceny należy dodać agencję oceniającą ze spacjami. na przykład „TV-Y” ocena agencji „TVPG” w Stanach Zjednoczonych jest oznaczona 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 Tekst Wymagany, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Tekst Kod porady dotyczący treści. Akceptowane wartości to D, FV, L, S i V. D = dialog, FV = przemoc w świecie fantasy, L = język, S = treści o charakterze seksualnym, V = przemoc.
description Tekst 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 Tekst Slogan agencji telewizyjnej.
areaServed Kraj, Stan, Miasto lub GeoShape Wymagany, jeśli dotyczy – jest to wymagane, jeśli zmiana kanału została wypełniona przez dostawcę usług telewizyjnych – obszar, w którym użytkownicy mogą spodziewać się odbioru transmisji. Aby określić kraje, użyj kodu kraju w formacie ISO 3166-1.
  • Użyj tablicy do reprezentowania wielu obszarów.
  • Nie łącz atrybutów Kraj, Stan, Miasto z GeoShape.
  • logo ImageObject Wymagany w przypadku integracji z Google TV. W przeciwnym razie Zdecydowanie Polecane Dlaczego? Obraz reprezentujący tę usługę transmisji.
    • Integracje z Google TV wymagają 1 logo do wykorzystania na ciemnym tle. Tło powinno być przezroczyste z kolorowym lub białym logo, które jest wyraźnie widoczne na ciemnym tle.
    • Obraz logo powinien mieć współczynnik proporcji 1:1, 4:3 lub 16:9 (w tej kolejności) i rozdzielczość co najmniej 80 x 80 pikseli.
    • Użyj wartości forDarkBackground dla nazwy właściwości niestandardowej contentAttributes jako części właściwości additionalProperty, aby wskazać typ tła, na którym ma być używane logo.
    • Dopełnienie w celu zachowania współczynnika proporcji – długości lub szerokości (ale nie obu) jest dopuszczalne.
    • Inne wymagania i specyfikacje znajdziesz w sekcji Obraz.
    Zobacz przykład poniżej
    potentialAction WatchAction (oglądanie) Wymagany, jeśli dotyczyobiekt znaczników działania, który zawiera szczegółowe informacje o działaniu. Szczegółowe informacje znajdziesz w sekcji Właściwości znaczników działań.
    videoFormat Tekst rozdzielczość o najwyższej jakości obsługiwanej przez tę usługę transmisji; na przykład
    • „SD” w przypadku rozdzielczości standardowej.
    • „HD” w wysokiej rozdzielczości.
    • „2K” który jest dostępny w rozdzielczości 2K.
    • „4K” który jest dostępny w rozdzielczości 4K.
    • „8K” który pozwala oglądać filmy w rozdzielczości 8K.
    broadcastTimezone Tekst strefa czasowa tej transmisji w formacie IANA; na przykład Ameryka/Los_Angeles. Używaj tablicy dla wielu stref czasowych.
    broadcastAffiliateOf Organizacja Wymagane – sieć telewizyjna, która udostępnia program na potrzeby tej usługi lub organizacji, do której należy ta usługa naziemna.
    broadcastAffiliateOf.@id Tekst Wymagane – ustaw na @id sieci telewizyjnej.
    broadcastAffiliateOf.@type Tekst Wymagane – zawsze ma wartość Organization.
    identifier PropertyValue Dlaczego warto wybrać – Zewnętrzny lub inny identyfikator, który identyfikuje ten podmiot, np. _PARTNER_ID_. Dozwolonych jest wiele identyfikatorów. Więcej informacji znajdziesz w sekcji Właściwości identyfikatora.
    popularityScore PopularityScoreSpecification Dlaczego warto wybrać Wynik wykorzystywany przez Google, wraz z innymi sygnałami, do określania, które multimedia wyświetlić użytkownikom. Ocena ta określa popularność treści w porównaniu z innymi treściami w Twoim katalogu. dlatego skala wyniku musi być spójna we wszystkich plikach danych i we wszystkich elementach w katalogu. Domyślnie wynik popularności jednostki ma wartość 0.
    popularityScore.@type Tekst Zawsze ustawiona na PopularityScoreSpecification.
    popularityScore.value Number Nieujemna wartość liczbowa wskazująca popularność elementu. wyższy wynik oznacza większą popularność.
    popularityScore.eligibleRegion Kraj Regiony, w których obowiązuje ten wskaźnik popularności. Jeśli wynik popularności ma zastosowanie na całym świecie, ustaw wartość EARTH. Domyślnie ustawiona jest wartość EARTH.
    Note: Popularność w konkretnym regionie ma pierwszeństwo przed popularnością globalną (ZIEMI)

    Przykład usługi 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 CableOrAlternativeService

    Właściwość Oczekiwany typ Opis
    @context Tekst Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
      .
    • Gdzie „xx” odpowiada językowi ciągów znaków w pliku danych. W przypadku każdego kontekstu elementu głównego parametr @language powinien być ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, przyjmuje się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów lub dubbingu jest w języku angielskim.
    @type Tekst 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:
    • Produkt unikalny w całym katalogu
    • Statyczny
    • W formacie URI (Unified Resource Identifier)
    Atrybut url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
    name Tekst Wymagane – nazwa usługi telewizyjnej.
    • Użyj tablicy, aby wyświetlić nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
    • Pamiętaj, że dla każdego języka (para język-kraj) obsługiwana jest tylko jedna nazwa.
    areaServed Kraj, Stan, Miasto lub GeoShape Wymagany – obszar, w którym użytkownicy mogą się spodziewać transmisji.
    provider Organizacja Wymagane – nadrzędny dostawca usługi (w stosownych przypadkach). Na przykład ExampleTV jest dostawcą usług regionalnych, takich jak ExampleTV San Francisco i ExampleTV San Diego.
    provider.@id Tekst Wymagany – identyfikator operatora telewizyjnego.
    provider.@type Tekst Wymagane – zawsze ma wartość Organization.
    identifier PropertyValue Dlaczego warto wybrać – Zewnętrzny lub inny identyfikator, który identyfikuje ten podmiot, na przykład identyfikator Gracenote TMS dla tej usługi transmisji. Dozwolonych jest wiele identyfikatorów. Więcej informacji znajdziesz w sekcji Właściwości identyfikatora.

    Przykłady usług CableOrAlternativeService

    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 dystrybutora wirtualnego wielokanałowego programowania 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 Tekst Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
      .
    • Gdzie „xx” odpowiada językowi ciągów znaków w pliku danych. W przypadku każdego kontekstu elementu głównego parametr @language powinien być ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, przyjmuje się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów lub dubbingu jest w języku angielskim.
    @type Tekst 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:
    • Produkt unikalny w całym katalogu
    • Statyczny
    • W formacie URI (Unified Resource Identifier)
    Atrybut url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
    broadcastChannelId Tekst Wymagany – unikalny identyfikator, dzięki któremu BroadcastService może zostać zidentyfikowany jako usługa telewizji kablowej, satelitarnej lub internetowej.
    • W Stanach Zjednoczonych jest to zazwyczaj numer telewizji kablowej lub satelitarnej.
    • W przypadku usługi telewizji internetowej (na przykład vMVPD) podaj nazwę kanału.
    channelOrder Number Wymagane w przypadku Google TV, w przeciwnym razie opcjonalne – użyj tej właściwości, by wskazać kolejność wyświetlania kanałów w elektronicznym przewodniku po programach po integracji z Google TV.

    channelOrder powinien być niepowtarzalny wśród wszystkich kanałów w kanale i powinno zaczynać się od 1. Pole channelOrder nie może mieć wartości ujemnej ani 0.
    broadcastServiceTier Tekst Użyj następujących wartości:
    • Free dla kanału, który nie wymaga subskrypcji.
    • Standard w przypadku kanałów objętych subskrypcją podstawową.
    • Premium za kanały, które wymagają dodatkowo płatności za subskrypcję podstawową.
    Użyj tablicy, aby podać wiele wartości.
    inBroadcastLineup CableOrSatelliteService Wymagany@id (CableOrSatelliteService) udostępniającego ten kanał widzom.
    providesBroadcastService BroadcastService Wymagane@id BroadcastService, którego program jest dostępny 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 kanału telewizji 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 Tekst Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
      .
    • Gdzie „xx” odpowiada językowi ciągów znaków w pliku danych. W przypadku każdego kontekstu elementu głównego parametr @language powinien być ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, przyjmuje się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów lub dubbingu jest w języku angielskim.
    @type Tekst 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:
    • Produkt unikalny w całym katalogu
    • Statyczny
    • W formacie URI (Unified Resource Identifier)
    Atrybut url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
    name Tekst Wymagane – nazwa sieci telewizyjnej, dostawcy treści lub operatora telewizyjnego.
    • Użyj tablicy, aby wyświetlić nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
    • Pamiętaj, że dla każdego języka (para język-kraj) obsługiwana jest tylko jedna nazwa.
    description Tekst 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 Dlaczego warto wybrać Adres URL strony w Wikipedii, która może zidentyfikować sieć telewizyjną. Musi się ona różnić od właściwości url. Wypełnij tylko tą stroną w Wikipedii, która dotyczy jednego kanału lub podmiotu sieciowego. Pamiętaj, że na stronach Wikipedii mogą być używane terminy „kanał”.
    potentialAction WatchAction (oglądanie) Wymagany, jeśli dotyczy – jest wymagane, jeśli do organizacji masz wiele kanałów (BroadcastService) do niej. Obiekt znaczników działania, który zawiera szczegóły działania. Szczegółowe informacje znajdziesz w sekcji Właściwości znaczników działań.
    url Adres URL Adres URL organizacji. Google używa tego adresu URL, aby dokładnie uzgodnić tę organizację z organizacją w bazach danych Google.
    identifier PropertyValue Dlaczego warto wybrać – Zewnętrzny lub inny identyfikator identyfikujący ten podmiot, np. identyfikator TMS tej organizacji. Dozwolonych jest wiele identyfikatorów. Więcej informacji znajdziesz w sekcji Właściwości identyfikatora.
    popularityScore PopularityScoreSpecification Dlaczego warto wybrać Wynik wykorzystywany przez Google, wraz z innymi sygnałami, do określania, które multimedia wyświetlić użytkownikom. Ocena ta określa popularność treści w porównaniu z innymi treściami w Twoim katalogu. dlatego skala wyniku musi być spójna we wszystkich plikach danych i we wszystkich elementach w katalogu. Domyślnie wynik popularności jednostki ma wartość 0.
    popularityScore.@type Tekst Zawsze ustawiona na PopularityScoreSpecification.
    popularityScore.value Number Nieujemna wartość liczbowa wskazująca popularność elementu. wyższy wynik oznacza większą popularność.
    popularityScore.eligibleRegion Kraj Regiony, w których obowiązuje ten wskaźnik popularności. Jeśli wynik popularności ma zastosowanie na całym świecie, ustaw wartość EARTH. Domyślnie ustawiona jest wartość EARTH.
    Note: Popularność w konkretnym regionie ma pierwszeństwo przed popularnością globalną (ZIEMI)

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

    Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami: