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-jenis ini, tinjau konsep Saluran TV Live.

Tabel Spesifikasi BroadcastService

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu tetapkan ke ["http://schema.org", {"@language": "xx"}]
  • Dengan "xx" merepresentasikan bahasa string dalam feed. Setiap konteks entity root harus disetel ke @language ke kode bahasa yang sesuai dalam format format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/sulih suara adalah dalam bahasa Inggris.
@type Teks Wajib - Selalu tetapkan 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). Token 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 entitas memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entitas sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
url URL Wajib jika berlaku - URL kanonis layanan siaran jika saluran tersedia untuk ditonton di Internet. Layanan ini bersifat opsional untuk layanan yang dikirim melalui kabel/satelit/melalui udara. 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 yang 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 berbagai bahasa. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokal (pasangan bahasa-negara).
broadcastDisplayName Teks Wajib - Nama tampilan untuk jaringan yang biasanya dilihat pengguna di panduan program, dll. Nilai mungkin sama dengan nilai nama.
callSign Teks Tanda tangani resmi yang dikeluarkan pemerintah untuk layanan siaran.
inLanguage Teks atau Bahasa 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 atau garis miring yang lebih besar dapat digunakan untuk menunjukkan hierarki kategori secara informal. Misalnya, Olahraga, Olahraga > Sepak Bola, Berita, Film, Musik, Dokumenter.`
contentRating Teks atau Rating Wajib untuk layanan siaran TV khusus dewasa - Rating yang paling ketat untuk siaran konten di channel. Jika rating konten diberikan dalam bentuk string Teks, peringkat rating harus diawali dengan rating dengan spasi kosong di antaranya; misalnya, rating "TV-Y" dari agensi "TVPG" di AS dideskripsikan sebagai "TVPG TV-Y". Lihat daftar agensi.
contentRating.author Teks atau 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 termasuk D, FV, L, S, dan V. D = Dialog, FV = Kekerasan Fantasi , L = Bahasa, S = Konten Seksual, V = Kekerasan.
description Teks Deskripsi layanan siaran. Batasnya 300 karakter. Gunakan array untuk memberikan deskripsi dalam beberapa bahasa dan/atau dengan panjang yang berbeda.
slogan Teks Slogan layanan siaran.
areaServed Negara, Negara Bagian, Kota, atau GeoShape Wajib jika berlaku - Hal ini diperlukan jika tombol channel 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 mencampur Negara, Negara Bagian, Kota dengan GeoShape.
  • logo ImageObject Wajib jika berintegrasi dengan Google TV. Sangat Direkomendasikan jika tidak Mengapa? Gambar yang mewakili layanan siaran ini.
    • Integrasi Google TV memerlukan satu logo yang dapat digunakan pada latar belakang gelap. Ikon harus memiliki latar belakang transparan dengan logo berwarna atau putih, yang terlihat jelas pada latar belakang gelap.
    • Gambar untuk logo harus mematuhi rasio lebar tinggi 1:1 atau 4:3 atau 16:9 (dalam urutan preferensi) dan harus memiliki resolusi 80x80 piksel atau lebih besar.
    • Gunakan nilai forDarkBackground untuk nama properti khusus contentAttributes sebagai bagian dari properti additionalProperty untuk menunjukkan jenis latar belakang yang harus digunakan logo.
    • 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 ada - Objek markup tindakan yang berisi detail tindakan. Lihat Properti markup tindakan untuk mengetahui detailnya.
    videoFormat Teks Definisi kualitas tertinggi yang didukung pada layanan siaran ini; misalnya,
    • "SD" untuk definisi standar.
    • "HD" untuk definisi tinggi.
    • "2K" untuk resolusi 2K.
    • "4K" untuk resolusi 4K.
    • "8K" untuk resolusi 8K.
    broadcastTimezone Teks Zona waktu layanan siaran ini dalam format IANA; misalnya, Amerika/Los_Angeles. Gunakan array untuk beberapa zona waktu.
    broadcastAffiliateOf Organisasi Wajib - Jaringan TV yang menyediakan pemrograman 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 tetapkan 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 PopularitasSkorSpesifikasi Sangat Direkomendasikan Mengapa? Skor yang digunakan Google, serta sinyal lainnya, untuk menentukan media yang akan diputar bagi pengguna. Skor ini menunjukkan popularitas konten sehubungan dengan konten lain di katalog Anda; oleh karena itu, skala skor harus konsisten di seluruh feed Anda, di antara semua entitas di katalog Anda. Secara default, skor popularitas entitas ditetapkan ke 0.
    popularityScore.@type Teks Selalu disetel 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 lokal 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 CableOrSatelitService

    Properti Jenis yang Diharapkan Deskripsi
    @context Teks Wajib - Selalu tetapkan ke ["http://schema.org", {"@language": "xx"}]
    • Dengan "xx" merepresentasikan bahasa string dalam feed. Setiap konteks entity root harus disetel ke @language ke kode bahasa yang sesuai dalam format format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/sulih suara adalah dalam bahasa Inggris.
    @type Teks Wajib - Selalu tetapkan 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 entitas memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entitas sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
    name Teks Wajib - Nama layanan TV.
    • Gunakan array untuk mencantumkan nama dalam berbagai bahasa. Lihat contoh Beberapa wilayah dan bahasa.
    • Perhatikan bahwa hanya satu nama yang didukung per lokal (pasangan bahasa-negara).
    areaServed Negara, Negara Bagian, Kota, atau GeoShape Wajib - Area tempat pengguna dapat menerima layanan siaran.
    provider Organisasi Wajib - Penyedia induk layanan, jika berlaku. Misalnya, ExampleTV adalah penyedia layanan regional ExampleTV San Francisco dan ExampleTV San Diego.
    provider.@id Teks Wajib - ID operator TV.
    provider.@type Teks Wajib - Selalu tetapkan ke Organization.
    identifier PropertyValue Sangat Direkomendasikan Mengapa? - ID eksternal atau ID lain yang mengidentifikasi entitas ini, seperti TMS ID Gracenote untuk layanan siaran ini. Beberapa ID diizinkan. Lihat bagian Properti ID untuk mengetahui detailnya.

    Contoh CableOrSatelitService

    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 Distributor Pemrograman Video Multisaluran Virtual (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 tetapkan ke ["http://schema.org", {"@language": "xx"}]
    • Dengan "xx" merepresentasikan bahasa string dalam feed. Setiap konteks entity root harus disetel ke @language ke kode bahasa yang sesuai dalam format format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/sulih suara adalah dalam bahasa Inggris.
    @type Teks Wajib - Selalu tetapkan 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 entitas memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entitas sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
    broadcastChannelId Teks Wajib - ID unik yang dapat digunakan BroadcastService ini untuk diidentifikasi sebagai layanan TV kabel, satelit, atau Internet.
    • Di Amerika Serikat, biasanya ini adalah nomor untuk TV kabel atau satelit.
    • Untuk layanan TV Internet (misalnya, vMVPD), berikan nama saluran.
    channelOrder Number Wajib untuk Google TV, opsional jika tidak ada - Gunakan properti ini untuk menunjukkan urutan saluran yang harus ditampilkan dalam panduan pemrograman elektronik untuk integrasi Google TV.

    channelOrder harus unik di seluruh saluran dalam feed dan idealnya harus dimulai dari 1. channelOrder tidak boleh memiliki nilai negatif atau 0.
    broadcastServiceTier Teks Gunakan nilai berikut:
    • Free untuk channel yang tidak memerlukan subscription.
    • Standard untuk channel yang termasuk dengan subscription dasar.
    • Premium untuk channel yang memerlukan pembayaran selain langganan dasar.
    Gunakan array untuk memberikan beberapa nilai.
    inBroadcastLineup KabelAtauSatelitLayanan Wajib - @id dari CableOrSatelliteService yang menyediakan channel ini kepada penonton.
    providesBroadcastService BroadcastService Wajib - @id dari BroadcastService yang pemrogramannya disediakan oleh saluran 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 saluran 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 tetapkan ke ["http://schema.org", {"@language": "xx"}]
    • Dengan "xx" merepresentasikan bahasa string dalam feed. Setiap konteks entity root harus disetel ke @language ke kode bahasa yang sesuai dalam format format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/sulih suara adalah dalam bahasa Inggris.
    @type Teks Wajib - Selalu tetapkan 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 entitas memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entitas 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 berbagai bahasa. Lihat contoh Beberapa wilayah dan bahasa.
    • Perhatikan bahwa hanya satu nama yang didukung per lokal (pasangan bahasa-negara).
    description Teks Deskripsi organisasi. Batasnya 300 karakter. Gunakan array untuk memberikan deskripsi dalam beberapa bahasa dan/atau dengan panjang yang berbeda.
    sameAs URL Sangat Direkomendasikan Mengapa? URL ke halaman Wikipedia yang dapat mengidentifikasi jaringan TV. Ini harus berbeda dari properti URL. Hanya isi dengan halaman Wikipedia yang membahas satu entitas saluran/jaringan. Perhatikan bahwa halaman Wikipedia mungkin menggunakan terminologi "saluran".
    potentialAction WatchAction Wajib jika berlaku - Wajib diisi jika Anda memiliki beberapa channel (BroadcastService) yang merujuk pada Organisasi. Objek markup Action yang memberikan detail tindakan. Lihat Properti markup tindakan untuk mengetahui detailnya.
    url URL URL organisasi. Google menggunakan URL ini untuk merekonsiliasi organisasi ini secara akurat dengan organisasi di database Google.
    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 PopularitasSkorSpesifikasi Sangat Direkomendasikan Mengapa? Skor yang digunakan Google, serta sinyal lainnya, untuk menentukan media yang akan diputar bagi pengguna. Skor ini menunjukkan popularitas konten sehubungan dengan konten lain di katalog Anda; oleh karena itu, skala skor harus konsisten di seluruh feed Anda, di antara semua entitas di katalog Anda. Secara default, skor popularitas entitas ditetapkan ke 0.
    popularityScore.@type Teks Selalu disetel 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 lokal 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: