Videos

28 Temmuz 2020'den sonra oluşturulan doğrulanmamış API projelerinden videos.insert uç noktası aracılığıyla yüklenen tüm videolar, gizli görüntüleme moduyla kısıtlanacaktır. Bu kısıtlamayı kaldırmak için her API projesinin Hizmet Şartları'na uygunluğu doğrulamak amacıyla bir denetimden geçmesi gerekir. Daha fazla bilgi için lütfen API Düzeltme Geçmişi'ni inceleyin.

video kaynağı, bir YouTube videosunu temsil eder.

Yöntemler

API, videos kaynakları için aşağıdaki yöntemleri destekler:

getRating
Yetkili kullanıcının belirtilen videolardan oluşan bir listeye verdiği derecelendirmeleri alır. Hemen deneyin.
list
API isteği parametreleriyle eşleşen videoların listesini döndürür. Hemen deneyin.
ekle
YouTube'a video yükler ve isteğe bağlı olarak videonun meta verilerini ayarlar.
güncelle
Videonun meta verilerini günceller. Hemen deneyin.
sil
YouTube videosunu siler. Hemen deneyin.
oran
Bir videoya beğenme veya beğenmeme puanı ekleyin ya da videonun puanını kaldırın. Hemen deneyin.
raporAbuse
Kötüye kullanım amaçlı içerik barındıran bir videoyu bildirin. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, bir videos kaynağının biçimini gösterir:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Özellikler

Aşağıdaki tabloda bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
kind string
API kaynağının türünü tanımlar. Değer youtube#video olacak.
etag etag
Bu kaynağın Etag'i.
id string
YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet object
snippet nesnesi, videonun başlığı, açıklaması ve kategorisi gibi temel ayrıntılarını içerir.
snippet.publishedAt datetime
Videonun yayınlandığı tarih ve saat. Bu sürenin, videonun yüklendiği zamandan farklı olabileceğini unutmayın. Örneğin, bir video gizli video olarak yüklenir ve daha sonra herkese açık hâle getirilirse bu özellik, videonun herkese açık hale getirildiği zamanı belirtir.

Birkaç özel durum söz konusudur:
  • Bir video gizli video olarak yüklenirse ve video meta verileri kanal sahibi tarafından alınırsa, özellik değeri videonun yüklendiği tarih ve saati belirtir.
  • Bir video liste dışı video olarak yüklenirse mülk değeri, videonun yüklendiği tarih ve saati de belirtir. Bu durumda, videonun benzersiz video kimliğini bilen herkes video meta verilerini alabilir.
Değer ISO 8601 biçiminde belirtilir.
snippet.channelId string
YouTube'un, videonun yüklendiği kanalı benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet.title string
Videonun başlığı. Mülk değerinin maksimum uzunluğu 100 karakterdir ve < ve > hariç geçerli tüm UTF-8 karakterlerini içerebilir. videos.update yöntemini çağırıyor ve bir video kaynağının snippet bölümünü güncelliyorsanız bu mülk için bir değer belirlemeniz gerekir.
snippet.description string
Video açıklaması. Mülk değerinin maksimum uzunluğu 5.000 bayttır ve < ile > dışındaki geçerli tüm UTF-8 karakterlerini içerebilir.
snippet.thumbnails object
Videoyla ilişkili küçük resimlerin haritası. Haritadaki her bir nesne için anahtar, küçük resmin adıdır ve değer, küçük resimle ilgili diğer bilgileri içeren bir nesnedir.
snippet.thumbnails.(key) object
Geçerli anahtar değerleri şunlardır:
  • default – Varsayılan küçük resim. Bir videonun varsayılan küçük resmi (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya atıfta bulunan bir kaynak) 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Kanalların varsayılan küçük resmi 88 piksel genişliğinde ve 88 piksel uzunluğundadır.
  • medium: Küçük resmin daha yüksek çözünürlüklü sürümüdür. Bir video (veya videoya atıfta bulunan bir kaynak) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanal söz konusu olduğunda bu resim 240 piksel genişliğinde ve 240 piksel yüksekliğindedir.
  • high: Küçük resmin yüksek çözünürlüklü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanallarda bu resmin genişliği 800 piksel ve yüksekliği 800 pikseldir.
  • standard – Küçük resmin high çözünürlüklü resimden daha da yüksek çözünürlüklü sürümü. Bu resim, oynatma listesi öğeleri veya arama sonuçları gibi videolara atıfta bulunan bazı videolarda ve diğer kaynaklarda kullanılabilir. Bu resim 640 piksel genişliğinde ve 480 piksel yüksekliğinde.
  • maxres: Küçük resmin en yüksek çözünürlüklü sürümüdür. Bu resim boyutu, oynatma listesi öğeleri veya arama sonuçları gibi videolara atıfta bulunan bazı videolarda ve diğer kaynaklarda kullanılabilir. Bu resim 1.280 piksel genişliğinde ve 720 piksel yüksekliğinde.
snippet.thumbnails.(key).url string
Resmin URL'si.
snippet.thumbnails.(key).width unsigned integer
Resmin genişliği.
snippet.thumbnails.(key).height unsigned integer
Resmin yüksekliği.
snippet.channelTitle string
Videonun ait olduğu kanalın başlığı.
snippet.tags[] list
Videoyla ilişkili anahtar kelime etiketlerinin listesi. Etiketler boşluk içerebilir. Özellik değerinin maksimum uzunluğu 500 karakterdir. Karakter sınırının hesaplanma şekliyle ilgili aşağıdaki kurallara dikkat edin:
  • Özellik değeri bir listedir ve listedeki öğeler arasında bulunan virgüller sınıra dahil edilir.
  • Etikette boşluk varsa API sunucusu etiket değerini tırnak içine alınmış gibi işler ve tırnak işaretleri karakter sınırına dahil edilir. Dolayısıyla, karakter sınırlamaları için Foo-Baz etiketi yedi karakter içerirken Foo Baz etiketi dokuz karakter içerir.
snippet.categoryId string
Videoyla ilişkili YouTube video kategorisi. videos.update yöntemini çağırıyor ve bir video kaynağının snippet bölümünü güncelliyorsanız bu özellik için bir değer belirlemeniz gerekir.
snippet.liveBroadcastContent string
Videonun yaklaşan/etkin bir canlı yayın olup olmadığını gösterir. Video, yaklaşan/etkin bir canlı yayın değilse bu değer "yok" olur.

Bu mülk için geçerli değerler şunlardır:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
video kaynağının snippet.title ve snippet.description özelliklerindeki metnin dili.
snippet.localized object
snippet.localized nesnesi, video için yerelleştirilmiş bir başlık ve açıklama ya da videonun meta verileri için varsayılan dilde başlık içerir.
  • videos.list isteği, yerelleştirilmiş metnin döndürülmesi gereken bir dili belirtmek için hl parametresini kullandıysa ve yerelleştirilmiş metin bu dilde mevcutsa, yerelleştirilmiş metin kaynak snippet'inde döndürülür.
  • hl parametre değeri belirtilmemişse veya bir değer belirtilmişse ancak belirtilen dil için yerelleştirilmiş meta veriler kullanılamıyorsa varsayılan dile ilişkin meta veriler döndürülür.
Özellik salt okunur bir değer içeriyor. Yerelleştirilmiş başlıklar eklemek, güncellemek veya silmek için localizations nesnesini kullanın.
snippet.localized.title string
Yerelleştirilmiş video başlığı.
snippet.localized.description string
Yerelleştirilmiş video açıklaması.
snippet.defaultAudioLanguage string
default_audio_language özelliği, videonun varsayılan ses parçasında konuşulan dili belirtir.
contentDetails object
contentDetails nesnesi, videonun uzunluğu ve video için altyazı olup olmadığını belirten bir gösterge de dahil olmak üzere video içeriği hakkında bilgiler içerir.
contentDetails.duration string
Videonun uzunluğu. Özellik değeri bir ISO 8601 süresidir. Örneğin, en az bir dakika uzunluğundaki ve bir saatten kısa bir videonun süresi PT#M#S biçimindedir. Burada PT harfleri değerin bir süreyi belirttiğini, M ve S harfleri de dakika ve saniye cinsinden uzunluğu belirtir. M ve S harflerinden önceki # karakterleri, videonun dakika sayısını (veya saniyeyi) belirten tam sayılardır. Örneğin, PT15M33S değeri videonun 15 dakika 33 saniye uzunluğunda olduğunu ifade eder.

Video en az bir saat uzunluğundaysa süre PT#H#M#S biçimindedir. Burada, H harfinden önce gelen #, videonun uzunluğunu saat cinsinden belirtir ve diğer tüm ayrıntılar yukarıda açıklananlarla aynıdır. Video en az bir gün uzunluğundaysa P ve T harfleri birbirinden ayrılır ve değerin biçimi P#DT#H#M#S olur. Tüm ayrıntılar için lütfen ISO 8601 spesifikasyonuna bakın.
contentDetails.dimension string
Videonun 3D olarak mı yoksa 2D olarak mı sunulduğunu belirtir.
contentDetails.definition string
Videonun yüksek çözünürlükte mi (HD) yoksa yalnızca standart çözünürlükte mi kullanılabildiğini belirtir.

Bu özellik için geçerli değerler şunlardır:
  • hd
  • sd
contentDetails.caption string
Videoda altyazı olup olmadığını gösterir.

Bu mülk için geçerli değerler şunlardır:
  • false
  • true
contentDetails.licensedContent boolean
Videonun lisanslı içeriği temsil edip etmediğini belirtir. Bu, içeriğin bir YouTube içerik iş ortağına bağlı bir kanala yüklendiği ve ardından söz konusu iş ortağı tarafından hak talebinde bulunduğu anlamına gelir.
contentDetails.regionRestriction object
regionRestriction nesnesi, bir videonun görüntülenebilir olduğu (veya olmadığı) ülkelerle ilgili bilgileri içerir. Nesne, contentDetails.regionRestriction.allowed özelliğini veya contentDetails.regionRestriction.blocked özelliğini içerir.
contentDetails.regionRestriction.allowed[] list
Videonun izlenebileceği ülkeleri tanımlayan bölge kodlarının listesi. Bu mülk mevcutsa ve bir ülke kendi değerinde listelenmiyorsa videonun bu ülkede gösterilmesi engellenir. Bu mülk mevcutsa ve boş bir liste içeriyorsa video tüm ülkelerde engellenir.
contentDetails.regionRestriction.blocked[] list
Videonun engellendiği ülkeleri tanımlayan bölge kodlarının listesi. Bu mülk mevcutsa ve bir ülke kendi değerinde listelenmiyorsa video bu ülkede görüntülenebilir. Bu mülk mevcutsa ve boş bir liste içeriyorsa video tüm ülkelerde görüntülenebilir.
contentDetails.contentRating object
Videonun çeşitli derecelendirme düzenlerinde aldığı derecelendirmeleri belirtir.
contentDetails.contentRating.acbRating string
Videonun Avustralya Sınıflandırma Kurulu (ACB) veya Avustralya İletişim ve Medya Kurumu (ACMA) derecelendirmesi. ACMA derecelendirmeleri, çocuklara yönelik televizyon programlarını sınıflandırmak için kullanılır.

Bu özellik için geçerli değerler şunlardır:
  • acbC – Avustralya İletişim ve Medya Kurumu tarafından C sınıflandırması atanan programlar. Bu programlar 14 yaşından küçük çocuklara (okul öncesi çağdaki çocuklar dışında) yöneliktir.
  • acbE-D
  • acbG-G
  • acbM-M
  • acbMa15plus - MA15+
  • acbP – Avustralya İletişim ve Medya Kurumu tarafından P sınıflandırması atanan programlar. Bu programlar okul öncesi çağdaki çocuklara yöneliktir.
  • acbPg-PG
  • acbR18plus - R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Videonun İtalya'daki Autorità per le Garanzie nelle Comunicazioni (AGCOM) kuruluşundan aldığı derecelendirmesi aşağıda verilmiştir.

Bu tesis için geçerli değerler şunlardır:
  • agcomT-T
  • agcomUnrated
  • agcomVm14 - VM14
  • agcomVm18 - VM18
contentDetails.contentRating.anatelRating string
Videonun Şili televizyonu için Anatel (Asociación Nacional de Televisión) puanı.

Bu tesis için geçerli değerler şunlardır:
  • anatelA - A
  • anatelF-F
  • anatelI - I
  • anatelI10 - I-10
  • anatelI12 - I-12
  • anatelI7 - I-7
  • anatelR - Sağ
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Videonun İngiliz Film Sınıflandırma Kurulu (BBFC) derecelendirmesi.

Bu mülk için geçerli değerler şunlardır:
  • bbfc12 - 12
  • bbfc12a-12 A
  • bbfc15 - 15
  • bbfc18 - 18
  • bbfcPg-PG
  • bbfcR18 - R18
  • bbfcU - U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Videonun derecelendirmesi Tayland Film ve Video Sansürleri Kurulu'ndan alındı.

Bu mülk için geçerli değerler şunlardır:
  • bfvc13 - 13
  • bfvc15 - 15
  • bfvc18 - 18
  • bfvc20 - 20
  • bfvcB - B
  • bfvcE-D
  • bfvcG-G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
Video, Avusturya Medya Sınıflandırma Kurulu'ndan (Bundesministerium für Unterricht, Kunst und Kultur) derecelendirmesi almıştır.

Bu mülk için geçerli değerler şunlardır:
  • bmukk10 - 10+
  • bmukk12 - 12+
  • bmukk14 - 14+
  • bmukk16 - 16 yaş ve üzeri
  • bmukk6 - 6+
  • bmukk8 - 8+
  • bmukkAa - Kısıtlanmamış
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Kanada TV'leri için derecelendirme sistemi - Kanada TV Sınıflandırma Sistemi Videonun, Kanada'daki İngilizce yayınlar için Kanada Radyo-Televizyon ve Telekomünikasyon Komisyonu'ndan (CRTC) aldığı derecelendirme. Daha fazla bilgi için Kanada Yayın Standartları Konseyi web sitesine bakın.

Bu mülk için geçerli değerler şunlardır:
  • catv14plus - 14+
  • catv18plus - 18 yaş ve üzeri
  • catvC-C
  • catvC8 - C8
  • catvG-G
  • catvPg-PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Videonun, Kanada Fransızcası yayınlar için Kanada Radyo-Televizyon ve Telekomünikasyon Komisyonu'nun (CRTC) derecelendirmesi. Daha fazla bilgi için Kanada Yayın Standartları Konseyi web sitesine bakın.

Bu mülk için geçerli değerler şunlardır:
  • catvfr13plus - 13 yaş ve üzeri
  • catvfr16plus - 16 yaş ve üzeri
  • catvfr18plus - 18 yaş ve üzeri
  • catvfr8plus - 8+
  • catvfrG-G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Videonun Merkez Film Sertifikasyonu Kurulu (CBFC - Hindistan) puanı.

Bu tesis için geçerli değerler şunlardır:
  • cbfcA - A
  • cbfcS - G
  • cbfcU - U
  • cbfcUnrated
  • cbfcUA - ABD
  • cbfcUA7plus - ABD
  • cbfcUA13plus - ABD
  • cbfcUA16plus - ABD
contentDetails.contentRating.cccRating string
Videonun Consejo de Calificación Cinematográfica (Şili) puanı.

Bu tesis için geçerli değerler şunlardır:
  • ccc14 - 14+
  • ccc18 - 18 yaş ve üzeri
  • ccc18s – 18+ - pornografik içerik
  • ccc18v – 18+ - contenido excesivamente şiddeto
  • ccc6 - 6+ - Inconveniente para menores de 7 años
  • cccTe - Yapılacaklar uzmanı
  • cccUnrated
contentDetails.contentRating.cceRating string
Videonun Portekiz'deki Comissão de Classificação de Espect cateculos derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • cceM12 - 12
  • cceM14 - 14
  • cceM16-16
  • cceM18 - 18
  • cceM4 - 4
  • cceM6 - 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
Videonun İsviçre'deki derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • chfilm0 - 0
  • chfilm12 - 12
  • chfilm16-16
  • chfilm18 - 18
  • chfilm6 - 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Videonun Kanada Ev Videosu Derecelendirme Sistemi (CHVRS) derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • chvrs14a - 14 A
  • chvrs18a - 18 A
  • chvrsE-D
  • chvrsG-G
  • chvrsPg-PG
  • chvrsR - Sağ
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Videonun derecelendirmesi: Commission de Contrôle des Films (Belçika).

Bu tesis için geçerli değerler şunlardır:
  • cicfE-D
  • cicfKntEna - KNT/ENA
  • cicfKtEa - KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
Videonun puanı Romanya CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) tarafından sağlanmaktadır.

Bu tesis için geçerli değerler şunlardır:
  • cna12 - 12
  • cna15 - 15
  • cna18 - 18
  • cna18plus - 18 yaş ve üzeri
  • cnaAp - AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Fransa'da derecelendirme sistemi - Commission deClassification sinematographique

Bu tesis için geçerli değerler şunlardır:
  • cnc10 - 10
  • cnc12 - 12
  • cnc16-16
  • cnc18 - 18
  • cncE-D
  • cncT-T
  • cncUnrated
contentDetails.contentRating.csaRating string
Video için Fransa'daki Conseil supérieur de l?audiovisuel tarafından verilen ve yayın içeriği derecelendiren derecelendirme.

Bu tesis için geçerli değerler şunlardır:
  • csa10 - 10
  • csa12 - 12
  • csa16-16
  • csa18 - 18
  • csaInterdiction – Kısıtlama
  • csaT-T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Videonun, Lüksemburg Komisyonu'ndaki surveillance de la sınıflandırma des film (CSCF) kurumundaki derecelendirmesi aşağıda belirtilmiştir.

Bu tesis için geçerli değerler şunlardır:
  • cscf12 - 12
  • cscf16-16
  • cscf18 - 18
  • cscf6 - 6
  • cscf9-9
  • cscfA - A
  • cscfAl - AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
Videonun Çek Cumhuriyeti'ndeki puanı.

Bu tesis için geçerli değerler şunlardır:
  • czfilm12 - 12
  • czfilm14 - 14
  • czfilm18 - 18
  • czfilmU - U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Videonun Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brezilya) derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • djctq10 - 10
  • djctq12 - 12
  • djctq14 - 14
  • djctq16-16
  • djctq18 - 18
  • djctqL-L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Videonun neden DJCQT (Brezilya) derecelendirmesi aldığını açıklayan nedenler.
contentDetails.contentRating.ecbmctRating string
Türkiye'de derecelendirme sistemi - Kültür ve Turizm Bakanlığı Değerlendirme ve Sınıflandırma Kurulu

Bu mülk için geçerli değerler şunlardır:
  • ecbmct13a-13 A
  • ecbmct13plus - 13 yaş ve üzeri
  • ecbmct15a-15 A
  • ecbmct15plus - 15 yaş ve üzeri
  • ecbmct18plus - 18 yaş ve üzeri
  • ecbmct7a - 7 A
  • ecbmct7plus - 7+
  • ecbmctG-G
  • ecbmctUnrated
  • ecbmct6a-6 A
  • ecbmct6plus - 6+
  • ecbmct10a - 10 A
  • ecbmct10plus - 10+
  • ecbmct16plus - 16 yaş ve üzeri
contentDetails.contentRating.eefilmRating string
Videonun Estonya'daki derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • eefilmK12 - K-12
  • eefilmK14 - K-14
  • eefilmK16 - K-16
  • eefilmK6 - K-6
  • eefilmL-L
  • eefilmMs12 - MS-12
  • eefilmMs6 - MS-6
  • eefilmPere - Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
Videonun Mısır'daki derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • egfilm18 - 18
  • egfilmBn-BN
  • egfilmGn - GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Videonun Eirin (映倫) derecelendirmesi. Eirin, Japonya derecelendirme sistemidir.

Bu tesis için geçerli değerler şunlardır:
  • eirinG-G
  • eirinPg12 - PG-12
  • eirinR15plus - R15+
  • eirinR18plus - R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
Videonun derecelendirmesi Malezya Film Sansür Kurulundan alınmıştır.

Bu tesis için geçerli değerler şunlardır:
  • fcbm13 - 13
  • fcbm16-16
  • fcbm18 - 18
  • fcbm18pa - 18 PA
  • fcbm18pl - 18 PL
  • fcbm18sg - 18 Singapur
  • fcbm18sx - 18SX
  • fcbmP12 - P12
  • fcbmP13 - P13
  • fcbmPg13-PG13
  • fcbmU - U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Videonun derecelendirmesi Hong Kong'daki Film, Gazete ve Makale İdaresi Ofisi'nden alınmıştır.

Bu tesis için geçerli değerler şunlardır:
  • fcoI - I
  • fcoIi - II
  • fcoIia - IIA
  • fcoIib - IIB
  • fcoIii - III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
Bu mülk 2 Kasım 2015 itibarıyla kullanımdan kaldırılmıştır. Bunun yerine contentDetails.contentRating.cncRating özelliğini kullanın.

Videonun Centre national du cinéma et de l'image animé (Fransız Kültür Bakanlığı) derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • fmoc10 - 10
  • fmoc12 - 12
  • fmoc16-16
  • fmoc18 - 18
  • fmocE-D
  • fmocU - U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Videonun derecelendirmesi Güney Afrika Film ve Yayın Kurulu'ndan alınmıştır.

Bu tesis için geçerli değerler şunlardır:
  • fpb10 - 10
  • fpb1012Pg - 10-12 PG
  • fpb13 - 13
  • fpb16-16
  • fpb18 - 18
  • fpb79Pg - 7-9 PG
  • fpbA - A
  • fpbPg-PG
  • fpbUnrated
  • fpbX18 - X18
  • fpbXx - XX
contentDetails.contentRating.fpbRatingReasons[] list
Videonun FPB (Güney Afrika) derecelendirmesinin neden alındığını açıklayan nedenler.
contentDetails.contentRating.fskRating string
Videonun Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Almanya) derecelendirmesi.

Bu mülk için geçerli değerler şunlardır:
  • fsk0-0 FSK
  • fsk12-12 FSK
  • fsk16-16 FSK
  • fsk18-18 FSK
  • fsk6-6 FSK
  • fskUnrated
contentDetails.contentRating.grfilmRating string
Videonun Yunanistan'daki derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • grfilmE-D
  • grfilmK - K
  • grfilmK12 - K-12
  • grfilmK13 - K-13
  • grfilmK15 - K-15
  • grfilmK17 - K-17
  • grfilmK18 - K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Videonun Instituto de la Cinematografía y de las Artes AudioVisuales (ICAA - İspanya) derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • icaa12 - 12
  • icaa13 - 13
  • icaa16-16
  • icaa18 - 18
  • icaa7 - 7
  • icaaApta - APTA
  • icaaUnrated
  • icaaX - X
contentDetails.contentRating.ifcoRating string
Videonun İrlanda Film Sınıflandırma Ofisi (IFCO - İrlanda) derecelendirmesi. Daha fazla bilgi için IFCO web sitesini inceleyin.

Bu mülk için geçerli değerler şunlardır:
  • ifco12 - 12
  • ifco12a-12 A
  • ifco15 - 15
  • ifco15a-15 A
  • ifco16-16
  • ifco18 - 18
  • ifcoG-G
  • ifcoPg-PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
Videonun İsrail'deki derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • ilfilm12 - 12
  • ilfilm16-16
  • ilfilm18 - 18
  • ilfilmAa - AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Videonun INCAA (Instituto Nacional de Cine y Artes AudioVisuales - Arjantin) derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC - X (Solo apta para mayores de 18 años, de exhibición condicionada)
  • incaaSam13 - 13 (Solo apta para mayores de 13 años)
  • incaaSam16 - 16 (Solo apta para mayores de 16 años)
  • incaaSam18 - 18 (Solo apta para mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
Videonun Kenya Film Sınıflandırma Kurulu tarafından aldığı derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • kfcb16plus-16
  • kfcbG - GE
  • kfcbPg-PG
  • kfcbR - 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Hollanda).

Bu tesis için geçerli değerler şunlardır:
  • kijkwijzer12 - 12
  • kijkwijzer14 - 14
  • kijkwijzer16-16
  • kijkwijzer18 - 18
  • kijkwijzer6 - 6
  • kijkwijzer9-9
  • kijkwijzerAl - AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Videonun Kore Medya Derecelendirme Kurulu (以물물 aşağıdakilere Users iyileştirmeleri) ait derecelendirmeler. KMRB, Güney Kore'deki videoları ücretlendirir.

Bu tesis için geçerli değerler şunlardır:
  • kmrb12plus – 12 이용 알람 silinecek
  • kmrb15plus - 15而 이용 용람니다
  • kmrbAll - 체가람의
  • kmrbR – 청가년 알람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Videonun derecelendirmesi Endonezya'daki Lembaga Sensör Filmi'nden alındı.

Bu tesis için geçerli değerler şunlardır:
  • lsf13 - 13
  • lsf17 - 17
  • lsf21 - 21
  • lsfA - A
  • lsfBo - BO
  • lsfD - G
  • lsfR - Sağ
  • lsfSu - SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Bu videonun Malta Film Yaş Sınıflandırma Kurulu tarafından derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:
  • mccaa12 - 12
  • mccaa12a-12 A
  • mccaa14 – 14 - bu derecelendirme 2013'te kullanıma sunulan yeni sınıflandırma yapısından kaldırılmıştır.
  • mccaa15 - 15
  • mccaa16 – 16 - bu derecelendirme 2013'te kullanıma sunulan yeni sınıflandırma yapısından kaldırılmıştır.
  • mccaa18 - 18
  • mccaaPg-PG
  • mccaaU - U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Videonun derecelendirmesi Danimarka Film Enstitüsü (Det Danske Filminstitut) Medya Konseyi Çocuklar ve Gençler için Konseyi tarafından derecelendirilmiştir.

Bu tesis için geçerli değerler şunlardır:
  • mccyp11 - 11
  • mccyp15 - 15
  • mccyp7 - 7
  • mccypA - A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
Videonun Vietnam - MCST için derecelendirme sistemi

Bu tesis için geçerli değerler şunlardır:
  • mcst0 - 0
  • mcst16plus - 16 yaş ve üzeri
  • mcstC13 - C13
  • mcstC16 - C16
  • mcstC18 - C18
  • mcstP - P
  • mcstUnrated
  • mcstT13-T13
  • mcstT16-T16
  • mcstT18-T18
  • mcstK - K
contentDetails.contentRating.mdaRating string
Videonun Singapur Medya Geliştirme Kurumu (MDA) ve özellikle Film Censors Board of Film Censors (BFC) tarafından aldığı derecelendirme.

Bu mülk için geçerli değerler şunlardır:
  • mdaG-G
  • mdaM18 - M18
  • mdaNc16 - NC16
  • mdaPg-PG
  • mdaPg13-PG13
  • mdaR21 - R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Videonun derecelendirmesi Norveç Medya Kurumu Medietilsynet'ten alınmıştır.

Bu özellik için geçerli değerler şunlardır:
  • medietilsynet11 - 11
  • medietilsynet12 - 12
  • medietilsynet15 - 15
  • medietilsynet18 - 18
  • medietilsynet6 - 6
  • medietilsynet7 - 7
  • medietilsynet9-9
  • medietilsynetA - A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
Videonun Finlandiya'daki Kansallinen Audiovisualinen Instituutti'den (Ulusal Görsel İşitsel Enstitüsü) derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • meku12 - 12
  • meku16-16
  • meku18 - 18
  • meku7 - 7
  • mekuS - G
  • mekuUnrated
contentDetails.contentRating.mibacRating string
Videonun derecelendirmesi Ministero dei Benie delle Attività Culturali e del Turismo (İtalya) tarafından verilmiş.

Bu tesis için geçerli değerler şunlardır:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Videonun Ministerio de Cultura (Kolombiya) derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • moc12 - 12
  • moc15 - 15
  • moc18 - 18
  • moc7 - 7
  • mocBanned - Yasaklı
  • mocE-D
  • mocT-T
  • mocUnrated
  • mocX - X
contentDetails.contentRating.moctwRating string
Tayvan Kültür Bakanlığı (文化部) videonun derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • moctwG-G
  • moctwP - P
  • moctwPg-PG
  • moctwR - Sağ
  • moctwR12 - R-12
  • moctwR15 - R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
Videonun Sinema Filmleri Derneği (MPAA) derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • mpaaG-G
  • mpaaNc17 - NC-17
  • mpaaPg-PG
  • mpaaPg13 - PG-13
  • mpaaR - Sağ
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Sinema Filmleri Derneği'nin film fragmanları ve önizleme için belirlediği derecelendirme.

Bu tesis için geçerli değerler şunlardır:
  • mpaatGb – GB (Yeşil Bant - Tüm kitleler için onaylandı)
  • mpaatRb - RB (Kırmızı Bant - 17 yaş ve üzeri için önerilir)
contentDetails.contentRating.mtrcbRating string
Videonun, Film ve Televizyon İnceleme ve Sınıflandırma Kurulu'ndaki (Filipinler) derecelendirmesi.

Bu mülk için geçerli değerler şunlardır:
  • mtrcbG-G
  • mtrcbPg-PG
  • mtrcbR13 - R-13
  • mtrcbR16 - R-16
  • mtrcbR18 - R-18
  • mtrcbUnrated
  • mtrcbX - X
contentDetails.contentRating.nbcRating string
Videonun, Maldivler Ulusal Sınıflandırma Bürosu'nun derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • nbc12plus - 12+
  • nbc15plus - 15 yaş ve üzeri
  • nbc18plus - 18 yaş ve üzeri
  • nbc18plusr - 18+R
  • nbcG-G
  • nbcPg-PG
  • nbcPu - PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Videonun Bulgaristan Ulusal Film Merkezi'nden aldığı derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • nfrcA - A
  • nfrcB - B
  • nfrcC-C
  • nfrcD - G
  • nfrcUnrated
  • nfrcX - X
contentDetails.contentRating.nfvcbRating string
Videonun derecelendirmesi Nijerya Ulusal Film ve Video Sansürleri Kurulundan alınmıştır.

Bu tesis için geçerli değerler şunlardır:
  • nfvcb12 - 12
  • nfvcb12a-12 A
  • nfvcb15 - 15
  • nfvcb18 - 18
  • nfvcbG-G
  • nfvcbPg-PG
  • nfvcbRe - RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Videonun derecelendirmesi NacionArelais Kino centrs'ten (Letonya Ulusal Film Merkezi) alınmıştır.

Bu tesis için geçerli değerler şunlardır:
  • nkclv12plus - 12+
  • nkclv18plus - 18 yaş ve üzeri
  • nkclv7plus - 7+
  • nkclvU - U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Videonun Office of Film and Literature Classification (OFLC - Yeni Zelanda) derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:
  • oflcG-G
  • oflcM-M
  • oflcPg-PG
  • oflcR13 - R13
  • oflcR15 - R15
  • oflcR16 - R16
  • oflcR18 - R18
  • oflcRp13 - RP13
  • oflcRp16 - RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
Videonun Peru'daki derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • pefilm14 - 14
  • pefilm18 - 18
  • pefilmPg-PG
  • pefilmPt - PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
Videonun Venezuela'daki derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • resorteviolenciaA - A
  • resorteviolenciaB - B
  • resorteviolenciaC-C
  • resorteviolenciaD - G
  • resorteviolenciaE-D
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Videonun Radyo, Televizyon ve Sinematografi Genel Müdürlüğü (Meksika) derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • rtcA - A
  • rtcAa - AA
  • rtcB - B
  • rtcB15 - B15
  • rtcC-C
  • rtcD - G
  • rtcUnrated
contentDetails.contentRating.rteRating string
Videonun derecelendirmesi İrlanda Raidió Teilifís Éireann tarafından yapıldı.

Bu tesis için geçerli değerler şunlardır:
  • rteCh-İsviçre
  • rteGa - GA
  • rteMa - MA
  • rtePs-PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Videonun Rusya Federasyonu Ulusal Film Tescili (MKRF - Rusya) derecelendirmesi.

Bu mülk için geçerli değerler şunlardır:
  • russia0 - 0+
  • russia12 - 12+
  • russia16 - 16 yaş ve üzeri
  • russia18 - 18 yaş ve üzeri
  • russia6 - 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Videonun Slovakya derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • skfilmG-G
  • skfilmP2 - P2
  • skfilmP5 - P5
  • skfilmP8 - P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
Videonun İzlanda'daki derecelendirmesi.

Bu tesis için geçerli değerler şunlardır:
  • smais12 - 12
  • smais14 - 14
  • smais16-16
  • smais18 - 18
  • smais7 - 7
  • smaisL-L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Videonun derecelendirmesi Statens medieråd'dan (İsveç'in Ulusal Medya Konseyi) aittir.

Bu tesis için geçerli değerler şunlardır:
  • smsa11 - 11
  • smsa15 - 15
  • smsa7 - 7
  • smsaA - Tüm yaşlar
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Videonun TV Ebeveyn Kuralları (TVPG) derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:
  • tvpgG - TV-G
  • tvpgMa – TV-MA
  • tvpgPg - TV-PG
  • tvpgUnrated
  • tvpgY - TV-Y
  • tvpgY7 - TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 - TV-14
contentDetails.contentRating.ytRating string
YouTube'un yaş kısıtlaması olan içerikleri belirlemek için kullandığı bir derecelendirme.

Bu tesis için geçerli değerler şunlardır:
  • ytAgeRestricted
contentDetails.projection string
Videonun projeksiyon biçimini belirtir.

Bu özellik için geçerli değerler şunlardır:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Video yükleyicinin video için özel bir küçük resim sağlayıp sağlamadığını belirtir. Bu özelliği yalnızca video yükleyici görebilir.
status object
status nesnesi videonun yüklenmesi, işlenmesi ve gizlilik durumları hakkında bilgiler içerir.
status.uploadStatus string
Yüklenen videonun durumu.

Bu mülk için geçerli değerler şunlardır:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Bu değer, bir videonun neden yüklenemediğini açıklar. Bu özellik yalnızca uploadStatus özelliği yüklemenin başarısız olduğunu belirtiyorsa mevcuttur.

Bu mülk için geçerli değerler şunlardır:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
Bu değer, YouTube'un yüklenen bir videoyu neden reddettiğini açıklar. Bu özellik yalnızca uploadStatus özelliği yüklemenin reddedildiğini belirtiyorsa mevcuttur.

Bu mülk için geçerli değerler şunlardır:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Videonun gizlilik durumu.

Bu mülk için geçerli değerler şunlardır:
  • private
  • public
  • unlisted
status.publishAt datetime
Videonun yayınlanmasının planlandığı tarih ve saat. Yalnızca videonun gizlilik durumu gizli ise ayarlanabilir. Değer ISO 8601 biçiminde belirtilir. Bu mülkün davranışıyla ilgili olarak aşağıdaki iki ek noktaya dikkat edin:
  • videos.update yöntemini çağırırken bu özelliğin değerini ayarlarsanız video gizli olsa bile status.privacyStatus özelliğinin değerini de private olarak ayarlamanız gerekir.
  • İsteğinizde, geçmişteki bir zamanda yayınlanacak bir video planladıysanız video hemen yayınlanır. Bu nedenle, status.publishAt özelliğini geçmiş bir tarihe ve saate ayarlamanın etkisi, videonun privacyStatus özelliğinin private değerinden public değerine değiştirilmesiyle aynı etkiye sahiptir.
status.license string
Videonun lisansı.

Bu mülk için geçerli değerler şunlardır:
  • creativeCommon
  • youtube
status.embeddable boolean
Bu değer, videonun başka bir web sitesine yerleştirilip yerleştirilemeyeceğini ifade eder.
status.publicStatsViewable boolean
Bu değer, videonun izleme sayfasındaki genişletilmiş video istatistiklerinin herkes tarafından görüntülenip görüntülenemeyeceğini ifade eder. Varsayılan olarak bu istatistikler görüntülenebilir ve bu mülkün değeri false olarak ayarlanmış olsa bile videonun görüntüleme sayısı ve puanları gibi istatistikler herkese açık olmaya devam eder.
status.madeForKids boolean
Bu değer, videonun çocuklara yönelik olarak tanımlanıp tanımlanmadığını gösterir ve videonun mevcut "çocuklara özel" durumunu içerir. Örneğin durum, selfDeclaredMadeForKids özelliğinin değerine göre belirlenebilir. Kanalınız, videolarınız veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne bakın.
status.selfDeclaredMadeForKids boolean
Bu özellik, videos.insert veya videos.update isteğinde kanal sahibinin videoyu çocuklara yönelik olarak tanımlamasına olanak tanır. Bir videos.list isteğinde, özellik değeri yalnızca kanal sahibi API isteğini yetkilendirdiyse döndürülür.
statistics object
statistics nesnesi, videoyla ilgili istatistikleri içerir.
statistics.viewCount unsigned long
Videonun görüntülenme sayısı.
statistics.likeCount unsigned long
Videoyu beğendiğini belirten kullanıcıların sayısı.
statistics.dislikeCount unsigned long
Not: statistics.dislikeCount mülkü 13 Aralık 2021 itibarıyla gizli hale getirildi. Bu, yalnızca API isteğinin video sahibi tarafından doğrulanması durumunda mülkün API yanıtına dahil edileceği anlamına gelir. Daha fazla bilgi için düzeltme geçmişine göz atın.

Videoyu beğenmediğini belirten kullanıcıların sayısı.
statistics.favoriteCount unsigned long
Not: Bu mülk kullanımdan kaldırılmıştır. Kullanımdan kaldırma, 28 Ağustos 2015 tarihinden itibaren geçerlidir. Özelliğin değeri her zaman 0 olarak ayarlanmıştır.
statistics.commentCount unsigned long
Videoya yapılan yorum sayısı.
player object
player nesnesi, videoyu yerleştirilmiş bir oynatıcıda oynatmak için kullanabileceğiniz bilgileri içerir.
player.embedHtml string
Videoyu oynatan oynatıcıyı yerleştiren <iframe> etiketi.
  • Kaynağı alma API isteği, maxHeight ve/veya maxWidth parametreleri için bir değer belirtiyorsa yerleşik oynatıcının boyutu, maxHeight ve/veya maxWidth gereksinimlerini karşılayacak şekilde ölçeklendirilir.
  • Videonun en boy oranı bilinmiyorsa yerleşik oynatıcının biçimi varsayılan olarak 4:3'tür.
player.embedHeight long
player.embedHtml özelliğinde döndürülen yerleştirilmiş oynatıcının yüksekliği. Bu özellik, yalnızca istekte maxHeight ve/veya maxWidth parametreleri için bir değer belirtmişse ve videonun en boy oranı biliniyorsa döndürülür.
player.embedWidth long
player.embedHtml özelliğinde döndürülen yerleştirilmiş oynatıcının genişliği. Bu özellik, yalnızca istekte maxHeight ve/veya maxWidth parametreleri için bir değer belirtmişse ve videonun en boy oranı biliniyorsa döndürülür.
topicDetails object
topicDetails nesnesi, videoyla ilişkili konular hakkındaki bilgileri içerir.

Önemli: Konu kimlikleriyle ilgili olarak yapılacak değişiklikler hakkında daha fazla bilgi için topicDetails.relevantTopicIds[] ve topicDetails.topicIds[] özelliklerinin tanımlarının yanı sıra düzeltme geçmişini inceleyin.
topicDetails.topicIds[] list
Önemli: Bu mülk 10 Kasım 2016 itibarıyla kullanımdan kaldırılmıştır. API artık bu mülk için değer döndürmez ve videoyla ilişkilendirilen tüm konular topicDetails.relevantTopicIds[] özellik değeri tarafından döndürülür.
topicDetails.relevantTopicIds[] list
Videoyla ilgili konu kimliklerinin listesi.

Bu mülk, 10 Kasım 2016 itibarıyla kullanımdan kaldırılmıştır. 10 Kasım 2017'ye kadar desteklenecektir.

Önemli: Freebase ve Freebase API'nin kullanımdan kaldırılması nedeniyle, konu kimlikleri 27 Şubat 2017 tarihinden itibaren farklı şekilde çalışmaya başladı. Bu tarihte YouTube, seçilmiş konu kimliklerinden oluşan küçük bir grup sunmaya başladı.

topicDetails.topicCategories[] list
Video içeriğinin üst düzey açıklamasını sağlayan Wikipedia URL'lerinin listesi.
recordingDetails object
recordingDetails nesnesi, videonun kaydedildiği konum, tarih ve adresle ilgili bilgileri içerir.
recordingDetails.locationDescription string
Bu mülk, 1 Haziran 2017 tarihinden itibaren kullanımdan kaldırılmıştır. Daha ayrıntılı bilgi için lütfen kullanımdan kaldırma duyurusunu inceleyin.

Videonun kaydedildiği konumun metin açıklaması.
recordingDetails.location object
Videoyla ilişkilendirilen coğrafi konum bilgileri. Alt mülk değerlerinin, video sahibinin videoyla ilişkilendirmek istediği konumu tanımladığını unutmayın. Bu değer düzenlenebilir, herkese açık videolarda aranabilir ve herkese açık videolarda kullanıcılara gösterilebilir.
recordingDetails.location.latitude double
Bu mülk, 1 Haziran 2017 tarihinden itibaren kullanımdan kaldırılmıştır. Daha ayrıntılı bilgi için lütfen kullanımdan kaldırma duyurusunu inceleyin.

Derece cinsinden enlem.
recordingDetails.location.longitude double
Bu mülk, 1 Haziran 2017 tarihinden itibaren kullanımdan kaldırılmıştır. Daha ayrıntılı bilgi için lütfen kullanımdan kaldırma duyurusunu inceleyin.

Derece cinsinden boylam.
recordingDetails.location.altitude double
Bu mülk, 9 Temmuz 2018 itibarıyla kullanımdan kaldırılmıştır. Daha ayrıntılı bilgi için lütfen kullanımdan kaldırma duyurusunu inceleyin.

Referans elipsoidin üzerindeki rakım (metre).
recordingDetails.recordingDate datetime
Videonun kaydedildiği tarih ve saat. Değer ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) biçiminde belirtilir.
fileDetails object
fileDetails nesnesi, YouTube'a yüklenen video dosyasıyla ilgili bilgileri (dosyanın çözünürlüğü, süresi, ses ve video codec'leri, akış bit hızları vb. dahil) içerir. Bu veriler yalnızca video sahibi tarafından alınabilir.

fileDetails nesnesi yalnızca processingDetails.fileAvailability özelliğinin available değeri varsa döndürülür.
fileDetails.fileName string
Yüklenen dosyanın adı. Bu alan, bir video dosyasının veya başka türde bir dosyanın yüklenip yüklenmediğini gösterir.
fileDetails.fileSize unsigned long
Yüklenen dosyanın bayt cinsinden boyutu. Bu alan, bir video dosyasının veya başka türde bir dosyanın yüklenip yüklenmediğini gösterir.
fileDetails.fileType string
Yüklenen dosyanın, YouTube'un video işleme motoru tarafından tespit edilen türü. Şu anda YouTube yalnızca video dosyalarını işlemektedir ancak bu alan, video dosyası veya başka türde bir dosya yüklenip yüklenmediğiyle ilgilidir.

Bu mülk için geçerli değerler şunlardır:
  • archive – Dosya, .zip arşivi gibi bir arşiv dosyasıdır.
  • audio – Dosya, .mp3 dosyası gibi bilinen bir ses dosyası türüdür.
  • document – Dosya, MS Word dokümanı gibi bir doküman veya metin dosyası.
  • image – Dosya, .jpeg resmi gibi bir resim dosyasıdır.
  • other – Dosya, video olmayan başka bir dosya türüdür.
  • project – Dosya, gerçek video verileri içermeyen bir video proje dosyasıdır (ör. Microsoft Windows Movie Maker projesi).
  • video: Dosya, .mp4 dosyası gibi bilinen bir video dosyası türüdür.
fileDetails.container string
Yüklenen video dosyasının kapsayıcı biçimi.
fileDetails.videoStreams[] list
Yüklenen video dosyasında bulunan video akışlarının listesi. Listedeki her öğe, bir video akışıyla ilgili ayrıntılı meta verileri içerir.
fileDetails.videoStreams[].widthPixels unsigned integer
Kodlanmış video içeriğinin piksel cinsinden genişliği. Videonun kodlama en boy oranını width_pixels / height_pixels şeklinde hesaplayabilirsiniz.
fileDetails.videoStreams[].heightPixels unsigned integer
Kodlanmış video içeriğinin piksel cinsinden yüksekliği.
fileDetails.videoStreams[].frameRateFps double
Video akışının, saniyedeki kare sayısı cinsinden kare hızı.
fileDetails.videoStreams[].aspectRatio double
Video içeriğinin ekran en boy oranı (videonun görüntülenmesi gereken en boy oranını belirtir).
fileDetails.videoStreams[].codec string
Yayının kullandığı video codec'i.
fileDetails.videoStreams[].bitrateBps unsigned long
Video akışının bit hızı (bit/saniye cinsinden).
fileDetails.videoStreams[].rotation string
Videoyu düzgün şekilde görüntülemek için YouTube'un orijinal kaynak içeriği döndürmesi gereken miktardır.

Bu mülk için geçerli değerler şunlardır:
  • clockwise: Videonun saat yönünde 90 derece döndürülmesi gerekir.
  • counterClockwise: Videonun saat yönünün tersine 90 derece döndürülmesi gerekir.
  • none: Videonun döndürülmesi gerekmez.
  • other: Videonun önemsiz olmayan başka bir şekilde döndürülmesi gerekir.
  • upsideDown: Videonun ters döndürülmesi gerekir.
fileDetails.videoStreams[].vendor string
Video tedarikçisini benzersiz şekilde tanımlayan bir değerdir. Genellikle değer, dört harfli bir tedarikçi kodudur.
fileDetails.audioStreams[] list
Yüklenen video dosyasında bulunan ses akışlarının listesi. Listedeki her öğe, bir ses akışıyla ilgili ayrıntılı meta veriler içerir.
fileDetails.audioStreams[].channelCount unsigned integer
Akıştaki ses kanallarının sayısıdır.
fileDetails.audioStreams[].codec string
Yayının kullandığı ses codec'i.
fileDetails.audioStreams[].bitrateBps unsigned long
Ses akışının bit hızı (bit/saniye).
fileDetails.audioStreams[].vendor string
Video tedarikçisini benzersiz şekilde tanımlayan bir değerdir. Genellikle değer, dört harfli bir tedarikçi kodudur.
fileDetails.durationMs unsigned long
Yüklenen videonun milisaniye cinsinden uzunluğu.
fileDetails.bitrateBps unsigned long
Yüklenen video dosyasının bit/saniye cinsinden birleşik (video ve ses) bit hızı.
fileDetails.creationTime string
Yüklenen video dosyasının oluşturulduğu tarih ve saat. Değer ISO 8601 biçiminde belirtilir. Şu anda aşağıdaki ISO 8601 biçimleri desteklenmektedir:
  • Yalnızca tarih: YYYY-MM-DD
  • Naif zamanı: YYYY-MM-DDTHH:MM:SS
  • Şu saat dilimi içeren saat: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
processingDetails nesnesi, YouTube'un yüklenen video dosyasını işleme süreciyle ilgili bilgileri içerir. Nesnedeki özellikler, geçerli işleme durumunu ve YouTube'un videoyu işlemeyi bitirene kadar kalan tahmini süreyi tanımlar. Bu bölüm, farklı veri veya içerik türlerinin (ör. dosya ayrıntıları veya küçük resimler) videoda kullanılabilir olup olmadığını da belirtir.

processingProgress nesnesi, yüklenen videonun YouTube'un yüklenen video dosyasını işlemede kaydettiği ilerlemeyi izleyebilmesi için sorgulanacak şekilde tasarlanmıştır. Bu veriler yalnızca video sahibi tarafından alınabilir.
processingDetails.processingStatus string
Videonun işlenme durumu. Bu değer, YouTube'un videoyu işleyip işleyemediğini veya videonun işlenmeye devam edip etmediğini gösterir.

Bu özellik için geçerli değerler şunlardır:
  • failed – Video işleme başarısız oldu. İşleme Hata Nedenine bakın.
  • processing – Video şu anda işleniyor. İşleme İlerlemesi'ne bakın.
  • succeeded – Video başarıyla işlendi.
  • terminated – İşleme bilgileri artık kullanılamıyor.
processingDetails.processingProgress object
processingProgress nesnesi, YouTube'un videoyu işlerken kaydettiği ilerlemeyle ilgili bilgileri içerir. Değerler yalnızca videonun işleme durumu processing ise gerçekten alakalıdır.
processingDetails.processingProgress.partsTotal unsigned long
Video için işlenmesi gereken toplam bölüm sayısına dair bir tahmin. YouTube videoyu işlerken bu sayı daha kesin tahminlerle güncellenebilir.
processingDetails.processingProgress.partsProcessed unsigned long
Videonun, YouTube'un önceden işlediği bölümlerinin sayısı. YouTube'un önceden işlediği videonun yüzdesini şu hesaplamaları yaparak tahmin edebilirsiniz:
100 * parts_processed / parts_total

Tahmini parça sayısı, işlenmiş olan parça sayısında bir artışa karşılık gelen artış olmadan da artabileceği için YouTube bir videoyu işlerken hesaplanan ilerlemenin düzenli olarak azalabileceğini unutmayın.
processingDetails.processingProgress.timeLeftMs unsigned long
YouTube'un videoyu işlemeyi bitirmesi için gereken tahmini süre (milisaniye cinsinden).
processingDetails.processingFailureReason string
YouTube'un videoyu işleyememe nedeni. Bu özellik yalnızca processingStatus özelliğinin değeri failed olduğunda bir değere sahip olur.

Bu özellik için geçerli değerler şunlardır:
  • other: Başka bir işleme bileşeni başarısız oldu.
  • streamingFailed – Video, yayıncılara gönderilemedi.
  • transcodeFailed – İçerik kodu dönüştürülemedi.
  • uploadFailed - Dosya teslimi başarısız oldu.
processingDetails.fileDetailsAvailability string
Bu değer, yüklenen video için dosya ayrıntılarının mevcut olup olmadığını gösterir. Bir videonun dosya ayrıntılarını, videos.list() isteğinizde fileDetails bölümünü isteyerek alabilirsiniz.
processingDetails.processingIssuesAvailability string
Bu değer, video işleme motorunun YouTube'un videoyu işleme yeteneğini iyileştirebilecek öneriler, video işleme sorunlarını açıklayan uyarılar veya video işleme sorunlarına neden olan hatalar oluşturup oluşturmadığını ifade eder. videos.list() isteğinizde suggestions bölümünü isteyerek bu önerileri alabilirsiniz.
processingDetails.tagSuggestionsAvailability string
Bu değer, videoda anahtar kelime (etiket) önerilerinin olup olmadığını gösterir. Diğer kullanıcıların videoyu bulmasını kolaylaştırmak için videoların meta verilerine etiketler eklenebilir. videos.list() isteğinizde suggestions bölümünü isteyerek bu önerileri alabilirsiniz.
processingDetails.editorSuggestionsAvailability string
Bu değer, video kalitesini veya oynatma deneyimini iyileştirebilecek video düzenleme önerilerinin video için kullanılabilir olup olmadığını gösterir. videos.list() isteğinizde suggestions bölümünü isteyerek bu önerileri alabilirsiniz.
processingDetails.thumbnailsAvailability string
Bu değer, video için küçük resim oluşturulup oluşturulmadığını gösterir.
suggestions object
suggestions nesnesi, yüklenen videonun video kalitesini veya meta verilerini iyileştirme fırsatlarını belirleyen önerileri içerir. Bu veriler yalnızca video sahibi tarafından alınabilir.

suggestions nesnesi yalnızca processingDetails.tagSuggestionsAvailability özelliğinin veya processingDetails.editorSuggestionsAvailability özelliğinin available değerine sahip olması durumunda döndürülür.
suggestions.processingErrors[] list
YouTube'un yüklenen videoyu başarılı bir şekilde işlemesini engelleyecek hataların listesi. Bu hatalar, videonun mevcut işleme durumundan bağımsız olarak, sonuçta bu durumun neredeyse kesinlikle failed olacağını gösterir.

Bu özellik için geçerli değerler şunlardır:
  • archiveFile – Bir arşiv dosyası (ör. ZIP arşivi).
  • audioFile – Dosya yalnızca ses içerir (ör. MP3 dosyası).
  • docFile – Doküman veya metin dosyası (ör. MS Word dokümanı).
  • imageFile – Resim dosyası (ör. JPEG resmi).
  • notAVideoFile – Video olmayan başka dosya.
  • projectFile – Film proje dosyası (ör. Microsoft Windows Movie Maker projesi).
suggestions.processingWarnings[] list
YouTube'un yüklenen videonun kodunu dönüştürürken zorluk yaşamasının veya kod dönüştürmenin hatalı olmasına yol açabilecek nedenlerin listesi. Bu uyarılar, YouTube yüklenen video dosyasını gerçekten işlemeden önce oluşturulur. Ayrıca, video işlemenin başarısız olacağı anlamına gelmese de senkronizasyon sorunları, video yapıları veya eksik ses parçası gibi sorunlara yol açabilecek sorunları da tespit eder.

Bu mülk için geçerli değerler şunlardır:
  • hasEditlist – Liste düzenleme işlemleri şu anda desteklenmiyor.
  • inconsistentResolution: Çakışan kapsayıcı ve akış çözünürlükleri.
  • problematicAudioCodec – Sorunlara neden olduğu bilinen ses codec'i kullanıldı.
  • problematicVideoCodec – Sorunlara neden olduğu bilinen video codec'i kullanılmıştır.
  • unknownAudioCodec - Tanınmayan ses codec'i. Kod dönüştürme işlemi büyük olasılıkla başarısız olur.
  • unknownContainer: Tanınmayan dosya biçimi. Kod dönüştürme büyük olasılıkla başarısız olur.
  • unknownVideoCodec: Tanınmayan video codec'i. Kod dönüştürme işlemi başarısız olabilir.
suggestions.processingHints[] list
YouTube'un videoyu işleme yeteneğini geliştirebilecek önerilerin listesi.

Bu mülk için geçerli değerler şunlardır:
  • nonStreamableMov – MP4 dosyası canlı oynatılamıyor. Bu, işlemeyi yavaşlatır.
  • sendBestQualityVideo – Muhtemelen videonun daha yüksek kaliteli bir sürümü vardır.
suggestions.tagSuggestions[] list
Kullanıcıların YouTube'da arama yaparken veya gezinirken videonuzu bulma olasılığını artırmak için videonun meta verilerine eklenebilecek anahtar kelime etiketlerinin listesidir.
suggestions.tagSuggestions[].tag string
Video için önerilen anahtar kelime etiketi.
suggestions.tagSuggestions[].categoryRestricts[] list
Etiketin alakalı olduğu video kategorileri grubu. Video yükleyicinin videoyla ilişkilendirdiği video kategorisine göre uygun etiket önerilerini görüntülemek için bu bilgileri kullanabilirsiniz. Varsayılan olarak, anahtar kelime için tanımlanmış herhangi bir kısıtlama yoksa etiket önerileri tüm kategorilerle alakalıdır.
suggestions.editorSuggestions[] list
Yüklenen videonun video kalitesini veya oynatma deneyimini iyileştirebilecek video düzenleme işlemlerinin listesi.

Bu mülk için geçerli değerler şunlardır:
  • audioQuietAudioSwap – Ses parçası sessiz görünüyor. Ses parçası daha kaliteli bir şarkıyla değiştirilebilir.
  • videoAutoLevels - Resim parlaklığı düzeyleri kapalı görünüyor ve düzeltilebilir.
  • videoCrop: Resmin etrafında algılanan kenar boşlukları (mat) kırpılabilir.
  • videoStabilize – Video titriyor ve sabitlenebilir.
liveStreamingDetails object
liveStreamingDetails nesnesi, canlı video yayınıyla ilgili meta verileri içerir. Nesne yalnızca videonun yaklaşan, canlı veya tamamlanmış bir canlı yayın olması durumunda video kaynağında bulunur.
liveStreamingDetails.actualStartTime datetime
Yayının gerçekten başladığı zaman. Değer ISO 8601 biçiminde belirtilir. Bu değer, yayın başlayana kadar kullanılamayacaktır.
liveStreamingDetails.actualEndTime datetime
Yayının sona erdiği zaman. Değer ISO 8601 biçiminde belirtilir. Bu değer, yayın sona erene kadar kullanılamayacak.
liveStreamingDetails.scheduledStartTime datetime
Yayının başlamak üzere planlandığı saat. Değer ISO 8601 biçiminde belirtilir.
liveStreamingDetails.scheduledEndTime datetime
Yayının sona ermesi planlanan saat. Değer ISO 8601 biçiminde belirtilir. Değer boşsa veya özellik yoksa yayın süresiz olarak devam edecek şekilde planlanır.
liveStreamingDetails.concurrentViewers unsigned long
Şu anda yayını izleyen izleyicilerin sayısıdır. Yayının mevcut izleyicileri varsa ve yayın sahibi, videonun görüntüleme sayısını gizlemediyse özellik ve değeri gösterilir. YouTube'un, yayın sona erdiğinde yayını eşzamanlı görüntüleyen sayısını izlemeyi durdurduğunu unutmayın. Dolayısıyla bu mülk, sona ermiş bir canlı yayının arşivlenmiş videosunu izleyen kullanıcı sayısını tanımlamaz.
YouTube Data API'nin döndürdüğü eşzamanlı izleyici sayısı, YouTube Analytics aracılığıyla kullanılabilen işlenmiş ve spam'den arındırılmış eşzamanlı izleyici sayısından farklı olabilir. YouTube Yardım Merkezi'nde canlı yayın metrikleri hakkında daha fazla bilgi edinin.
liveStreamingDetails.activeLiveChatId string
Şu anda etkin olan canlı sohbetin bu videoya ekli kimliği. Bu alan yalnızca videonun canlı sohbetin etkin olduğu canlı bir yayında olması durumunda doldurulur. Yayının tamamlanması için geçiş yapıldığında bu alan kaldırılacak ve canlı sohbet kapatılacak. Kalıcı yayınlarda, canlı sohbet kimliği artık bu videoyla değil, kalıcı sayfada gösterilen yeni videoyla bağlantılıdır.
localizations object
localizations nesnesi, videonun meta verilerinin çevirilerini içerir.
localizations.(key) object
Anahtar değerle ilişkili yerelleştirilmiş metnin dili. Değer, BCP-47 dil kodu içeren bir dizedir.
localizations.(key).title string
Yerelleştirilmiş video başlığı.
localizations.(key).description string
Yerelleştirilmiş video açıklaması.