Filmlerin içerik işaretleme özellikleri

Bu bölümde, Movie varlık türüne ait içerik işaretleme özelliklerinin ayrıntıları sağlanmaktadır.

Spesifikasyon tablosu

Mülk Beklenen Tür Açıklama
@context Metin Zorunlu: Her zaman ["http://schema.org", {"@language": "xx"}]
değerine ayarlanır
  • Burada "xx", feed'deki dizelerin dilini temsil eder. Her kök öğe bağlamında @language, 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 değerine ayarlanır.
@id URL Zorunlu: İçeriğin URI biçimindeki tanımlayıcısıdır. Örneğin, https://example.com/1234abc.
@id aşağıdaki koşulları karşılamalıdır:
  • Kataloğunuzda dünya genelinde benzersiz olmalıdır.
  • Statik; Kimlik sabit olmalı ve zaman içinde değişmemelidir (programın URL özelliği değişse bile). Bu, opak bir dize olarak işlenir ve çalışan bir bağlantı olması gerekmez.
  • Tekdüzen 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, tanımlayıcı olarak tüm koşulları karşıladığı için @id olarak öğenin url değerini kullanmanızı öneririz. Daha fazla 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 işleminin derin bağlantısı için hedef nesnesinin urlTemplate mülküne 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 Yüksek Önerilen Neden? - Film veya televizyon eserini en genel/soyut düzeyde temsil eden bir EIDR (Eğlence Tanımlayıcıları Kaydı) tanımlayıcısı.

Örneğin, "Ghostbusters" olarak bilinen sinema filminin titleEIDR değeri "10.5240/7EC7-228A-510A-053E-CBB8-J" şeklindedir.
editEIDR Metin Yüksek Önerilen Neden? - Film veya televizyon eserinin belirli bir düzenlemesini / baskısını temsil eden bir EIDR (Eğlence Tanımlayıcı Kaydı) tanımlayıcısı.

Örneğin, "Ghostbusters" olarak bilinen ve titleEIDR değeri "10.5240/7EC7-228A-510A-053E-CBB8-J" olan 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ğlandığında

titleEIDR özelliği zorunludur.
potentialAction WatchAction Geçerliyse gereklidir: İş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 mevcutsa 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 seç-izle videolarda hem de canlı TV'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 Yüksek Önerilen Neden? Filmi tanımlayabilecek bir referans web sayfasının URL'si (ör. filmin Wikipedia sayfası). Bu, url mülkünden farklı olmalıdır.
inLanguage Metin Filmin orijinal dili BCP 47 biçiminde.
genre Metin İlgili tüm türlerin sıralı listesi. Örneğin : ["Aksiyon", "Moda", "Çevre", "Futbol"]
keywords Metin Bu içeriği tanımlamak için kullanılan anahtar kelimeler veya etiketler. Anahtar kelime dizisine de izin verilir. Örneğin, ["özellik, biyografi"] içeriği tanımlayan bir anahtar kelime dizisi olabilir.
releasedEvent PublicationEvent, FeaturedEvent veya ExclusiveEvent Yüksek Önerilen Neden? - PublicationEvent, bir yayıncının içeriğin orijinal (küresel veya yerel) yayın tarihini (ör. bir filmin sinemalarda ilk gösterim tarihi) belirtmek için kullanılır.

Ayrıca, hizmetinizin bu içeriği orijinal, öne çıkarılan, ö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 yayınlandığını belirtir.

Ayrıntılar ve örnekler için örnek bölümüne bakın.
releasedEvent.@type Metin Zorunlu: Bu özelliği her zaman aşağıdakilerden birine ayarlayın:
  • 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 Önerilen - ExclusiveEvent için zorunlu: Öğenin yayınlanma başlangıç tarihi.

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

ExclusiveEvent ve FeaturedEvent için bu, öğenin özel veya öne çıkarıldığı başlangıç tarihini gösterir.
releasedEvent.endDate Date veya DateTime Önerilen - ExclusiveEvent için zorunludur: Bu, yalnızca ExclusiveEvent ve FeaturedEvent türleri için geçerlidir.

ExclusiveEvent için bu, içeriğin 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 münhasır veya öne çıkarılmışsa endDate değerini geçerli tarihten itibaren 20 yıl olarak ayarlayın.
releasedEvent.publishedBy Organization veya Person İsteğe bağlı: Bu öğeyi yayınlayan kuruluş veya kişi.
description Metin Yüksek Önerilen Neden? Filmin özeti. Olay özetlerine, gerçeklere dayalı özetlere tercih edilir. 300 karakterle sınırlıdır.
duration Süre Filmin süresi ISO 8601 biçiminde. Lütfen şu biçimi kullanın: "PT00S00M".
director Person Yüksek Önerilen Neden? Filmin yönetmenleri.
actor Person Yüksek Önerilen Neden? Filmin oyuncu kadrosu.
producer Organization veya Person Yüksek Önerilen Neden? Filmin yapımcıları.
image ImageObject Google TV için gerekli: Filmle ilgili resimler. image ile birlikte eklenecek zorunlu ve isteğe bağlı özellikler hakkında daha fazla bilgi için Resim özellikleri bölümüne bakın.
trailer.description Metin Fragmanın açıklaması. Fragman örneğine bakın.
trailer.inLanguage Metin Fragmanın dili BCP 47 biçiminde.
trailer.url URL İlgili prodüksiyon stüdyoları veya yetkili kaynaklar tarafından herkese açık olarak barındırılan ve yüklenen bir 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 Yüksek Önerilen Neden? - Bu öğeyi 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 Filmin yorum puanları
review.reviewRating Derecelendirme İnceleme sağlanıyorsa zorunludur. Bu, yorumda verilen puanı belirtmek için kullanılır.
contentRating Text veya Rating Yetişkinlere uygun içerikler için gereklidir, aksi takdirde önemle tavsiye edilir Neden? - Genel içerik derecelendirmesi. İçerik derecelendirmesi metin dizesi şeklinde verilirse iki varyasyon kabul edilir:
  • Derecelendirme kuruluşu, derecelendirmenin önüne boşluk ekleyerek eklemiş. Örneğin, ABD'deki "MPAA" ajansından alınan "PG-13" derecelendirmesi "MPAA PG-13" olarak açıklanmalıdır. Ajansların listesini inceleyin.
  • Filmin derecelendirmesini bilmediğinizi belirtmek için "DERECELENDİRME BİLİNMEDİ" değerini (büyük/küçük harfe duyarlı değildir) girin.
contentRating.author Kuruluş contentRating, Rating kullanıyorsa gereklidir: Derecelendirme kuruluşunun adı.
contentRating.ratingValue Metin contentRating, Rating kullanıyorsa gereklidir: Derecelendirmenin değeri.
contentRating.advisoryCode Metin İçeriğin uyarı kodu. Kabul edilen değerler D, FV, L, S ve V'dir. D = Diyalog, FV = Fantezi Şiddet, L = Dil, S = Cinsel İçerik, V = Şiddet.
popularityScore PopularityScoreSpecification Yüksek Önerilen Neden? Google'ın, kullanıcılara hangi medyanın oynatılacağını belirlemek için diğer sinyallerle birlikte kullandığı bir puan. Bu puan, içeriğin katalogunuzdaki diğer içeriklere göre popülerliğini gösterir. Bu nedenle, puanın ölçeği feed'lerinizde ve katalogunuzdaki tüm öğeler arasında tutarlı olmalıdır. Varsayılan olarak, bir öğenin popülerlik puanı 0 olarak ayarlanır.
popularityScore.@type Metin Her zaman PopularityScoreSpecification olarak ayarlanır.
popularityScore.value Number Öğenin popülerliğini gösteren, sıfırdan büyük bir sayısal değerdir. 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ı dünya genelinde geçerliyse EARTH olarak ayarlayın. Bu özellik varsayılan olarak EARTH olarak ayarlanmıştır.
Note: Yerel dili temel alan popülerlik, küresel (DÜNYA) popülerlikten önceliklidir
category Metin Varsa zorunludur: Varlık bir Movie varyantıysa bu özelliği doldurun. category değerini aşağıdakilerden birine ayarlayın:
  • Home Release: Evde izlemek için satılan veya kiralanan bir sürüm.
  • Theatrical Release: Sinemalarda yayınlanan sürüm.
  • International Release: Uluslararası olarak yayınlanmak üzere düzenlenmiş bir sürüm.
  • Remastered: Resimlerinin, sesinin veya her ikisinin de daha güncel bir standarta göre iyileştirilmesini sağlayan bir sürüm.
  • Unrated: MPAA veya benzer bir ajans tarafından incelenmeyen bir sürüm.
  • Director Cut: Yönetmenin onayladığı düzenlemeyi temsil eden bir sürüm.
  • Extended Cut: Sinemalarda gösterilen filmden daha uzun bir sürüm.
workExample Film Filmin varyantlarını belirtir. Bu özelliği, varyant sürümlerinin Movie öğelerine değil, ana Movie öğesine ekleyin.
workExample.@id URL Movie varyantları için bu özellik, varyantı olduğu Movie öğesinin @id değerini sağlar.
workExample.@type Metin Zorunlu: Her zaman Movie olarak ayarlanır. Bu, birden fazla varyant içeren bir Movie için dizi olarak temsil edilebilir.
workExample.@id URL Zorunlu: Movie varyantının @id değeri.
workExample.name Metin Zorunlu: Movie varyantının adı.
workExample.category Metin Zorunlu: Belirli bir sürümün film varyantının türü. Kategoriyi aşağıdakilerden birine ayarlayın:
  • Home Release: Evde izlemek için satılan veya kiralanan bir sürüm.
  • Theatrical Release: Sinemalarda yayınlanan sürüm.
  • International Release: Uluslararası olarak yayınlanmak üzere düzenlenmiş bir sürüm.
  • Remastered: Resimlerinin, sesinin veya her ikisinin de daha güncel bir standarta göre iyileştirilmesini sağlayan bir sürüm.
  • Unrated: MPAA veya benzer bir ajans tarafından incelenmeyen bir sürüm.
  • Director Cut: Yönetmenin onayladığı düzenlemeyi temsil eden bir sürüm.
  • Extended Cut: Sinemalarda gösterilen filmden daha uzun bir sürüm.

Örnek

Ana film

Genişletilmiş kurgusu 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ş kesit varyantı

Ana filmin uzatılmış 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: