Filmlerin içerik işaretleme özellikleri

Bu bölümde, Movie varlık türü için içerik işaretleme özelliklerinin ayrıntıları sunulmaktadır.

Spesifikasyon tablosu

Özellik Beklenen Tür Açıklama
@context Text Zorunlu: Her zaman ["http://schema.org", {"@language": "xx"}]
    olarak ayarlanır
  • Burada "xx", feed'deki dizelerin dilini temsil eder. Her kök varlık bağlamının @language dili, BCP 47 formatında uygun dil koduna ayarlanmalıdır. Örneğin, dil Türkçe olarak ayarlanmışsa altyazı altyazısı İngilizce olsa bile adların İspanyolca olduğu varsayılır.
@type Text Zorunlu: Filmler için her zaman Movie olarak ayarlanır.
@id URL Zorunlu: İçeriğin URI biçimindeki tanımlayıcısı (ör. https://example.com/1234abc).
@id aşağıdaki şartları karşılamalıdır:
  • Kataloğunuzda tüm dünyadan benzersiz
  • Statik; Kimlik sabit olmalı ve zaman içinde değişmemelidir (gösterinin URL özelliği değişse bile). Bu, opak bir dize olarak ele alınacaktır ve çalışan bir bağlantı olması gerekmez.
  • Birleştirilmiş Kaynak Tanımlayıcısı (URI) biçiminde
  • @id değeri için kullanılan alan adı kuruluşunuza ait olmalıdır.
Bir varlığın url özelliği, tanımlayıcı olarak tüm şartları karşıladığı için @id olarak bir varlık url kullanmanızı öneririz. Daha fazla ayrıntı için Tanımlayıcı bölümüne bakın.
url URL Zorunlu: Feed'inizdeki içeriği Google'ın veritabanlarındaki içerikle eşleştirmek için Google'ın kullandığı standart URL.
url aşağıdaki gereksinimleri karşılamalıdır:
  • url genel olarak benzersiz olmalıdır
  • url, Google'ın tarayabileceği, çalışır durumda bir standart URL içermelidir.
Oynatma işleminin derin bağlantısı için bunun yerine hedef nesnenin urlTemplate özelliğine bakın.
name Text Gerekli: Filmin adı.
  • Adları farklı dillerde listelemek için bir dizi kullanın. Birden çok bölge ve dil örneğini inceleyin.
  • Her yerel ayarda yalnızca bir adın desteklendiğini unutmayın (dil-ülke çifti).
titleEIDR Text Kesinlikle Önerilir Neden? - En genel/soyut düzeyde bir film veya televizyon eserini temsil eden EIDR (Eğlence Tanımlayıcı Kaydı) tanımlayıcısı.

Örneğin, "Hayalet Avcıları" olarak bilinen hareketli resmin titleEIDR numarası "10.5240/7EC7-228A-510A-053E-CBB8-J"dir.
editEIDR Text Kesinlikle Önerilir Neden? - Film veya televizyon eserinin belirli bir düzenlemesini / sürümünü temsil eden EIDR tanımlayıcısı (Eğlence Tanımlayıcı Kaydı).

Örneğin, başlığı "ID"ID "10.5240/7EC7-228A-510A-053E-CBB8-J" olan "Hayalet Avcıları" gibi hareketli resim.

editEIDR sağlandığında titleEIDR özelliği gerekli olur.
potentialAction WatchAction Varsa gereklidir - İşlemin ayrıntılarını sağlayan İşlem işaretleme nesnesi.
  • İçerik seç-izle videoda (videoda) kullanılabiliyorsa bu özellik zorunludur. İşlem işaretleme nesnesi, içeriğin derin bağlantısını sağlamalıdır.
  • İçerik bir LiveTV kanalında sunuluyorsa bu özellik isteğe bağlıdır. İlişkili BroadcastService varlığı, bunun yerine kanalın derin bağlantısını sağlar.
  • Movie, hem VoD'de hem de LiveTV'de kullanılabilir.
Birden çok bölgede farklı derin bağlantılar belirtmek için bir dizi kullanın. Birden çok bölge ve dil örneğini inceleyin.
sameAs URL Kesinlikle Önerilir Neden? Filmi tanımlayabilecek bir referans web sayfasının URL'si (örneğin, filmin Wikipedia sayfası). Bu, url mülkünden farklı olmalıdır.
inLanguage Text Filmin BCP 47 biçiminde orijinal dili.
genre Text İlgili tüm türlerin sıralı listesi. Örneğin : ["Aksiyon", "Moda", "Ortam", "Futbol"]
keywords Text Bu içeriği tanımlamak için kullanılan anahtar kelimeler veya etiketler. Bir dizi anahtar kelimeye de izin verilir. Örneğin, ["özellik, biyografi"], içeriği açıklayan bir anahtar kelime dizisi olabilir.
releasedEvent PublicationEvent, FeaturedEvent veya ExclusiveEvent Kesinlikle Önerilir Neden? - Bir yayıncı tarafından içeriğin orijinal (global veya yerel) olarak piyasaya sürülmesini (ör. bir filmin orijinal sinematik çıkış tarihi) belirtmek için PublicationEvent kullanılır.

Ayrıca, hizmetinizin bu içeriği orijinal, öne çıkan, özel vb. olarak pazarladığını belirtmek için FeaturedEvent kullanın.

ExclusiveEvent, hizmetinizin münhasır dağıtım haklarına sahip olduğunu ve nerede ve ne zaman yapılacağını içerir. Ayrıntılar ve örnekler için örnek bölüme bakın.

releasedEvent.@type Text Zorunlu: Bu özelliği her zaman aşağıdakilerden birine ayarladığınızdan emin olun:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Ülke Zorunlu: Bu etkinlikle ilişkili bölgeler.

Bu, PublicationEvent için içeriğin yayınlandığı bölgedir.FeaturedEvent ve ExclusiveEvent için içeriğin öne çıkarıldığı veya hariç tutulduğu bölgedir.

Ülkeler için ISO 3166 kodları kullanın.

Dünya genelinde belirtmek için EARTH değerini ayarlayın.
releasedEvent.startDate Date veya DateTime Önerilen - ExclusiveEvent için gereklidir - Varlık yayınının başlangıç tarihi.

PublicationEvent için bu varlığın ilk gösterim tarihi (ör. bir filmin sinemalarda ilk yayınlandığı tarih) belirtir.

ExclusiveEvent ve FeaturedEvent için bu, tüzel kişinin münhasır olduğu veya öne çıktığı tarihi belirtir.
releasedEvent.endDate Date veya DateTime Önerilen - ExclusiveEvent için gereklidir - Bu, yalnızca ExclusiveEvent ve FeaturedEvent türleri için geçerlidir.

Bu, ExclusiveEvent için içerik haklarının süresinin dolacağı tarihi temsil eder.

FeaturedEvent için bu, sağlayıcının varlığın yer aldığı son tarihi temsil eder.

Söz konusu içerik kalıcı olarak hariç tutulduysa veya öne çıkarılıyorsa endDate özelliğini geçerli tarihten 20 yıl sonrasına ayarlayın.
releasedEvent.publishedBy Kuruluş veya Kişi İsteğe bağlı: Bu varlığı yayınlayan kuruluş veya kişidir.
description Text Kesinlikle Önerilir Neden? Filmin özeti. Özet özetler yerine kısa özetler tercih edilir. 300 karakterle sınırlıdır.
duration Süre Filmin ISO 8601 biçiminde çalışma zamanı. Lütfen şu biçimi kullanın: "PT00H00M".
director Person Kesinlikle Önerilir Neden? Filmin yönetmenleri.
actor Person Kesinlikle Önerilir Neden? Filmin oyuncuları.
producer Kuruluş veya Kişi Kesinlikle Önerilir Neden? Filmin yapımcıları.
image ImageObject Google TV için gereklidir - Filmle ilgili görseller. image ürününe dahil edilecek gerekli ve isteğe bağlı özelliklerle ilgili daha fazla bilgi için Resim özellikleri başlıklı makaleyi inceleyin.
trailer.description Text Fragmanın açıklaması. Fragman örneğine göz atın.
trailer.inLanguage Text Fragmanın BCP 47 biçiminde dili.
trailer.url URL Herkese açık olarak barındırılan ve ilgili prodüksiyon stüdyoları veya yetkili kaynaklar tarafından yüklenen fragmanın URL'si.
trailer.regionsAllowed Yer Medyaya izin verilen bölgeler. Belirtilmezse her yerde izin verildiği varsayılır. Ülkeleri ISO 3166 biçiminde belirtin.
identifier PropertyValue Kesinlikle Önerilir Neden? - Bu varlığı açık bir şekilde tanımlayan harici veya diğer kimlik. Birden fazla tanımlayıcıya izin verilir. Ayrıntılar için Tanımlayıcı özellikleri bölümüne bakın.
review Yorum Film için yorum puanları
review.reviewRating Puan Yorum sağlanmışsa gereklidir. Yorumda verilen puanı belirtmek için kullanılır.
contentRating Metin veya Derecelendirme Yetişkinlere uygun içerikler için gereklidir, aksi takdirde kesinlikle önerilir Neden? - Genel içerik derecelendirmesi. İçerik derecelendirmesi bir metin dizesi biçiminde yapılırsa iki varyasyon kabul edilir:
  • Derecelendirme ajansı, başa beyaz bir nokta koyarak değerlendirmenin başına yer verdi. Örneğin, ABD'deki "MPAA" ajansından alınan "PG-13" derecelendirmesi "MPAA PG-13" olarak tanımlanmalıdır. Ajansların listesine bakın.
  • Filmin puanını bilmediğinizi gösteren "RATING bilinmiyor" (büyük/küçük harfe duyarlı değil) değeri.
contentRating.author Metin veya Kuruluş contentRating, Rating kullanıyorsa gereklidir - Derecelendirme ajansının adı.
contentRating.ratingValue Text contentRating, Rating kullanıyorsa gereklidir - Derecelendirmenin değeri.
contentRating.advisoryCode Text İçeriğin tavsiye kodu. Kabul edilen değerler şunlardır: D, FV, L, S ve V. D = Diyalog, FV = Fantastik Şiddet, L = Dil, S = Cinsel İçerik, V = Şiddet.
popularityScore Popülerlik PuanıSpesifikasyonu Kesinlikle Önerilir Neden? Google'ın kullanıcılar için hangi medyanın oynatılacağını belirlemek üzere kullandığı puan ve diğer sinyaller. Bu puan, kataloğunuzdaki diğer içeriklere kıyasla içeriğin popülerliğini gösterir. Bu nedenle, puan ölçeğinin kataloglarınızdaki tüm öğeler arasında feed'leriniz genelinde tutarlı olması gerekir. Varsayılan olarak, bir öğenin popülerlik puanı 0 olarak ayarlanır.
popularityScore.@type Text Her zaman PopularityScoreSpecification değerine ayarlanır.
popularityScore.value Number Varlığın popülerliğini belirten negatif olmayan sayısal değerdir. Yüksek puan, daha yüksek popülerlik anlamına gelir.
popularityScore.eligibleRegion Ülke Bu popülerlik puanının geçerli olduğu bölgeler. Popülerlik puanı dünya genelinde geçerliyse EARTH olarak ayarlayın. Bu özellik varsayılan olarak EARTH değerine ayarlıdır.
Note: Yerel ayara göre popülerlik, dünya genelinde popülerlikten daha önceliklidir
category Text Varsa gereklidir - Varlık Movie varyantıysa bu özelliği doldurun. category aşağıdakilerden birini seçin:
  • Home Release: Evde izleme amacıyla satılan veya kiralanan sürüm.
  • Theatrical Release: Sinemalarda yayınlanan bir sürüm.
  • International Release: Uluslararası olarak yayınlamak için düzenlenen bir sürüm.
  • Remastered: Resim, ses veya her ikisi de daha güncel bir standarda yükseltilen bir sürüm.
  • Unrated: MPAA veya benzer bir ajans tarafından denetlenmeyen bir sürüm.
  • Director Cut: Yönetmenin kendi onaylanan düzenlemesini temsil eden bir sürüm.
  • Extended Cut: Sinema versiyonundan daha uzun bir versiyon.
workExample Film Filmin varyantlarını belirtir. Bu özelliği varyant sürümlerinin Movie varlıklarına değil, ana Movie varlığına ekleyin.
workExample.@id URL Bu özellik, Movie varyantları için Movie varyantının @id varyantını sağlar.
workExample.@type Text Gerekli: Her zaman Movie olarak ayarlanır. Bu, birden fazla varyantı olan bir Movie için dizi olarak temsil edilebilir.
workExample.@id URL Zorunlu: Movie varyantının @id değeri.
workExample.name Text Zorunlu: Movie varyantının adı.
workExample.category Text Zorunlu: Belirli bir sürümün film varyantı türü. Kategoriyi aşağıdakilerden biri olarak ayarlayın:
  • Home Release: Evde izleme amacıyla satılan veya kiralanan sürüm.
  • Theatrical Release: Sinemalarda yayınlanan bir sürüm.
  • International Release: Uluslararası olarak yayınlamak için düzenlenen bir sürüm.
  • Remastered: Resim, ses veya her ikisi de daha güncel bir standarda yükseltilen bir sürüm.
  • Unrated: MPAA veya benzer bir ajans tarafından denetlenmeyen bir sürüm.
  • Director Cut: Yönetmenin kendi onaylanan düzenlemesini temsil eden bir sürüm.
  • Extended Cut: Sinema versiyonundan daha uzun bir versiyon.

Örnek

Ana film

Kesim varyantları uzatılmış bir film.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "contentRating": "RATING NOT KNOWN",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
  "workExample": {
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie_extended_cut",
      "name": "My Favorite Movie Extended Cut"
      "category": "Extended Cut"
  }
}

Genişletilmiş kesme varyantı

Ana filmin genişletilmiş kesit sürümü.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie_extended_cut",
  "url": "http://www.example.com/my_favorite_movie_extended_cut",
  "name": "My Favorite Movie Extended Cut",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package",
        "identifier": "example.com:example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
  "contentRating": {
        "@type": "Rating",
        "author": "MPAA",
        "ratingValue": "R",
        "advisoryCode": "FV"
   },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is the extended cut of my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
 "exampleOfWork": {
  "@id": "http://www.example.com/my_favorite_movie",
 }
 "category": "Extended Cut"
}

Bu tesislerle ilgili konular için aşağıdaki sayfalara göz atın: