Properti markup konten MediaService (Wajib)

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

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:

  • Produk ini bersifat unik secara global di seluruh katalog Anda.
  • Atribut ini statis. ID harus stabil dan tidak berubah dari waktu ke waktu.
  • Formatnya 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. Sebagai contoh, lihat contoh MediaService.

brandIcon ImageObject

Diperlukan untuk semua Tindakan Tonton dan Tindakan Dengarkan - File gambar merek Anda ikon, diulang, untuk setiap ukuran. Di hasil Watch/Listen Action, Google mengaitkan deep link konten ke ikon merek Anda.

File gambar ikon merek Anda harus mematuhi persyaratan berikut:

  • Berupa file PNG.
  • Latar belakang transparan.
  • Bentuknya bulat.
  • Pastikan gambar anti-alias dan tidak terdistorsi/piksel

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

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

Persyaratan tambahan untuk integrasi GoogleTV - Gambar merek Anda akan ditampilkan di bagian atas Panduan Pemrograman, tombol Watch Action dan di setelan Google TV. Berikan 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 yang tersedia, tidak ada preferensi untuk rasio aspek)
  • Satu ikon logo teks berwarna dalam format file PNG. (resolusi tertinggi yang tersedia, tidak ada preferensi untuk rasio aspek)

Pastikan gambar bersifat anti-alias dan tidak terdistorsi/pikselnya terdistorsi.

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 penggunaan.

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:

  • 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 menetapkannya sebagai link ke aplikasi Anda di App Store dan Play Store.

Untuk semua platform lain, properti ini tidak bersifat wajib.

application.installUrl URL

Wajib jika berlaku - Jika penyedia menawarkan pemutaran media melalui AndroidTV, Anda harus menentukan ini sebagai tautan ke file APK AndroidTV.

Jika penyedia tidak menawarkan pemutaran AndroidTV, ini bukan properti wajib.

application.identifier

Teks

Wajib jika berlaku - Untuk platform yang sesuai dengan salah satu platform berikut yang sesuai, tentukan nilai tersebut. 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 Cast. 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 - Nama organisasi.

subscriptions MediaSubscription

Opsional - Daftar MediaSubscriptions yang tersedia didukung oleh penyedia smartwatch.

baseSubscriptionTier MediaSubscription

Wajib jika berlaku - Jika penyedia smartwatch dan penyedia memiliki basis paket langganan, Anda harus menyetelnya ke instance langganan untuk konten yang tersedia kepada semua pelanggan. Properti ini tidak diperlukan.

userRequestsFulfilledBy Teks

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

  • Google: Semua permintaan dipenuhi oleh Google. Pada dasarnya, Google menampilkan deep link untuk konten yang diminta.
  • Provider: Semua permintaan dipenuhi oleh penyedia konten, 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 opsi berikut, yang sesuai dengan jenis konten di katalog yang disertakan dalam feed:

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

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