Metadata

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 (Date)
  },
  "startYear": integer,
  "endYear": integer,
  "episodesAreUntitled": boolean,
  "keyword": [
    string
  ],
  "tmsId": string,
  "showCustomId": string,
  "showTitle": string,
  "seasonNumber": string,
  "episodeNumber": string,
  "writer": [
    string
  ],
  "actor": [
    string
  ],
  "director": [
    string
  ],
  "producer": [
    string
  ],
  "releaseDate": {
    object (Date)
  },
  "spokenLanguage": string,
  "subtitledLanguage": [
    string
  ],
  "isan": string,
  "eidr": string,
  "hfa": string,
  "ratings": [
    {
      object (Rating)
    }
  ],
  "broadcaster": [
    string
  ],
  "totalEpisodesExpected": integer,
  "contentType": string,
  "originalReleaseMedium": string
}
Alanlar
customId

string

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 (-), alt çizgiler (_), noktalar (.), "at" sembolleri (@) veya eğik çizgiler (/) içerebilir.

title

string

Öğ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:

  • Öğeleri göster
  • Bir programa bağlı bölüm öğeleri
  • YouTube'un Filmler kategorisinde gösterilen film öğeleri
  • Ses Değiştirme programına dahil edilen ses kayıtları
notes

string

Diğer meta veri alanlarından biriyle doğrudan eşleşmeyen ek bilgiler. Bu alanın maksimum uzunluğu 255 bayttır.

description

string

Öğ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[]

string

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, Soaps bir program için geçerli bir tür olabilir ancak film veya ses kaydı için geçerli olmayabilir.

  • Öğeleri göster
  • YouTube'un Filmler kategorisinde gösterilen film öğeleri
  • Ses Değiştirme programına dahil edilen ses kayıtları
isrc

string

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

string

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[]

string

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

string

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

string

Öğeyle ilişkili UPC (Evrensel Ürün Kodu).

album

string

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

string

Öğ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

string

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

string

Bu öğenin kategorisi.

copyrightDate

object (Date)

Bu öğenin telif hakkının belirlendiği tarih. *

startYear

integer (uint32 format)

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

integer (uint32 format)

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

boolean

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 true olarak ayarlanırsa YouTube, ilişkili bölümler için gösterilen başlığı optimize eder.

keyword[]

string

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

string

Öğenin TMS (Tribune Media Systems) kimliği.

showCustomId

string

Bir sezon veya bölüm öğesinin ilişkilendirildiği şov öğesinin customId. YouTube'daki Programlar kategorisinde gösterilen sezon ve bölüm varlıkları için gereklidir. Diğer varlık türleri için geçerli değildir. Bu alanın maksimum uzunluğu 64 bayttır ve alfanümerik karakterler, tire (-), alt çizgi (_), nokta (.), "at" sembolü (@) veya eğik çizgi (/) içerebilir.

showTitle

string

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

string

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

string

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[]

string

Öğeyle ilişkili yazarları tanımlayan bir liste. Bir öğe için en fazla 50 yazar belirtebilirsiniz.

actor[]

string

Öğeyle ilişkili aktörleri tanımlayan bir liste. Bir öğe için en fazla 50 aktör belirtebilirsiniz.

director[]

string

Öğeyle ilişkili yönetmenleri tanımlayan bir liste. Bir öğe için en fazla 50 yönetmen belirtebilirsiniz.

producer[]

string

Öğenin üreticilerini tanımlayan bir liste. Bir öğe için en fazla 50 yapımcı belirtebilirsiniz.

releaseDate

object (Date)

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:

  • Bir programa bağlı bölüm öğeleri
  • YouTube'un Filmler kategorisinde gösterilen film öğeleri
spokenLanguage

string

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[]

string

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

string

Öğ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.

  • Etiket değerindeki ilk 16 karakter, ISAN'nin "kök" ve "bölüm" bileşenlerini belirten on altılı karakterler içerir.
  • On yedinci karakter, kontrol karakteridir (A-Z arasındaki bir harf).
  • 18 - 25 arası karakterler ISAN'nin "sürüm" bileşenini belirten ISAN'nin kalan sekiz karakteridir.
  • Yirmi altıncı karakter başka bir kontrol karakteridir (A-Z).
eidr

string

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

string

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[]

object (Rating)

Bir öğenin aldığı puanların listesi. Derecelendirme, belirtilen derecelendirme sistemine göre geçerli olmalıdır.

broadcaster[]

string

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

integer (uint32 format)

Sezondaki toplam tam uzunluk bölüm sayısını belirtir. Bu değer yalnızca sezon öğeleri için kullanılır.

contentType

string

Öğ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:

  • Bir programa bağlı bölüm öğeleri
  • YouTube'un Filmler kategorisinde gösterilen film öğeleri

Kabul edilen değerler şunlardır:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

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:

  • Bir programa bağlı bölüm öğeleri
  • YouTube'un Filmler kategorisinde gösterilen film öğeleri

Kabul edilen değerler şunlardır:

  • basic_tv
  • direct_to_video
  • film
  • premium_tv
  • promotional
  • terrestrial_tv
  • web

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

integer (uint32 format)

Tarihin Gregoryen Takvimi'ndeki yılı. Miladi olarak kabul edilir.

month

integer (uint32 format)

Tarihin ayı. Değer, 1 ile 12 arasında bir tam sayı olmalıdır.

day

integer (uint32 format)

Tarihin günü. Değer, 1 ile 31 arasında bir tam sayı olmalıdır. Bazı gün-ay kombinasyonlarının geçerli olmadığını unutmayın.

Derecelendirme

Bu nesne, bir öğenin içerik derecelendirmesini içeriyor.

JSON gösterimi
{
  "ratingSystem": string,
  "rating": string
}
Alanlar
ratingSystem

string

Derecelendirmeyle ilişkili derecelendirme sistemi.

Kabul edilen değerler şunlardır:

  • acb
  • age_gate_16
  • bbfc
  • cbfc
  • chvrs
  • djctq
  • eirin
  • esrb
  • fmoc
  • fsk
  • icaa
  • kmrb
  • lyrics
  • mpaa
  • oflc
  • russia
  • v_chip
  • youtube
  • youtubeuk
rating

string

Öğenin aldığı puan.