Filmlerin içerik işaretleme özellikleri

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

Spesifikasyon tablosu

Özellik Beklenen Tür Açıklama
@context Metin Zorunlu: Her zaman ["http://schema.org", {"@language": "xx"}]
    olarak ayarlanır.
  • Yer" xx inç feed'deki dizelerin dilini temsil eder. Her kök varlık bağlamının @dil, BCP 47 biçiminde uygun dil koduna ayarlanmış olmalıdır. Örneğin, dil İspanyolcaya ayarlanırsa altyazı/dublaj dili İngilizce olsa bile adların İspanyolca olduğu varsayılır.
@type Metin Gerekli: Filmler için her zaman Movie olarak ayarlanır.
@id URL Gerekli - URI biçimindeki içeriğin tanımlayıcısı; örneğin, https://example.com/1234abc.
@id adresi aşağıdaki koşulları karşılamalıdır:
  • Kataloğunuz genelinde küresel olarak benzersiz
  • 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.
  • Birleştirilmiş Kaynak Tanımlayıcı (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 koşulları karşıladığı için varlığın url özelliğini @id olarak kullanmanızı öneririz. Daha fazla ayrıntı 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, genel 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 Gerekli - Filmin adı.
  • Adları farklı dillerde listelemek için dizi kullanın. Birden çok bölge ve dil örneğine bakın.
  • Her yerel ayar (dil-ülke çifti) başına yalnızca bir adın desteklendiğini unutmayın.
titleEIDR Metin Önemle Tavsiye Edilir Neden? - Bir film veya televizyon eseri olan, en genel/soyut düzeyde temsil eden bir EIDR (Eğlence Tanımlayıcı Kaydı) tanımlayıcısı.

Örneğin, "Hayalet Avcıları" adlı sinemanın başlık EIDR'sini kullanabilirsiniz. "10.5240/7EC7-228A-510A-053E-CBB8-J".
editEIDR Metin Önemle Tavsiye Edilir Neden? - Bir film veya televizyon eseri için belirli bir düzenlemeyi / sürümü temsil eden EIDR (Eğlence Tanımlayıcı Kaydı) tanımlayıcısı.

Örneğin, "Hayalet Avcıları" olarak bilinen sinema adlı kişinin EIDR'si "10.5240/7EC7-228A-510A-053E-CBB8-J" olan, çeşitli düzenlemeler içeriyor, ör. "10.5240/1F2A-E1C5-680A-14C6-E76B-I" ve "10.5240/8A35-3BEE-6497-5D12-9E4F-3". editEIDR sağlandığında

titleEIDR özelliği zorunludur.
potentialAction WatchAction Geçerliyse gerekli: İşlemin ayrıntılarını sağlayan bir İşlem işaretleme nesnesi.
  • İçerik, seç-izle videoda (VoD) kullanılabiliyorsa bu özellik zorunludur. İşlem işaretleme nesnesinin, içeriğin derin bağlantısını sağlaması gerekir.
  • İçerik bir LiveTV kanalında mevcutsa bu özellik isteğe bağlıdır; ilişkilendirilmiş BroadcastService varlığı, bunun yerine kanalın derin bağlantısını sağlar.
  • Movie, hem VoD'de hem de canlı TV'de kullanılabilir.
Birden çok bölgede farklı derin bağlantıları belirtmek için dizi kullanın. Birden çok bölge ve dil örneğine bakın.
sameAs URL Önemle Tavsiye Edilir Neden? Filmi tanımlayabilen bir referans web sayfasının URL'si; örneğin filmin Wikipedia sayfası. Bu, url özelliğinden farklı olmalıdır.
inLanguage Metin Filmin BCP 47 biçiminde 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. Bir anahtar kelime dizisine de izin verilir. Örneğin, ["özellik, biyografi"], içeriği açıklayan bir anahtar kelime dizisi olabilir.
releasedEvent PublicationEvent, FeaturedEvent veya ExclusiveEvent Önemle Tavsiye Edilir Neden? - PublicationEvent, bir filmin orijinal (dünya geneli veya yerel) yayını belirtmek için kullanılır.

Ayrıca hizmetinizin orijinal, öne çıkan, özel vb. olarak pazarlandığı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üme 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şkilendirilen bölgeler.

PublicationEvent için bu, içeriğin yayınlandığı yerdir.

FeaturedEvent ve ExclusiveEvent için bu, içeriğin öne çıkarıldığı veya özel olduğu yerdir.

Ü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 zorunlu: Varlığın yayın başlangıç tarihidir.

PublicationEvent için bu, varlığın ilk yayın tarihini (ör. bir filmin sinemalarda ilk kez yayınlandığı tarih) belirtir.

ExclusiveEvent ve FeaturedEvent için bu, varlığın özel olduğu veya öne çıkarıldığı başlangıç tarihini temsil eder.
releasedEvent.endDate Date veya DateTime Önerilir: ExclusiveEvent için gereklidir: 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 temsil eder.

FeaturedEvent için bu, sağlayıcının tüzel kişiyi öne çıkardığı son tarihi temsil eder.

İçerik daima münhasırsa veya öne çıkarılıyorsa endDate değerini geçerli 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 özeti, gerçeklere dayalı özetler yerine tercih edilir. 300 karakter sınırlaması.
duration Süre Filmin ISO 8601 biçiminde çalışma zamanı. Lütfen şu biçimi kullanın: "PT00H00M".
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 gereklidir - Film ile ilgili resimler. image ile eklenecek zorunlu ve isteğe bağlı özellikler hakkında daha fazla ayrıntı için Resim özellikleri konusuna bakın.
trailer.description Metin Fragmanın açıklaması. Fragman örneğine bakın.
trailer.inLanguage Metin Fragmanın BCP 47 biçiminde dili.
trailer.url URL Herkese açık olarak barındırılan ve ilgili üretim stüdyoları veya yetkili kaynaklar tarafından 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 Önemle Tavsiye Edilir Neden? - Bu varlığı açık bir şekilde tanımlayan harici veya diğer kimlik. Birden çok tanımlayıcıya izin verilir. Ayrıntılar için Tanımlayıcı özellikleri bölümüne bakın.
review Yorum Filme ilişkin yorum derecelendirmeleri
review.reviewRating Derecelendirme İnceleme yapılırsa zorunludur. Bu, yorumda verilen puanı belirtmek için kullanılır.
contentRating Metin veya Derecelendirme Yetişkinlere uygun içerikler için zorunlu, aksi takdirde kesinlikle önerilir Neden? - Genel içerik derecelendirmesi. İçerik derecelendirmesi bir metin dizesi biçiminde sağlanıyorsa iki varyasyon kabul edilir:
  • Derecelendirme kurumu, derecelendirmenin önüne bir boşluk eklemiştir. Örneğin, "PG-13" "MPAA" ajansının derecelendirmesi "MPAA PG-13" olarak tanımlanmalıdır. Ajans listesini inceleyin.
  • "RATING NOT KNOWN" değeri (büyük/küçük harfe duyarlı değil) gibi bir değer belirtir.
contentRating.author Text veya Organization contentRating, Rating kullanıyorsa gereklidir: Derecelendirme ajansının adı.
contentRating.ratingValue Metin contentRating, Rating kullanıyorsa gereklidir: Puan değeri.
contentRating.advisoryCode Metin İçerikle ilgili tavsiye kodu. Kabul edilen değerler şunlardır: D, FV, L, S ve V. D = Diyalog, GD = Fantezi Şiddet , L = Dil, S = Cinsel İçerik, V = Şiddet.
popularityScore PopularityScoreSpecification Önemle Tavsiye Edilir Neden? Kullanıcılar için oynatılacak medyayı belirlemek üzere Google'ın ve diğer sinyallerin kullandığı puandır. Bu puan, içeriğin kataloğunuzdaki diğer içeriklere kıyasla popülerliğini temsil eder. Bu nedenle, puan ölçeğinin feed'leriniz ve kataloğunuzdaki tüm öğeler arasında tutarlı olması gerekir. Varsayılan olarak, varlığın popülerlik puanı 0'a ayarlanır.
popularityScore.@type Metin Her zaman PopularityScoreSpecification seçeneğine ayarla.
popularityScore.value Number Varlığın popülerliğini gösteren, negatif olmayan, sayısal bir değer. 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 özgü popülerlik, dünya genelindeki (EARTH) popülerliğe göre önceliklidir
category Metin Geçerliyse zorunludur: Varlık bir Movie varyantıysa bu özelliği doldurun. category öğesini aşağıdakilerden herhangi birine ayarlayın:
  • Home Release: Evde görüntüleme için satılan veya kiralanan bir sürüm.
  • Theatrical Release: Sinemalarda yayınlanan bir sürüm.
  • International Release: Uluslararası olarak yayınlanacak şekilde düzenlenmiş sürüm.
  • Remastered: Resimleri, sesi veya her ikisi de daha güncel bir standarda uygun şekilde iyileştirilmiş bir sürüm.
  • Unrated: MPAA veya benzer bir ajans tarafından incelenmemiş bir sürüm.
  • Director Cut: Yöneticinin kendi onaylı düzenlemesini temsil eden sürüm.
  • Extended Cut: Sinemada yayından daha uzun bir sürüm.
workExample Film Filmin varyantlarını belirtir. Bu özelliği, varyant sürümleri için Movie varlıklarına değil, ana Movie öğesine ekleyin.
workExample.@id URL Movie varyantları için bu özellik, varyantın olduğu Movie öğesinin @id değerini sağlar.
workExample.@type Metin Zorunlu: Her zaman Movie değerine ayarlanır. Bu, birden çok varyantı olan bir Movie için dizi olarak temsil edilebilir.
workExample.@id URL Zorunlu: Movie varyantının @id öğesi.
workExample.name Metin Zorunlu: Movie varyantının adı.
workExample.category Metin Gerekli: Belirli bir versiyonun film varyantının türü. Kategoriyi aşağıdakilerden herhangi birine ayarlayın:
  • Home Release: Evde görüntüleme için satılan veya kiralanan bir sürüm.
  • Theatrical Release: Sinemalarda yayınlanan bir sürüm.
  • International Release: Uluslararası olarak yayınlanacak şekilde düzenlenmiş sürüm.
  • Remastered: Resimleri, sesi veya her ikisi de daha güncel bir standarda uygun şekilde iyileştirilmiş bir sürüm.
  • Unrated: MPAA veya benzer bir ajans tarafından incelenmemiş bir sürüm.
  • Director Cut: Yöneticinin kendi onaylı düzenlemesini temsil eden sürüm.
  • Extended Cut: Sinemada yayından daha uzun bir sürüm.

Örnek

Ana film

Genişletilmiş kesme varyantına sahip 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ş kesme 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 tesislerle ilgili konular için aşağıdaki sayfalara göz atın: