Properti markup konten MediaService (Wajib)

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

Tabel spesifikasi

Properti Jenis yang Diharapkan Deskripsi
@type Teks

Wajib - Selalu tetapkan ke MediaService.
@context Teks

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

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

ID harus mematuhi persyaratan berikut:

  • Ini unik secara global di seluruh katalog Anda.
  • Sistem 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 nama tersebut 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 dengan ikon merek Anda.

File gambar ikon merek Anda harus mematuhi persyaratan berikut:

  • Ini adalah file PNG.
  • Latar belakangnya transparan.
  • Bentuknya berbentuk bulat.
  • Pastikan gambar anti-alias dan tidak terdistorsi

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

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

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

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

Pastikan gambar anti-alias dan tidak terdistorsi/piksel.

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 tujuan penggunaannya.
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 setidaknya ke 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 Android TV disediakan - Daftar aplikasi merek Anda di wilayah berikut:

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

Wajib - Selalu tetapkan ke SoftwareApplication.
application.operatingSystem Teks

Wajib - Tetapkan ke salah satu hal berikut:

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

Wajib jika ada - 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 ada - Jika penyedia menawarkan pemutaran media melalui aplikasi AndroidTV, Anda harus menentukannya sebagai link ke file APK AndroidTV.

Jika penyedia tidak menawarkan pemutaran AndroidTV, ini bukan properti yang diperlukan.
application.identifier

Teks

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

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

Wajib - Penyedia induk layanan.
parentOrganization.@type Teks

Wajib - Selalu tetapkan ke Organization.
parentOrganization.name Teks

Wajib diisi - Nama organisasi.
subscriptions LanggananMedia

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

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 diwajibkan.
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 perangkatnya.

Secara default, properti ini ditetapkan ke Google.
mediaOffered Teks

Wajib - Tetapkan ke salah satu opsi berikut, 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 Saluran dan BroadcastEvent, dalam feed.
  • ["VoD", "LiveTV"] - Penyedia menyertakan konten VoD dan TV Live dalam feed.
  • ["Music"] - Penyedia hanya menyertakan entitas musik dalam feed. Hal ini termasuk konten Album, Artis, Lagu dan Playlist.
  • ["Radio"] - Penyedia hanya menyertakan entitas Radio dalam feed.
  • ["Music", "Radio"] - Penyedia menyertakan entitas musik dan radio di feed. Konten 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"
      }
    }
  ]
}