MediaService'in içerik işaretleme özellikleri (Zorunlu)

Bu bölümde, medya işlemi entegrasyonunuzun yapılandırmasını yakalayan MediaService öğe türü için içerik işaretleme özelliklerinin ayrıntıları sağlanır.

Spesifikasyon tablosu

Mülk Beklenen Tür Açıklama
@type Metin

Zorunlu: Her zaman MediaService olarak ayarlanır.

@context Metin

Zorunlu: Her zaman ["http://schema.org", {"@language": "xx"}] olarak ayarlanır.

@id URL

Zorunlu: Markanızın benzersiz tanımlayıcısıdır (ör. https://example.com).

Tanımlayıcı aşağıdaki şartlara uymalıdır:

  • Kataloğunuzda dünya genelinde benzersiz olmalıdır.
  • Statiktir. Kimlik sabit olup zaman içinde değişmemelidir.
  • Birleştirilmiş Kaynak Tanımlayıcısı (URI) biçimindedir.
  • Alan adı kuruluşunuza ait olmalıdır.
name Metin

Zorunlu: Sağlayıcının adı.

Markanızda yerel ayara özel adlar varsa bunları bir dizi halinde listeleyin. Bununla ilgili bir örnek için MediaService örneğine bakın.

brandIcon ImageObject

Tüm İzleme İşlemleri ve Dinleme İşlemleri için zorunludur: Marka simgenizin her boyut için tekrarlanan resim dosyası. Google, İzleme/Dinleme işlem sonucunda içeriğinizin derin bağlantılarını marka simgenizle ilişkilendirir.

Marka simgesi resim dosyanız aşağıdaki koşulları karşılamalıdır:

  • PNG dosyası olmalıdır.
  • Arka planı şeffaf olmalıdır.
  • Yuvarlak bir şekle sahiptir.
  • Resimlerin kenar yumuşatma özelliğinin etkinleştirildiğinden ve bozuk/piksel piksel olmadığından emin olun.

Aşağıdaki boyutların her biri için birer resim sağlamanız gerektiğinden bu özellik tekrarlanmalıdır:

  • 16x16 piksel, 1 KB'tan büyük olmayan bir dosya
  • 20x20 piksel, 1 KB'tan büyük olmayan bir dosya
  • 40x40 piksel, 1 KB'tan büyük olmayan bir dosya
  • 44x44 piksel, 1 KB'tan büyük olmayan bir dosya
  • 112x112 piksel, 3 KB'tan büyük olmayan bir dosya

Google TV entegrasyonları için ek şart: Marka simgenizin bu resimleri, Program Rehberi'nin üst kısmında, İzleme İşlemi düğmelerinde ve Google TV ayarlarında gösterilir. Aşağıdaki koşulları karşılayan üç simge sağlayın:

  • PNG dosya biçiminde bir kare simge. (512x512 piksel çözünürlük, 1:1 en boy oranı)
  • PNG dosya biçiminde bir beyaz marka simgesi. (mevcut en yüksek çözünürlük, en boy oranı tercihi yok)
  • PNG dosya biçiminde bir renkli marka simgesi. (mevcut en yüksek çözünürlük, en boy oranı tercihi yok)

Resimlerin kenar yumuşatma özelliğinin etkinleştirildiğinden ve bozuk/piksel piksel olmadığından emin olun.

brandIcon.contentURL URL

Zorunlu: Resmin URL'si.

brandIcon.height Number

Zorunlu: Resmin piksel cinsinden yüksekliği.

brandIcon.width Number

Zorunlu: Resmin piksel cinsinden genişliği.

brandIcon.additionalProperty PropertyValue

Zorunlu: Resmin türünü tanımlamak için kullanılan ek özellik, resmin amaçlanan kullanımlarını da tanımlar.

brandIcon.additionalProperty.@type Metin

Zorunlu: PropertyValue olarak ayarlanır.

brandIcon.additionalProperty.name Metin

Zorunlu: contentAttributes olarak ayarlanır.

brandIcon.additionalProperty.value Metin

Zorunlu: Arka planın uygunluğu.

Geçerli olması için aşağıdaki değerlerden en az birine ayarlanmalıdır:

  • forDarkBackground: Koyu arka planda kullanıma uygun, genellikle şeffaf bir simge olan resim.
  • forLightBackground: Açık arka planda kullanıma uygun, genellikle şeffaf bir simge olan bir resim.
application SotfwareApplication

iOS, Android, Cast veya AndroidTV uygulamaları sağlanıyorsa zorunludur: Aşağıdaki platformlardaki marka uygulamalarınızın listesi:

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

Zorunlu: Her zaman SoftwareApplication olarak ayarlanır.

application.operatingSystem Metin

Zorunlu: Aşağıdakilerden birine ayarlayın:

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

Geçerliyse gereklidir: Android, AndroidTV ve iOS platformları için bunu App Store ve Play Store'daki uygulamanızın bağlantısı olarak belirtmeniz gerekir.

Diğer tüm platformlar için bu özellik gerekli değildir.

application.installUrl URL

Geçerliyse zorunludur: Sağlayıcı, AndroidTV uygulaması üzerinden medya oynatma sunuyorsa bunu AndroidTV APK dosyasının bağlantısı olarak belirtmeniz gerekir.

Sağlayıcı AndroidTV oynatma özelliği sunmuyorsa bu özellik gerekli değildir.

application.identifier

Metin

Geçerliyse gerekli: Aşağıdaki değerlerden birine karşılık gelen platformlar için bu değeri buna göre ayarlayın. Aksi takdirde bu özellik gerekli değildir:

  • iOS: App Store uygulama tanımlayıcısı. Örneğin, 967093455.
  • Android: Play Store Android paketi adı. Örneğin, com.abc.media.android.
  • Cast: Cast uygulama kimliği. Örneğin, ACDA4FDE.
  • AndroidTV: Play Store AndroidTV paket adı. Örneğin, com.abc.media.atv.android.
parentOrganization Kuruluş

Zorunlu: Hizmetin ana sağlayıcısı.

parentOrganization.@type Metin

Zorunlu: Her zaman Organization olarak ayarlanır.

parentOrganization.name Metin

Zorunlu: Kuruluş adı.

subscriptions MediaSubscription

İsteğe bağlı: Kol saati sağlayıcısı tarafından desteklenen mevcut MediaSubscriptions hizmetlerin listesi.

baseSubscriptionTier MediaSubscription

Varsa zorunludur: Bir izleme sağlayıcısı varsa ve sağlayıcının temel abonelik paketi varsa bunu tüm abonelerin erişimine açık içerik için abonelik örneği olarak ayarlamanız gerekir. Aksi takdirde bu özellik gerekli değildir.

userRequestsFulfilledBy Metin

İsteğe bağlı: Kullanıcı isteklerini yerine getiren aşağıdaki taraflardan birine ayarlanır:

  • Google: Tüm istekler Google tarafından karşılanır. Google, istenen içeriğin derin bağlantısını döndürür.
  • Provider: Tüm istekler içerik sağlayıcı (bulut sağlayıcı) tarafından karşılanır. Sağlayıcı, istenen içeriğin derin bağlantısını döndürür veya oynatmayı doğrudan cihazlarında başlatır.

Bu özellik varsayılan olarak Google olarak ayarlanmıştır.

mediaOffered Metin

Zorunlu: Kataloğunuzda feed'e dahil edilen içerik türlerine karşılık gelen aşağıdakilerden birine ayarlanır:

  • ["VoD"]: Sağlayıcı, feed'e yalnızca seç-izle video (VoD) içeriği dahil ediyor. Seç-izle içerikleri arasında Filmler ve TV Dizileri yer alır.
  • ["LiveTV"]: Sağlayıcı, feed'e yalnızca Channels ve BroadcastEvent içeriklerini içeren Canlı TV'yi dahil eder.
  • ["VoD", "LiveTV"]: Sağlayıcı, feed'e hem seç-izle hem de canlı TV içeriği dahil ediyor.
  • ["Music"]: Sağlayıcı, feed'e yalnızca müzik öğeleri ekler. Buna albüm, sanatçı, şarkı ve oynatma listesi içerikleri dahildir.
  • ["Radio"]: Sağlayıcı, feed'e yalnızca radyo varlıklarını dahil eder.
  • ["Music", "Radio"]: Sağlayıcı, feed'e müzik ve radyo öğeleri ekler. Albüm, Sanatçılar, Şarkılar, Oynatma Listesi ve Radyo İstasyonu içerikleri bu kapsamdadır.

MediaService örneği

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