Properti markup konten saluran TV live

Bagian ini memberikan detail properti markup konten untuk jenis entity BroadcastService, CableOrSatelliteService, TelevisionChannel, Organization. Untuk lebih memahami hubungan antara jenis ini, tinjau konsep Channel LiveTV.

Tabel Spesifikasi BroadcastService

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}]
  • Dengan "xx" mewakili bahasa string dalam feed. Setiap konteks entity root harus memiliki @language yang ditetapkan ke kode bahasa yang sesuai dalam format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/dub dalam bahasa Inggris.
@type Teks Wajib - Selalu ditetapkan ke BroadcastService.
@id URL Wajib - ID konten dalam format URI; misalnya, https://example.com/1234abc.
@id harus memenuhi persyaratan berikut:
  • Unik secara global di seluruh katalog Anda
  • Statis; ID harus stabil dan tidak berubah dari waktu ke waktu (meskipun properti URL acara berubah). URL ini akan diperlakukan sebagai string buram dan tidak harus berupa link yang berfungsi.
  • Dalam bentuk Unified Resource Identifier (URI)
  • Domain yang digunakan untuk nilai @id harus dimiliki oleh organisasi Anda.
Karena url entity memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
url URL Wajib jika ada - URL kanonis layanan siaran jika channel tersedia untuk ditonton di Internet. Opsional untuk layanan yang dikirimkan melalui kabel/satelit/saluran TV. Google menggunakan URL ini untuk mencocokkan konten di feed Anda dengan konten di database Google.
url harus memenuhi persyaratan berikut:
  • url harus unik secara global
  • url harus berisi URL kanonis yang berfungsi dan dapat di-crawl oleh Google.
Untuk deep link pemutaran, lihat properti urlTemplate objek target.
name Teks Wajib - Nama jaringan.
  • Gunakan array untuk mencantumkan nama dalam bahasa yang berbeda. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
broadcastDisplayName Teks Wajib - Nama tampilan untuk jaringan yang biasanya dilihat pengguna di panduan program, dll. Nilainya mungkin sama dengan nilai nama.
callSign Teks Callsign resmi layanan siaran yang dikeluarkan pemerintah.
inLanguage Text atau Language Sangat Direkomendasikan Mengapa? Bahasa siaran utama channel. Gunakan salah satu kode bahasa dari standar IETF BCP 47.
category Teks Sangat Direkomendasikan Mengapa? Kategori untuk item. Tanda lebih besar atau garis miring dapat digunakan untuk menunjukkan hierarki kategori secara informal. Misalnya, Olahraga, Olahraga > Sepak Bola, Berita, Film, Musik, Dokumenter.`
contentRating Text atau Rating Wajib untuk layanan siaran TV khusus dewasa - Rating paling ketat untuk konten yang disiarkan di channel. Jika rating konten diberikan dalam bentuk string Teks, lembaga rating harus ditambahkan di awal rating dengan spasi kosong di antaranya; misalnya, rating "TV-Y" dari lembaga "TVPG" di Amerika Serikat dijelaskan sebagai "TVPG TV-Y". Lihat daftar agensi.
contentRating.author Organisasi Wajib jika contentRating menggunakan Rating - Nama lembaga rating.
contentRating.ratingValue Teks Wajib jika contentRating menggunakan Rating - Nilai rating.
contentRating.advisoryCode Teks Kode saran untuk konten. Nilai yang diterima mencakup D, FV, L, S, dan V. D = Dialog, FV = Kekerasan Fantasi , L = Bahasa, S = Konten Seksual, V = Kekerasan.
description Teks Deskripsi layanan siaran. Batas 300 karakter. Gunakan array untuk memberikan deskripsi dalam beberapa bahasa dan/atau dalam panjang yang berbeda.
slogan Teks Slogan layanan siaran.
areaServed Country, State, City, atau GeoShape Wajib jika berlaku - Wajib diisi jika pengalihan saluran dipenuhi oleh penyedia layanan TV - Area tempat pengguna dapat menerima layanan siaran. Gunakan kode negara ISO 3166-1 untuk menentukan negara.
  • Gunakan array untuk mewakili beberapa area.
  • Jangan menggabungkan Country, State, City dengan GeoShape.
  • logo ImageObject Wajib jika berintegrasi dengan Google TV. Sangat Direkomendasikan jika tidak Mengapa? Gambar yang mewakili layanan siaran ini.
    • Integrasi GoogleTV memerlukan satu logo yang dapat digunakan pada latar belakang gelap. Gambar harus memiliki latar belakang transparan dengan logo berwarna atau putih, yang terlihat jelas di latar belakang gelap.
    • Gambar untuk logo harus mematuhi rasio aspek 1:1 atau 4:3 atau 16:9 (dalam urutan preferensi tersebut) dan harus memiliki resolusi 80x80 piksel atau lebih besar.
    • Gunakan nilai forDarkBackground untuk nama properti kustom contentAttributes sebagai bagian dari properti additionalProperty untuk menunjukkan jenis latar belakang tempat logo harus digunakan.
    • Padding dalam panjang atau lebar (tetapi tidak keduanya) dapat diterima jika ditambahkan untuk mempertahankan rasio aspek.
    • Lihat bagian Gambar untuk mengetahui persyaratan dan spesifikasi lainnya.
    Lihat contoh di bawah
    potentialAction WatchAction Wajib jika berlaku - Objek markup tindakan yang memberikan detail tindakan. Lihat Properti markup tindakan untuk mengetahui detailnya.
    videoFormat Teks Definisi kualitas tertinggi yang didukung di layanan siaran ini; misalnya,
    • "SD" untuk definisi standar.
    • "HD" untuk high-definition.
    • "2K" untuk resolusi 2K.
    • "4K" untuk resolusi 4K.
    • "8K" untuk resolusi 8K.
    broadcastTimezone Teks Zona waktu layanan siaran ini dalam format IANA; misalnya, America/Los_Angeles. Gunakan array untuk beberapa zona waktu.
    broadcastAffiliateOf Organisasi Wajib - Jaringan TV yang menyediakan program untuk layanan siaran ini atau organisasi tempat layanan siaran ini berada.
    broadcastAffiliateOf.@id Teks Wajib - Tetapkan ke @id jaringan TV.
    broadcastAffiliateOf.@type Teks Wajib - Selalu ditetapkan ke Organization.
    identifier PropertyValue Sangat Direkomendasikan Mengapa? - ID eksternal atau ID lain yang mengidentifikasi entitas ini, seperti _PARTNER_ID_. Beberapa ID diizinkan. Lihat bagian Properti ID untuk mengetahui detailnya.
    popularityScore PopularityScoreSpecification Sangat Direkomendasikan Mengapa? Skor yang digunakan Google, beserta sinyal lainnya, untuk menentukan media yang akan diputar untuk pengguna. Skor ini menunjukkan popularitas konten sehubungan dengan konten lain di katalog Anda; oleh karena itu, skala skor harus konsisten di seluruh feed, di antara semua entitas di katalog Anda. Secara default, skor popularitas entitas ditetapkan ke 0.
    popularityScore.@type Teks Selalu ditetapkan ke PopularityScoreSpecification.
    popularityScore.value Number Nilai numerik non-negatif yang menunjukkan popularitas entitas; skor yang lebih tinggi berarti popularitas yang lebih tinggi.
    popularityScore.eligibleRegion Negara Wilayah tempat skor popularitas ini berlaku. Jika skor popularitas berlaku secara global, tetapkan ke EARTH. Secara default, properti ini ditetapkan ke EARTH.
    Note: Popularitas khusus lokalitas lebih diutamakan daripada popularitas global (EARTH)

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

    Tabel spesifikasi CableOrSatelliteService

    Properti Jenis yang Diharapkan Deskripsi
    @context Teks Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}]
    • Dengan "xx" mewakili bahasa string dalam feed. Setiap konteks entity root harus memiliki @language yang ditetapkan ke kode bahasa yang sesuai dalam format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/dub dalam bahasa Inggris.
    @type Teks Wajib - Selalu ditetapkan ke CableOrSatelliteService.
    @id URL Wajib - ID konten dalam format URI; misalnya, https://example.com/1234abc.
    @id harus memenuhi persyaratan berikut:
    • Unik secara global di seluruh katalog Anda
    • Statis
    • Dalam bentuk Unified Resource Identifier (URI)
    Karena url entity memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
    name Teks Wajib - Nama layanan TV.
    • Gunakan array untuk mencantumkan nama dalam bahasa yang berbeda. Lihat contoh Beberapa wilayah dan bahasa.
    • Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
    areaServed Country, State, City, atau GeoShape Wajib - Area tempat pengguna dapat menerima layanan siaran.
    provider Organisasi Wajib - Penyedia induk layanan, jika berlaku. Misalnya, ExampleTV adalah penyedia layanan regionalnya, yaitu ExampleTV San Francisco dan ExampleTV San Diego.
    provider.@id Teks Wajib - ID operator TV.
    provider.@type Teks Wajib - Selalu ditetapkan ke Organization.
    identifier PropertyValue Sangat Direkomendasikan Mengapa? - ID eksternal atau ID lain yang mengidentifikasi entitas ini, seperti ID TMS Gracenote untuk layanan siaran ini. Beberapa ID diizinkan. Lihat bagian Properti ID untuk mengetahui detailnya.

    Contoh CableOrSatelliteService

    Contoh layanan TV kabel atau satelit:

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

    Contoh Virtual Multichannel Video Programming Distributor (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",
        }
      ]
    }
    

    Tabel spesifikasi TelevisionChannel

    Properti Jenis yang Diharapkan Deskripsi
    @context Teks Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}]
    • Dengan "xx" mewakili bahasa string dalam feed. Setiap konteks entity root harus memiliki @language yang ditetapkan ke kode bahasa yang sesuai dalam format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/dub dalam bahasa Inggris.
    @type Teks Wajib - Selalu ditetapkan ke TelevisionChannel.
    @id URL Wajib - ID konten dalam format URI; misalnya, https://example.com/1234abc.
    @id harus memenuhi persyaratan berikut:
    • Unik secara global di seluruh katalog Anda
    • Statis
    • Dalam bentuk Unified Resource Identifier (URI)
    Karena url entity memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
    broadcastChannelId Teks Wajib - ID unik yang digunakan untuk mengidentifikasi BroadcastService ini sebagai layanan TV kabel, satelit, atau Internet.
    • Di Amerika Serikat, ini biasanya merupakan nomor untuk TV kabel atau satelit.
    • Untuk layanan TV Internet (misalnya, vMVPD), berikan nama saluran.
    channelOrder Number Wajib untuk GoogleTV, opsional jika tidak - Gunakan properti ini untuk menunjukkan urutan saluran yang harus ditampilkan dalam panduan program elektronik untuk integrasi Google TV.

    channelOrder harus unik di seluruh saluran dalam feed dan idealnya dimulai dari 1. channelOrder tidak boleh memiliki nilai negatif atau 0.
    broadcastServiceTier Teks Gunakan nilai berikut:
    • Free untuk channel yang tidak memerlukan langganan.
    • Standard untuk channel yang disertakan dengan langganan dasar.
    • Premium untuk channel yang memerlukan pembayaran selain langganan dasar.
    Gunakan array untuk memberikan beberapa nilai.
    inBroadcastLineup CableOrSatelliteService Wajib - @id dari CableOrSatelliteService yang menyediakan channel ini kepada penonton.
    providesBroadcastService BroadcastService Wajib - @id dari BroadcastService yang programnya disediakan oleh channel ini.

    Contoh TelevisionChannel

    Contoh saluran TV kabel atau satelit:

    {
      "@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"
      }
    }
    

    Contoh untuk channel TV 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"
      }
    }
    

    Tabel spesifikasi organisasi

    Properti Jenis yang Diharapkan Deskripsi
    @context Teks Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}]
    • Dengan "xx" mewakili bahasa string dalam feed. Setiap konteks entity root harus memiliki @language yang ditetapkan ke kode bahasa yang sesuai dalam format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/dub dalam bahasa Inggris.
    @type Teks Wajib - Selalu ditetapkan ke Organization.
    @id URL Wajib - ID konten dalam format URI; misalnya, https://example.com/1234abc.
    @id harus memenuhi persyaratan berikut:
    • Unik secara global di seluruh katalog Anda
    • Statis
    • Dalam bentuk Unified Resource Identifier (URI)
    Karena url entity memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
    name Teks Wajib - Nama jaringan TV, penyedia konten TV, atau operator TV.
    • Gunakan array untuk mencantumkan nama dalam bahasa yang berbeda. Lihat contoh Beberapa wilayah dan bahasa.
    • Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
    description Teks Deskripsi organisasi. Batas 300 karakter. Gunakan array untuk memberikan deskripsi dalam beberapa bahasa dan/atau dalam panjang yang berbeda.
    sameAs URL Sangat Direkomendasikan Mengapa? URL ke halaman Wikipedia yang dapat mengidentifikasi jaringan TV. URL ini harus berbeda dengan properti URL. Hanya isi dengan halaman Wikipedia yang membahas satu entitas channel/jaringan. Perhatikan bahwa halaman Wikipedia mungkin menggunakan terminologi "saluran".
    potentialAction WatchAction Wajib jika berlaku - Ini diperlukan jika Anda memiliki beberapa saluran (BroadcastService) yang merujuk ke Organisasi. Objek markup tindakan yang memberikan detail tindakan. Lihat Properti markup tindakan untuk mengetahui detailnya.
    url URL URL organisasi. Google menggunakan URL ini untuk merekonsiliasi organisasi ini dengan organisasi di database Google secara akurat.
    identifier PropertyValue Sangat Direkomendasikan Mengapa? - ID eksternal atau ID lain yang mengidentifikasi entitas ini, seperti ID TMS untuk organisasi ini. Beberapa ID diizinkan. Lihat bagian Properti ID untuk mengetahui detailnya.
    popularityScore PopularityScoreSpecification Sangat Direkomendasikan Mengapa? Skor yang digunakan Google, beserta sinyal lainnya, untuk menentukan media yang akan diputar untuk pengguna. Skor ini menunjukkan popularitas konten sehubungan dengan konten lain di katalog Anda; oleh karena itu, skala skor harus konsisten di seluruh feed, di antara semua entitas di katalog Anda. Secara default, skor popularitas entitas ditetapkan ke 0.
    popularityScore.@type Teks Selalu ditetapkan ke PopularityScoreSpecification.
    popularityScore.value Number Nilai numerik non-negatif yang menunjukkan popularitas entitas; skor yang lebih tinggi berarti popularitas yang lebih tinggi.
    popularityScore.eligibleRegion Negara Wilayah tempat skor popularitas ini berlaku. Jika skor popularitas berlaku secara global, tetapkan ke EARTH. Secara default, properti ini ditetapkan ke EARTH.
    Note: Popularitas khusus lokalitas lebih diutamakan daripada popularitas global (EARTH)

    Contoh organisasi

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

    Lihat halaman berikut untuk topik yang terkait dengan properti ini: