Bir öğenin meta verileri. Bazı meta veri alanları yalnızca belirli öğe türleri için geçerlidir.
| JSON gösterimi |
|---|
{ "customId": string, "title": string, "notes": string, "description": string, "genre": [ string ], "isrc": string, "grid": string, "artist": [ string ], "label": string, "upc": string, "album": string, "infoUrl": string, "iswc": string, "category": string, "copyrightDate": { object ( |
| Alanlar | |
|---|---|
customId |
Meta veri sağlayıcı olarak sizin bir öğeyi tanımlamak için kullandığınız benzersiz değer. Değer, öğe için oluşturduğunuz benzersiz bir kimlik veya standart bir tanımlayıcı (ör. ISRC) olabilir. Değerin maksimum uzunluğu 64 bayttır ve alfanümerik karakterler, tireler ( |
title |
Öğenin başlığı veya adı. Değerin maksimum uzunluğu 255 bayttır. Bu değer, aşağıda listelenen öğeler için zorunlu, diğer tüm öğeler için isteğe bağlıdır:
|
notes |
Diğer meta veri alanlarından biriyle doğrudan eşleşmeyen ek bilgiler. Bu alanın maksimum uzunluğu 255 bayttır. |
description |
Öğenin açıklaması. Açıklama YouTube'da veya İçerik Yönetim Sistemi'nde gösterilebilir. Bu alanın maksimum uzunluğu 5000 bayttır. |
genre[] |
Bu alan, bir öğeyi sınıflandırmak için kullanılabilecek bir türü belirtir. Öğeler birden fazla türe göre kategorize edilebilir ve YouTube, farklı türdeki öğeleri kategorize etmek için farklı tür grupları kullanır. Örneğin,
|
isrc |
Müzik videosu veya ses kaydı öğesinin ISRC'si (Uluslararası Standart Kayıt Kodu). Bu alanın değeri tam olarak 12 alfanumerik karakter içermelidir. |
grid |
Bir müzik videosunun veya ses kaydının GRID'si (Genel Yayın Tanımlayıcısı). Bu alanın değeri tam olarak 18 alfanumerik karakter içermelidir. |
artist[] |
Müzik videosu veya ses kaydı öğesiyle ilişkili sanatçı. Bu alan yalnızca müzik videosu ve ses kaydı öğeleri için geçerlidir. Ses Değiştirme programında yer alan ses kayıtları için gereklidir. |
label |
Ses kaydı öğesini yayınlayan plak şirketi. Bu alan yalnızca ses kaydı öğeleri için geçerlidir ve maksimum uzunluğu 255 bayttır. |
upc |
Öğeyle ilişkili UPC (Evrensel Ürün Kodu). |
album |
Ses kaydı öğesinin yer aldığı albüm. Bu alan yalnızca ses kaydı öğeleri için geçerlidir ve maksimum uzunluğu 255 bayttır. |
infoUrl |
Öğeyle ilişkilendirilmiş resmi bir URL. Bu alanın maksimum uzunluğu 1536 bayttır. Lütfen 1.537 baytlık bir URL göndermeyin. Çabalarınız boşa gider. |
iswc |
Bir beste öğesinin ISWC'si (Uluslararası Standart Müzik Eseri Kodu). Alanın değeri, ardından 10 rakam gelen bir harf (T) biçiminde tam olarak 11 karakter içermelidir. |
category |
Bu öğenin kategorisi. |
copyrightDate |
Bu öğenin telif hakkının belirlendiği tarih. * |
startYear |
Bir televizyon programının yayınlandığı ilk yıl. Bu değer, gösterim öğeleri için gereklidir ve yalnızca bu amaçla kullanılır. |
endYear |
Bir TV programının yayınlandığı son yıl. Bu değer yalnızca gösterim öğeleri için kullanılır ve bu öğelerde isteğe bağlıdır. Yeni bölümler oluşturulmaya devam ediyorsa değer belirtmeyin. |
episodesAreUntitled |
Bu değer, belirli bir şov öğesi veya belirli bir sezon öğesiyle ilişkili bölümlerin başlığının olmadığını gösterir. Başlıksız bir programda (veya sezonda) bölümler, bölüm numarası ya da tarihlerine göre tanımlanır. Bu alan |
keyword[] |
Bir gösterim öğesiyle ilişkili en fazla 100 anahtar kelimenin listesi. Bu alan, gösterim öğeleri için gereklidir ve yalnızca bu amaçla kullanılır. |
tmsId |
Öğenin TMS (Tribune Media Systems) kimliği. |
showCustomId |
Bir sezon veya bölüm öğesinin ilişkilendirildiği şov öğesinin |
showTitle |
Bir bölüm öğesinin ilişkilendirildiği şovun adı. Not: Bu etiket yalnızca şov öğeleriyle ilişkilendirilmemiş bölümler için kullanılır ve geçerlidir. Bu bölümlerin, İYS'nin öğe meta verileri bölümünde şov başlığı göstermesini sağlar. Bu alanın maksimum uzunluğu 120 bayttır. |
seasonNumber |
Sezon öğesini tanımlayan sezon numarası veya bölüm öğesiyle ilişkili sezon numarası. Bu alanın maksimum uzunluğu 5 bayttır. |
episodeNumber |
Bir bölüm öğesiyle ilişkili bölüm numarası. Bu alan, yalnızca program öğelerine bağlı bölüm öğeleri için gereklidir ve yalnızca bu öğeler için kullanılır. En fazla 5 bayt uzunluğundadır. |
writer[] |
Öğeyle ilişkili yazarları tanımlayan bir liste. Bir öğe için en fazla 50 yazar belirtebilirsiniz. |
actor[] |
Öğeyle ilişkili aktörleri tanımlayan bir liste. Bir öğe için en fazla 50 aktör belirtebilirsiniz. |
director[] |
Öğeyle ilişkili yönetmenleri tanımlayan bir liste. Bir öğe için en fazla 50 yönetmen belirtebilirsiniz. |
producer[] |
Öğenin üreticilerini tanımlayan bir liste. Bir öğe için en fazla 50 yapımcı belirtebilirsiniz. |
releaseDate |
Bir öğenin herkese açık olarak yayınlandığı tarih. Sezon öğeleri için bu değer, sezonun yayınlandığı ilk tarihi belirtir. 1902 yılından önceki tarihler desteklenmez. Bu değer; bölüm, sezon, film, müzik videosu ve ses kaydı öğeleri için geçerlidir. Aşağıda listelenen öğeler için gereklidir, aksi takdirde isteğe bağlıdır:
|
spokenLanguage |
Videoda konuşulan birincil dildir. Değer, herhangi bir ISO 639-1 iki harfli dil kodu olabilir. Bu değer yalnızca bölüm ve film öğeleri için kullanılır ve diğer öğe türleri için geçerli değildir. |
subtitledLanguage[] |
Videonun ayrı bir altyazı dosyasına veya videonun bir parçası olan yanmış altyazılara sahip olduğu dillerin listesi. Listedeki her değer ISO 639-1 iki harfli dil kodu olmalıdır. Bu değer yalnızca bölüm ve film öğeleri için kullanılır ve diğer öğe türleri için geçerli değildir. |
isan |
Öğenin ISAN'ı (Uluslararası Standart Görsel İşitsel Numarası). Bu değer yalnızca bölüm ve film öğeleri için kullanılır ve her iki durumda da isteğe bağlıdır. Bu değer, ISAN'nin 24 on altılı karakterini içeren 26 karakter ve aşağıdaki biçimde iki kontrol karakteri içerir.
|
eidr |
Bir öğeye atanan Eğlence Tanımlayıcı Kaydı (EIDR). Bu değer yalnızca bölüm ve film öğeleri için kullanılır ve her iki durumda da isteğe bağlıdır. Bu değer, EIDR kaydı için standart bir ön ek içerir, ardından sağa doğru bir taksim işareti, 20 karakterlik on altılı bir dizi ve bir alfanumerik (0-9A-Z) kontrol karakteri gelir. |
hfa |
Bir kompozisyonu benzersiz şekilde tanımlamak için verilen altı karakterlik Harry Fox Agency (HFA) şarkı kodu. Bu değer yalnızca beste paylaşımı öğeleri için geçerlidir. |
ratings[] |
Bir öğenin aldığı puanların listesi. Derecelendirme, belirtilen derecelendirme sistemine göre geçerli olmalıdır. |
broadcaster[] |
Bir programı veya programın bir sezonunu ilk yayınlayan ağı ya da kanalı tanımlar. Bu alan yalnızca, öğeyle ilişkili yayıncı, öğeyi YouTube'a yükleyen iş ortağından farklıysa öğe için eklenmelidir. Bir programın birden fazla yayıncısı olabileceğini unutmayın. Örneğin, bir program sezonlar arasında ağ değiştirebilir. |
totalEpisodesExpected |
Sezondaki toplam tam uzunluk bölüm sayısını belirtir. Bu değer yalnızca sezon öğeleri için kullanılır. |
contentType |
Öğenin temsil ettiği video içeriğinin türü. Bu alan yalnızca film ve bölüm öğeleri için geçerlidir ve bu öğelerin aşağıdaki türleri için gereklidir:
Kabul edilen değerler şunlardır:
|
originalReleaseMedium |
Kullanıcıların bir video öğesini ilk kez görme fırsatı bulduğu yöntem. Bu değer yalnızca bölüm ve film öğeleri için kullanılır. Aşağıdaki öğeler için gereklidir, aksi takdirde isteğe bağlıdır:
Kabul edilen değerler şunlardır:
|
Tarih
Bu kaynak, bileşen parçaları (yıl, ay, gün) olarak gösterilen bir tarihi tanımlar.
| JSON gösterimi |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Alanlar | |
|---|---|
year |
Tarihin Gregoryen Takvimi'ndeki yılı. Miladi olarak kabul edilir. |
month |
Tarihin ayı. Değer, |
day |
Tarihin günü. Değer, |
Derecelendirme
Bu nesne, bir öğenin içerik derecelendirmesini içeriyor.
| JSON gösterimi |
|---|
{ "ratingSystem": string, "rating": string } |
| Alanlar | |
|---|---|
ratingSystem |
Derecelendirmeyle ilişkili derecelendirme sistemi. Kabul edilen değerler şunlardır:
|
rating |
Öğenin aldığı puan. |