Filmlerin içerik işaretleme özellikleri

Bu bölümde, Movie öğe türü için içerik işaretleme özelliklerinin ayrıntıları verilmektedir.

Spesifikasyon tablosu

Mülk Beklenen Tür Açıklama
@context Metin Zorunlu: Her zaman ["http://schema.org", {"@language": "xx"}]
    olarak ayarlanır.
  • Burada "xx", feed'deki dizelerin dilini gösterir. Her kök öğe bağlamının @language özelliği, BCP 47 biçiminde uygun dil koduna ayarlanmalıdır. Örneğin, dil İspanyolca olarak ayarlanmışsa altyazı/dublaj dili İngilizce olsa bile adların İspanyolca olduğu varsayılır.
@type Metin Zorunlu: Filmler için her zaman Movie olarak ayarlanır.
@id URL Zorunlu: İçeriğin URI biçimindeki tanımlayıcısıdır (ör. https://example.com/1234abc).
@id aşağıdaki koşulları karşılamalıdır:
  • Kataloğunuzda genel olarak benzersiz olmalıdır.
  • 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 işlenir 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 öğenin url özelliği, tanımlayıcı olarak tüm koşulları karşıladığı için @id olarak bir öğenin url özelliğini kullanmanızı öneririz. Daha ayrıntılı bilgi için Tanımlayıcı bölümüne bakın.
url URL Zorunlu: Google'ın feed'inizdeki içeriği Google'ın veritabanlarındaki içerikle eşleştirmek için kullandığı, içeriğin standart URL'si.
url Aşağıdaki koşulları karşılamalıdır:
  • url global olarak benzersiz olmalıdır
  • url, Google'ın tarayabileceği çalışan bir standart URL içermelidir.
Oynatma derin bağlantısı için bunun yerine hedef nesnesinin urlTemplate özelliğine bakın.
name Metin Zorunlu: Filmin adı.
  • Adları farklı dillerde listelemek için bir dizi kullanın. Birden fazla bölge ve dil örneğine bakın.
  • Her yerel ayar (dil-ülke çifti) için yalnızca bir adın desteklendiğini unutmayın.
titleEIDR Metin Önemle Tavsiye Edilir Neden? - En genel/soyut düzeyde bir film veya televizyon yapımını temsil eden bir EIDR (Entertainment Identifier Registry) tanımlayıcısı.

Örneğin, "Hayalet Avcıları" olarak bilinen sinema filminin titleEIDR'si "10.5240/7EC7-228A-510A-053E-CBB8-J"dir.
editEIDR Metin Önemle Tavsiye Edilir Neden? - Bir film veya televizyon eserinin belirli bir düzenlemesini / baskısını temsil eden EIDR (Entertainment Identifier Registry) tanımlayıcısı.

Örneğin, "10.5240/7EC7-228A-510A-053E-CBB8-J" adlı EIDR'ye sahip "Hayalet Avcıları" adlı sinema filminin "10.5240/1F2A-E1C5-680A-14C6-E76B-I" ve "10.5240/8A35-3BEE-6497-5D12-9E4F-3" gibi çeşitli düzenlemeleri vardır. editEIDR sağlanıyorsa

titleEIDR özelliği zorunludur.
potentialAction WatchAction Geçerliyse zorunlu: İşlemin ayrıntılarını sağlayan bir işlem işaretleme nesnesi.
  • İçerik, seç-izle video (VoD) olarak sunuluyorsa bu özellik gereklidir. İşlem işaretleme nesnesi, içeriğin derin bağlantısını sağlamalıdır.
  • İçerik bir LiveTV kanalında kullanılabiliyorsa bu özellik isteğe bağlıdır. Bunun yerine, ilişkili BroadcastService öğesi kanalın derin bağlantısını sağlar.
  • Movie, hem VOD hem de LiveTV'de kullanılabilir.
Birden fazla bölgede farklı derin bağlantılar belirtmek için dizi kullanın. Birden fazla bölge ve dil örneğine bakın.
sameAs URL Önemle Tavsiye Edilir Neden? Filmi tanımlayabilecek bir referans web sayfasının URL'si (örneğin, filmin Wikipedia sayfası). Bu, url özelliğinden farklı olmalıdır.
inLanguage Metin Kesinlikle Önerilir Filmin BCP 47 biçimindeki orijinal dili.
genre Metin İlgili tüm türlerin sıralı listesi. Örneğin : ["Aksiyon", "Moda", "Çevre", "Futbol"]
keywords Metin Bu içeriği açıklamak için kullanılan anahtar kelimeler veya etiketler. Anahtar kelime dizisine de izin verilir. Örneğin, ["feature, biography"] içerikleri açıklayan bir anahtar kelime dizisi olabilir.
releasedEvent PublicationEvent, FeaturedEvent veya ExclusiveEvent Önemle Tavsiye Edilir Neden? - PublicationEvent, bir yayıncının içeriği ilk yayınladığı tarihi (küresel veya yerel) belirtmek için kullanılır. Örneğin, bir filmin ilk sinema gösterim tarihi.

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

ExclusiveEvent, hizmetinizin özel dağıtım haklarına sahip olduğunu ve bu hakların nerede ve ne zaman geçerli olduğunu belirtir.

Ayrıntılar ve örnekler için örnekler bölümüne bakın.
releasedEvent.@type Metin 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.

PublicationEvent için bu, içeriğin yayınlandığı bölgedir.

FeaturedEvent ve ExclusiveEvent için bu, içeriğin öne çıkarıldığı veya özel olarak sunulduğu bölgedir.

Ülkeler için ISO 3166 kodlarını kullanın. Dünyanın her yerini belirtmek için EARTH olarak ayarlayın.
releasedEvent.startDate Date veya DateTime Önerilir - ExclusiveEvent için zorunludur - Öğenin yayınlanma başlangıç tarihi.

PublicationEvent için bu, öğenin ilk yayınlanma tarihini (ör. bir filmin sinemalarda ilk yayınlanma tarihi) belirtir.

ExclusiveEvent ve FeaturedEvent için bu, öğenin özel veya öne çıkarılan olarak yayınlanmaya başladığı tarihi gösterir.
releasedEvent.endDate Date veya DateTime Önerilir - ExclusiveEvent için zorunludur - Bu yalnızca ExclusiveEvent ve FeaturedEvent türleri için geçerlidir.

ExclusiveEvent için bu, içerik haklarının sona erdiği tarihi gösterir.

FeaturedEvent için bu, sağlayıcının öğeyi öne çıkardığı son tarihi gösterir.

İçerik sürekli olarak özel veya öne çıkarılmışsa endDate değerini mevcut tarihten 20 yıl sonrasına ayarlayın.
releasedEvent.publishedBy Organization veya Person İsteğe bağlı: Bu öğeyi yayınlayan kuruluş veya kişi.
description Metin Önemle Tavsiye Edilir Neden? Filmin özeti. Konu özetleri, gerçeklere dayalı özetlere tercih edilir. 300 karakter sınırı.
duration Süre Filmin süresi ISO 8601 biçiminde. Lütfen "PT00H00M" biçimini kullanın.
director Person Önemle Tavsiye Edilir Neden? Filmin yönetmenleri.
actor Person Önemle Tavsiye Edilir Neden? Filmin oyuncuları.
producer Organization veya Person Önemle Tavsiye Edilir Neden? Filmin yapımcıları.
image ImageObject Google TV için zorunlu: Filmle ilgili resimler. image ile birlikte eklenmesi gereken zorunlu ve isteğe bağlı özellikler hakkında daha fazla bilgi için Resim özellikleri başlıklı makaleyi inceleyin.
trailer.description Metin Fragmanın açıklaması. Fragman örneğine bakın.
trailer.inLanguage Metin Önemle Tavsiye Edilir: Fragmanın BCP 47 biçimindeki dili.
trailer.url URL Herkese açık olarak barındırılan ve ilgili yapım stüdyoları veya yetkili kaynaklar tarafından yüklenen bir fragmanın URL'si.
trailer.regionsAllowed Place Medya içeriğine izin verilen bölgeler. Belirtilmezse her yerde izin verildiği varsayılır. Ülkeleri ISO 3166 biçiminde belirtin.
identifier PropertyValue Önemle Tavsiye Edilir Neden? - Bu öğeyi açık bir şekilde tanımlayan harici veya diğer kimlik. Birden fazla tanımlayıcıya izin verilir. Ayrıntılı bilgi için Tanımlayıcı özellikleri bölümüne bakın.
review Yorum Film için yorum puanları
review.reviewRating Derecelendirme Yorum varsa zorunludur. Bu, yorumda verilen puanı belirtmek için kullanılır.
contentRating Metin veya Puan Yetişkinlere uygun içeriklerde zorunlu, diğer durumlarda önemle tavsiye edilir Neden? - Genel içerik derecelendirmesi. İçerik derecelendirmesi metin dizesi biçiminde veriliyorsa iki varyasyon kabul edilir:
  • Derecelendirme kuruluşu, derecelendirmenin başına aralarında boşluk olacak şekilde eklenir. Örneğin, ABD'deki "MPAA" ajansının verdiği "PG-13" derecesi "MPAA PG-13" olarak açıklanmalıdır. Ajans listesine bakın.
  • Filmin derecelendirmesini bilmediğinizi belirtmek için "RATING NOT KNOWN" (büyük/küçük harfe duyarsız) değeri.
contentRating.author Kuruluş contentRating, Rating kullanıyorsa zorunludur: Derecelendirme kuruluşunun adı.
contentRating.ratingValue Metin contentRating, Rating kullanıyorsa zorunludur: Derecelendirmenin değeri.
contentRating.advisoryCode Metin İçeriğin uyarı kodu. Kabul edilen değerler arasında D, FV, L, S ve V bulunur. D = Diyalog, FV = Fantastik Şiddet, L = Dil, S = Cinsel İçerik, V = Şiddet.
popularityScore PopularityScoreSpecification Önemle Tavsiye Edilir Neden? Google'ın, kullanıcılar için hangi medyanın oynatılacağını belirlemek üzere kullandığı bir puan ve diğer sinyaller. Bu puan, içeriğin kataloğunuzdaki diğer içeriklere kıyasla popülerliğini gösterir. Bu nedenle, puanın ölçeği feed'lerinizde ve kataloğunuzdaki tüm öğeler arasında tutarlı olmalıdır. Varsayılan olarak, bir öğenin popülerlik puanı 0'a ayarlanır.
popularityScore.@type Metin Her zaman PopularityScoreSpecification olarak ayarlanır.
popularityScore.value Number Varlığın popülerliğini gösteren negatif olmayan sayısal değer. Puan ne kadar yüksekse popülerlik de o kadar yüksektir.
popularityScore.eligibleRegion Ülke Bu popülerlik puanının geçerli olduğu bölgeler. Popülerlik puanı genel olarak geçerliyse EARTH olarak ayarlayın. Bu özellik varsayılan olarak EARTH şeklinde ayarlanır.
Note: Yerele özgü popülerlik, küresel (DÜNYA) popülerliğe göre önceliklidir.
category Metin Geçerliyse zorunlu: Varlık bir Movie varyantıysa bu özelliği doldurun. category ayarını aşağıdakilerden herhangi birine getirin:
  • Home Release: Evde izlenmek üzere satılan veya kiralanan bir sürüm.
  • Theatrical Release: Sinemalarda yayınlanan bir sürüm.
  • International Release: Uluslararası olarak yayınlanmak üzere düzenlenmiş bir sürüm.
  • Remastered: Resimleri, sesi veya her ikisi de daha güncel bir standarda göre iyileştirilmiş sürüm.
  • Unrated: MPAA veya benzer bir kuruluş tarafından incelenmemiş bir sürüm.
  • Director Cut: Yönetmenin kendi onaylanmış düzenlemesini temsil eden bir sürüm.
  • Extended Cut: Sinemada gösterilen sürümden daha uzun bir sürüm.
workExample Film Filmin varyantlarını belirtir. Bu özelliği varyant sürümlerinin Movie öğelerinde değil, ana Movie öğesinde kullanın.
workExample.@id URL Movie varyantları için bu özellik, varyantı olan Movie öğesinin @id değerini sağlar.
workExample.@type Metin Zorunlu: Her zaman Movie olarak ayarlayın. Bu, birden fazla varyantı olan bir Movie için dizi olarak gösterilebilir.
workExample.@id URL Zorunlu: Movie varyantının @id.
workExample.name Metin Zorunlu: Movie varyantının adı.
workExample.category Metin Zorunlu: Belirli bir sürümün film varyantı türü. Kategoriyi aşağıdakilerden herhangi birine ayarlayın:
  • Home Release: Evde izlenmek üzere satılan veya kiralanan bir sürüm.
  • Theatrical Release: Sinemalarda yayınlanan bir sürüm.
  • International Release: Uluslararası olarak yayınlanmak üzere düzenlenmiş bir sürüm.
  • Remastered: Resimleri, sesi veya her ikisi de daha güncel bir standarda göre iyileştirilmiş sürüm.
  • Unrated: MPAA veya benzer bir kuruluş tarafından incelenmemiş bir sürüm.
  • Director Cut: Yönetmenin kendi onaylanmış düzenlemesini temsil eden bir sürüm.
  • Extended Cut: Sinemada gösterilen sürümden daha uzun bir sürüm.

Örnek

Ana film

Genişletilmiş versiyonu olan 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ş kesim varyantı

Ana filmin genişletilmiş versiyonu.

{
  "@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 mülklerle ilgili konular için aşağıdaki sayfalara göz atın: