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

Bu bölümde, şu sorgu için içerik işaretleme özelliklerinin ayrıntıları yer almaktadır: Medya İşleminizin yapılandırmasını yakalayan MediaService varlık türü entegrasyon

Spesifikasyon tablosu

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

Zorunlu: Her zaman MediaService değerine ayarlanır.
@context Metin

Zorunlu: Her zaman ["http://schema.org", {"@language": "xx"}] değerine ayarlanır.
@id URL

Zorunlu: Markanız için benzersiz bir tanımlayıcı; örneğin, https://example.com.

Tanımlayıcı aşağıdaki koşullara uygun olmalıdır:

  • Kataloğunuzdaki tüm platformlarda benzersizdir.
  • Durağandır. Kimlik sabit olup zaman içinde değişmemelidir.
  • Birleştirilmiş Kaynak Tanımlayıcı (URI) biçimindedir.
  • Kuruluşun alan adı, kuruluşunuza ait olmalıdır.
name Metin

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

Markanızın yerel ayara özgü adları varsa bunları bir dizide listeleyin. Buna örnek olarak MediaService örneğine bakın.
brandIcon ImageObject

Tüm İzleme İşlemleri ve Dinleme İşlemleri için gereklidir: Markanızın resim dosyası simgesini, her boyut için tekrarlı olarak gösterir. İzleme/Dinleme İşlemi sonucunda Google, marka simgenize yönlendiren derin bağlantılar.

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

  • Bu bir PNG dosyasıdır.
  • Arka planı şeffaftır.
  • Şekli yuvarlak bir yapıya sahiptir.
  • Resimlerin kenar yumuşatmalarına sahip olmadığından ve bozuk/pikselleşmemiş olduğundan emin olun

Bu özelliğin her biri için bir tane olmak üzere beş resim sağlamanız gerektiğinden, özelliğin tekrarlanması gerekir. şu boyutları kullanın:

  • 16x16 piksel (dosya boyutu 1 KB'tan büyük değil)
  • 20x20 piksel (dosya boyutu 1 KB'tan büyük değil)
  • 40x40 piksel (dosya boyutu 1 KB'tan büyük değil)
  • 44x44 piksel (dosya boyutu 1 KB'tan büyük değil)
  • 112x112 piksel (dosya boyutu 3 KB'tan büyük değil)

Google TV entegrasyonları için ek koşul: Markanıza ait bu resimler Programlama Kılavuzu'nun üst kısmında, İşlemi İzle düğmelerinde ve Google TV ayarlarına gidin. 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 işareti simgesi. (kullanılabilir en yüksek çözünürlük, en boy oranı tercih edilmez)
  • PNG dosya biçiminde bir renkli marka işareti simgesi. (kullanılabilir en yüksek çözünürlük, en boy oranı tercih edilmez)

Resimlerde kenar yumuşatmalarının olduğundan ve bozuk/pikselleşmemiş olduğundan 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

Gerekli: Resmin türünü tanımlamak ve resmin türünü tanımlamak için kullanılan ek özellik amaçlanan kullanımlardır.
brandIcon.additionalProperty.@type Metin

Zorunlu: PropertyValue olarak ayarlayın.
brandIcon.additionalProperty.name Metin

Zorunlu: contentAttributes olarak ayarlayın.
brandIcon.additionalProperty.value Metin

Zorunlu: Arka plan uygunluğu.

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

  • forDarkBackground: Genellikle şeffaf bir simge olan veya koyu arka planda kullanılmaya uygun.
  • forLightBackground: Genellikle şeffaf bir simge olan veya açık renkli arka planda kullanılmaya uygun.
application SotfwareApplication

iOS, Android, Cast veya AndroidTV uygulamalarının sağlanması halinde gereklidir: Marka uygulamalarınızın listesi aşağıdaki alanlarda yer alır:

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

Zorunlu: Her zaman SoftwareApplication değerine ayarlanır.
application.operatingSystem Metin

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

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

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

Diğer tüm platformlar için bu zorunlu bir özellik değildir.
application.installUrl URL

Geçerliyse gerekli - Sağlayıcı, bir AndroidTV uygulaması için bunu AndroidTV APK dosyasının bağlantısı olarak belirtmeniz gerekir.

Sağlayıcı AndroidTV oynatma hizmeti sunmuyorsa bu zorunlu bir mülk değildir.
application.identifier

Metin

Geçerliyse zorunlu: Aşağıdakilerden birine karşılık gelen platformlar için 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 paketinin adı. Örneğin, com.abc.media.android
  • Yayınlama: Cast uygulaması kimliği. Örneğin, ACDA4FDE.
  • AndroidTV: Play Store AndroidTV paketinin adı. Örneğin, com.abc.media.atv.android
parentOrganization Kuruluş

Zorunlu: Hizmetin üst sağlayıcısı.
parentOrganization.@type Metin

Zorunlu: Her zaman Organization değerine ayarlanır.
parentOrganization.name Metin

Zorunlu: Kuruluş adı.
subscriptions MediaSubscription

İsteğe bağlı: Kullanılabilir MediaSubscriptions listesi saat sağlayıcısı tarafından desteklenir.
baseSubscriptionTier MediaSubscription

Geçerliyse zorunlu: Saat sağlayıcısı ve sağlayıcının temeli varsa abonelik paketi kullanıyorsanız bunu, mevcut içerik için abonelik örneği olarak ayarlamanız gerekir tüm abonelere. Aksi takdirde bu özellik gerekli değildir.
userRequestsFulfilledBy Metin

İsteğe bağlı: Kullanıcıyı karşılayan aşağıdaki taraflardan biri olarak ayarlayın istekler:

  • Google: Tüm istekler Google tarafından karşılanır. Kısacası, Google istenen içeriğin derin bağlantısını döndürür.
  • Provider: Tüm istekler içerik sağlayıcı (içerik sağlayıcı) tarafından Bulut Sağlayıcısı. Temel olarak, sağlayıcı istenen içeriğin derin bağlantısını döndürür oynatma veya oynatma işlemini doğrudan cihazlarında başlatması.

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

Zorunlu: feed'de yer alan kataloğunuz için:

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