Properti markup konten MediaService (Wajib)

Bagian ini memberikan detail properti markup konten untuk jenis entity MediaService yang menangkap konfigurasi untuk integrasi Media Action Anda

Tabel spesifikasi

Properti Jenis yang Diharapkan Deskripsi
@type Teks

Wajib - Selalu ditetapkan ke MediaService.
@context Teks

Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}].
@id URL

Wajib - ID unik untuk merek Anda; misalnya, https://example.com.

ID harus mematuhi persyaratan berikut:

  • ID ini unik secara global di seluruh katalog Anda.
  • Teks ini bersifat statis. ID harus stabil dan tidak berubah dari waktu ke waktu.
  • Formatnya adalah Unified Resource Identifier (URI).
  • Domainnya harus dimiliki oleh organisasi Anda.
name Teks

Wajib - Nama penyedia.

Jika merek Anda memiliki nama khusus lokalitas, cantumkan dalam array. Untuk contohnya, lihat contoh MediaService.
brandIcon ImageObject

Wajib untuk semua Tindakan Tonton dan Tindakan Dengarkan - File gambar ikon merek Anda, diulang, untuk setiap ukuran. Pada hasil Tindakan Tonton/Dengarkan, Google mengaitkan deep link konten Anda ke ikon merek Anda.

File gambar ikon merek Anda harus mematuhi persyaratan berikut:

  • File ini adalah file PNG.
  • Latar belakangnya transparan.
  • Bentuknya bulat.
  • Pastikan gambar anti-alias dan tidak terdistorsi/berpiksel

Properti ini harus diulang, karena Anda harus memberikan lima gambar, satu untuk setiap dimensi berikut:

  • 16x16 piksel, dengan file tidak lebih besar dari 1 KB
  • 20x20 piksel, dengan file tidak lebih dari 1 KB
  • 40x40 piksel, dengan file tidak lebih dari 1 KB
  • 44x44 piksel, dengan file tidak lebih dari 1 KB
  • 112x112 piksel, dengan file tidak lebih dari 3 KB

Persyaratan tambahan untuk integrasi Google TV - Gambar ikon merek Anda ini akan ditampilkan di bagian atas Panduan Program, di tombol Tindakan Tonton, dan di setelan Google TV. Berikan tiga ikon yang memenuhi persyaratan berikut:

  • Satu ikon persegi dalam format file PNG. (dengan resolusi 512x512 piksel, rasio aspek 1:1)
  • Satu ikon kata putih dalam format file PNG. (resolusi tertinggi yang tersedia, tidak ada preferensi untuk rasio aspek)
  • Satu ikon kata berwarna dalam format file PNG. (resolusi tertinggi yang tersedia, tidak ada preferensi untuk rasio aspek)

Pastikan gambar anti-alias dan tidak terdistorsi/berpiksel.

brandIcon.contentURL URL

Wajib - URL gambar.
brandIcon.height Number

Wajib - Tinggi gambar, dalam piksel.
brandIcon.width Number

Wajib - Lebar gambar, dalam piksel.
brandIcon.additionalProperty PropertyValue

Wajib - Properti tambahan yang digunakan untuk mendeskripsikan jenis gambar dan menentukan penggunaan yang dimaksudkan.
brandIcon.additionalProperty.@type Teks

Wajib - Tetapkan ke PropertyValue.
brandIcon.additionalProperty.name Teks

Wajib - Tetapkan ke contentAttributes.
brandIcon.additionalProperty.value Teks

Wajib - Kesesuaian latar belakang.

Agar valid, tetapkan ke setidaknya salah satu nilai berikut:

  • forDarkBackground: Gambar, biasanya ikon transparan, yang cocok untuk digunakan pada latar belakang gelap.
  • forLightBackground: Gambar, biasanya ikon transparan, yang cocok untuk digunakan pada latar belakang terang.
application SotfwareApplication

Wajib jika aplikasi iOS, Android, Cast, atau AndroidTV disediakan - Daftar aplikasi merek Anda di platform berikut:

  • iOS
  • Android
  • Cast
  • AndroidTV
application.@type Teks

Wajib - Selalu ditetapkan ke SoftwareApplication.
application.operatingSystem Teks

Wajib - Tetapkan ke salah satu opsi berikut:

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadUrl URL

Wajib jika berlaku - Untuk platform Android, AndroidTV, dan iOS, Anda harus menentukannya sebagai link ke aplikasi Anda di App Store dan Play Store.

Untuk semua platform lainnya, properti ini tidak wajib.
application.installUrl URL

Wajib jika berlaku - Jika penyedia menawarkan pemutaran media melalui aplikasi AndroidTV, Anda harus menentukannya sebagai link ke file APK AndroidTV.

Jika penyedia tidak menawarkan pemutaran AndroidTV, properti ini tidak wajib.
application.identifier

Teks

Wajib jika berlaku - Untuk platform yang sesuai dengan salah satu nilai berikut, tetapkan sesuai kebutuhan. Properti ini tidak diperlukan:

  • iOS: ID aplikasi App Store. Misalnya, 967093455.
  • Android: Nama paket Android Play Store. Misalnya, com.abc.media.android.
  • Transmisi: ID aplikasi Transmisi. Misalnya, ACDA4FDE.
  • AndroidTV: Nama paket AndroidTV Play Store. Misalnya, com.abc.media.atv.android.
parentOrganization Organisasi

Wajib - Penyedia induk layanan.
parentOrganization.@type Teks

Wajib - Selalu ditetapkan ke Organization.
parentOrganization.name Teks

Wajib diisi - Nama organisasi.
subscriptions MediaSubscription

Opsional - Daftar MediaSubscriptions yang tersedia dan didukung oleh penyedia smartwatch.
baseSubscriptionTier MediaSubscription

Wajib jika berlaku - Jika penyedia smartwatch dan penyedia memiliki paket langganan dasar, Anda harus menetapkannya ke instance langganan untuk konten yang tersedia bagi semua pelanggan. Properti ini tidak wajib.
userRequestsFulfilledBy Teks

Opsional - Tetapkan ke salah satu pihak berikut yang memenuhi permintaan pengguna:

  • Google: Semua permintaan dipenuhi oleh Google. Pada dasarnya, Google menampilkan deep link untuk konten yang diminta.
  • Provider: Semua permintaan dipenuhi oleh penyedia konten, yaitu Penyedia Cloud. Pada dasarnya, penyedia menampilkan deep link untuk konten yang diminta atau memulai pemutaran langsung di perangkat mereka.

Secara default, properti ini ditetapkan ke Google.
mediaOffered Teks

Wajib - Tetapkan ke salah satu dari berikut ini, yang sesuai dengan jenis konten di katalog Anda yang disertakan dalam feed:

  • ["VoD"] - Penyedia hanya menyertakan konten Video on Demand (VoD) dalam feed. Konten VoD mencakup Film dan Acara TV.
  • ["LiveTV"] - Penyedia hanya menyertakan TV Live, yang mencakup konten Channels dan BroadcastEvent, di feed.
  • ["VoD", "LiveTV"] - Penyedia menyertakan konten VoD dan Live TV dalam feed.
  • ["Music"] - Penyedia hanya menyertakan entitas musik dalam feed. Hal ini mencakup konten Album, Artis, Lagu dan Playlist.
  • ["Radio"] - Penyedia hanya menyertakan entitas Radio di feed.
  • ["Music", "Radio"] - Penyedia menyertakan entitas musik dan radio dalam feed. Hal ini mencakup konten Album, Artis, Lagu, Playlist, dan Stasiun Radio.

Contoh MediaService

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": [
        "http://schema.org",
        {
          "@language": "en"
        }
      ],
      "@type": "MediaService",
      "@id": "https://abcmedia.com",
      "name": [
        {
          "@language": "en-us",
          "@value": "ABC Media"
        },
        {
          "@language": "en-gb",
          "@value": "ABC"
        }
      ],
      "userRequestsFulfilledBy": "Google",
      "mediaOffered": [
        "LiveTV",
        "VoD"
      ],
      "brandIcon": [
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_16x16.png",
          "width": 16,
          "height": 16,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_20x20.png",
          "width": 20,
          "height": 20,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_40x40.png",
          "width": 40,
          "height": 40,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_44x44.png",
          "width": 44,
          "height": 44,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_112x112.png",
          "width": 112,
          "height": 112,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        }
      ],
      "application": [
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Android",
          "downloadUrl": "https://google.play.store/com.abc.media.android",
          "identifier": "com.abc.media.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "iOS",
          "downloadUrl": "https://apple.app.store/967093455",
          "identifier": "967093455"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "AndroidTV",
          "downloadUrl": "https://google.play.store/com.abc.media.atv.android",
          "installUrl": "https://abcmedia.com/path_to_apkfile.apk",
          "identifier": "com.abc.media.atv.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Cast",
          "identifier": "ACDA4FDE"
        }
      ],
      "subscriptions": [
        {
          "@type": "MediaSubscription",
          "name": "Basic Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:basic"
        },
        {
          "@type": "MediaSubscription",
          "name": "Premium Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:premium"
        }
      ],
      "baseSubscriptionTier": {
        "@type": "MediaSubscription",
        "name": "Basic Package",
        "@id": "[partner determined string]",
        "identifier": "abcmedia.com:basic"
      },
      "parentOrganization": {
        "@type": "Organization",
        "name": "ABC Media"
      }
    }
  ]
}