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

Bu bölümde, MediaService varlık türü için Medya İşlemi entegrasyonunuzun yapılandırmasını yakalayan içerik işaretleme özelliklerinin ayrıntıları sunulmaktadır.

Spesifikasyon tablosu

Özellik Beklenen Tür Açıklama
@type Text

Gerekli: Her zaman MediaService olarak ayarlanır.

@context Text

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

@id URL

Zorunlu: Markanız için benzersiz bir tanımlayıcı (ör. https://example.com).

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

  • Kataloğunuz genelinde benzersizdir.
  • Statiktir. Kimlik sabit olup zaman içinde değişmemelidir.
  • Unified Resource Identifier (URI) biçimindedir.
  • Bu alan, kuruluşunuza ait olmalıdır.
name Text

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

Markanızın yerel ayara özgü adları varsa bunları bir dizide listeleyin. Bunun bir örneği için MediaService örneğine bakın.

brandIcon ImageObject

Tüm İzleme İşlemleri ve Dinleme İşlemleri için gereklidir - Marka simgenizin, her boyut için yinelenen resim dosyası. İzleme/Dinleme İşlemi sonucunda Google, içeriklerinizin derin bağlantılarını marka simgenizle ilişkilendirir.

Marka simgesi resim dosyanız aşağıdaki şartlara uygun olmalıdır:

  • Bu bir PNG dosyası.
  • Arka planı şeffaftır.
  • Şeklinde yuvarlak bir yapı vardır.
  • Resimlere alan takma adı uygulandığından ve şekillerin bozuk/pikselleştirilmiş olmadığından emin olun

Aşağıdaki boyutların her biri için bir tane olmak üzere beş resim eklemeniz gerektiğinden bu özellik tekrarlanmalıdır:

  • 16x16 piksel, dosya en fazla 1 KB
  • 20x20 piksel, dosya en fazla 1 KB
  • Boyutu 40x40 piksel ve dosya en fazla 1 KB
  • 44x44 piksel, dosya en fazla 1 KB
  • 112x112 piksel, dosya en fazla 3 KB

Google TV entegrasyonları için ek koşul - Marka simgenizin bu resimleri, Programlama Rehberi'nin üst kısmında, İşlem İşlemi düğmelerinde ve Google TV ayarlarında görüntülenir. Aşağıdaki gereksinimleri karşılayan üç simge sağlayın:

  • PNG dosya biçiminde bir kare simge. (512x512 piksel çözünürlük ve 1:1 en boy oranı ile)
  • PNG dosya biçiminde bir beyaz marka işareti simgesi. (mevcut en yüksek çözünürlük, en boy oranı tercih edilmez)
  • PNG dosya biçiminde renkli bir marka işareti simgesi. (mevcut en yüksek çözünürlük, en boy oranı tercih edilmez)

Resimlere alan takma adı uygulandığından ve şekillerin bozuk/pikselleştirilmiş olmadığından emin olun.

brandIcon.contentURL URL

Gerekli: Resmin URL'si.

brandIcon.height Number

Gerekli - Resmin piksel cinsinden yüksekliği.

brandIcon.width Number

Gerekli: Resmin piksel cinsinden genişliği.

brandIcon.additionalProperty PropertyValue

Zorunlu: Resmin türünü açıklamak ve amaçlanan kullanımlarını tanımlamak için kullanılan ek özellik.

brandIcon.additionalProperty.@type Text

Gerekli: PropertyValue olarak ayarlayın.

brandIcon.additionalProperty.name Text

Gerekli: contentAttributes olarak ayarlayın.

brandIcon.additionalProperty.value Text

Gerekli: Arka plana uygunluk.

Geçerli olması için aşağıdaki değerlerden en az birine ayarlayın:

  • forDarkBackground: Genellikle şeffaf bir simge olan ve koyu arka plan üzerinde kullanılmaya uygun bir resim.
  • forLightBackground: Açık renkli arka plan üzerinde kullanılmaya uygun, genellikle şeffaf bir simge olan resim.
application Sotfware uygulaması

iOS, Android, Cast veya AndroidTV uygulamaları sağlanmışsa gerekir - Aşağıdakiler arasındaki marka uygulamalarınızın listesi:

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

Gerekli: Her zaman SoftwareApplication olarak ayarlanır.

application.operatingSystem Text

Zorunlu: Aşağıdakilerden birine ayarlanır:

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

Varsa zorunludur - 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 platformlarda bu özellik zorunlu değildir.

application.installUrl URL

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

Sağlayıcı, AndroidTV'yi oynatma olanağı sunmuyorsa bu, zorunlu bir mülk değildir.

application.identifier

Text

Varsa gereklidir - Aşağıdaki değerlerden birine karşılık gelen platformlar için bunu uygun şekilde ayarlayın. Bu özellik aksi halde zorunlu değildir:

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

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

parentOrganization.@type Text

Gerekli: Her zaman Organization olarak ayarlanır.

parentOrganization.name Text

Zorunlu: Kuruluşun adı.

subscriptions MedyaAboneliği

İsteğe bağlı: Servis sağlayıcı tarafından desteklenen kullanılabilir MediaSubscriptions listesinin listesi.

baseSubscriptionTier MedyaAboneliği

Varsa gereklidir - Bir izleme sağlayıcısının ve sağlayıcının temel abonelik paketi varsa tüm abonelere sunulan içerikler için bunu abonelik örneğine ayarlamanız gerekir. Bu özellik gerekli değildir.

userRequestsFulfilledBy Text

İ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, temel olarak istenen içeriğin derin bağlantısını döndürür.
  • Provider: Tüm istekler içerik sağlayıcı olan Bulut Sağlayıcısı tarafından karşılanır. Esas olarak sağlayıcı, istenen içerik için derin bağlantıyı döndürür veya oynatmayı doğrudan kendi cihazında başlatır.

Bu özellik varsayılan olarak Google değerine ayarlıdır.

mediaOffered Text

Zorunlu: Aşağıdakilerden birine ayarlanır. Bu durum, kataloğunuzda feed'e dahil edilen içerik türlerine karşılık gelir:

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