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 izleme moduyla sınırlandırılacak. Bu kısıtlamanın kaldırılması için her API projesinin Hizmet Şartları'na uygunluğunu doğrulamak amacıyla denetime tabi tutulması gerekir. Daha fazla bilgi için lütfen API Düzeltme Geçmişi'ne bakın.

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 videoların listesine verdiği puanları alır. Hemen deneyin.

list

API istek parametreleriyle eşleşen videoların listesini döndürür. Hemen deneyin.

insert

Bir videoyu YouTube'a 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.

rate

Bir videoya beğenme veya beğenmeme puanı ekleme ya da videodan puan kaldırma. Hemen deneyin.

reportAbuse

Kötüye kullanım amaçlı içerik barındıran videoları bildirme. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısında, videos kaynağının biçimi gösterilmektedir:

{
  "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,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "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 olur.
etag	etag Bu kaynağın Etag değeri.
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ı 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 olarak yüklenir ve daha sonra herkese açık hale getirilirse bu özellik, videonun herkese açık hale getirildiği zamanı belirtir. Birkaç özel durum vardır: Bir video gizli olarak yüklenirse ve video meta verileri kanal sahibi tarafından alınırsa mülk değeri, videonun yüklendiği tarih ve saati belirtir. Bir video liste dışı olarak yüklenirse özellik değeri, videonun yüklenildiğ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ığı kimliktir.
snippet.title	string Videonun başlığı. Mülk değeri en fazla 100 karakter uzunluğundadır ve < ile > hariç tüm geçerli UTF-8 karakterlerini içerebilir. videos.update yöntemini çağırıyorsanız ve bir video kaynağının snippet bölümünü güncelliyorsanız bu mülk için bir değer ayarlamanız gerekir.
snippet.description	string Videonun açıklaması. Mülk değeri en fazla 5.000 bayt uzunluğundadır ve < ile > hariç tüm geçerli UTF-8 karakterlerini içerebilir.
snippet.thumbnails	object Videoyla ilişkili küçük resimlerin haritası. Haritadaki her nesne için anahtar, küçük resim 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: default: Varsayılan küçük resim. Bir videonun veya videoya atıfta bulunan bir kaynağın (ör. oynatma listesi öğesi veya arama sonucu) varsayılan küçük resmi 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 yüksekliğindedir. medium: Küçük resmin daha yüksek çözünürlüklü bir sürümü. Videolar (veya videoya atıfta bulunan kaynaklar) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanallar için 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ü. Videolar (veya videoya atıfta bulunan kaynaklar) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanallar için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir. standard: Küçük resmin, high çözünürlüğündeki resimden daha yüksek çözünürlüklü bir sürümü. Bu resim, bazı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri veya arama sonuçları) kullanılabilir. Bu resim 640 piksel genişliğinde ve 480 piksel yüksekliğindedir. maxres: Küçük resmin en yüksek çözünürlüklü sürümü. Bu resim boyutu, bazı videolar ve videolara atıfta bulunan diğer kaynaklar (ör. oynatma listesi öğeleri veya arama sonuçları) için kullanılabilir. Bu resim 1.280 piksel genişliğinde ve 720 piksel yüksekliğindedir.
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. Mülk değeri en fazla 500 karakter uzunluğunda olabilir. Karakter sınırının hesaplanma şekliyle ilgili aşağıdaki kurallara dikkat edin: Mülk değeri bir listetir ve listedeki öğeler arasındaki virgüller sınıra dahil edilir. Bir etiket boşluk içeriyorsa API sunucusu, etiket değerini tırnak içine alınmış gibi işler ve tırnak işaretleri karakter sınırlamasına dahil edilir. Bu nedenle, karakter sınırı açısından 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ıyorsanız ve bir video kaynağının snippet bölümünü güncelliyorsanız bu özellik için bir değer ayarlamanız 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 "none" (yok) değerini alır. Bu özellik için geçerli değerler: live none upcoming
snippet.defaultLanguage	string video kaynağının snippet.title ve snippet.description özelliklerindeki metnin dili.
snippet.localized	object snippet.localized nesnesi, videonun yerelleştirilmiş başlığını ve açıklamasını ya da videonun meta verilerinin varsayılan dilinde başlığını 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 kaynak snippet'inde yerelleştirilmiş metin döndürülür. hl parametresi değeri belirtilmezse veya bir değer belirtilirse ancak belirtilen dil için yerelleştirilmiş meta veri mevcut değilse varsayılan dilin meta verileri döndürülür. Mülk 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 mülkü, videonun varsayılan ses parçasında konuşulan dili belirtir.
contentDetails	object contentDetails nesnesi, videonun uzunluğu ve videoda altyazı olup olmadığı bilgisi dahil olmak üzere video içeriği hakkında bilgi içerir.
contentDetails.duration	string Videonun uzunluğu. Özellik değeri, ISO 8601 biçiminde bir süredir. Örneğin, en az bir dakika ve en fazla bir saat uzunluğundaki bir videonun süresi PT#M#S biçimindedir. Bu biçimte PT harfleri, değerin bir süreyi belirttiğini, M ve S harfleri ise süreyi sırasıyla dakika ve saniye cinsinden ifade eder. M ve S harflerinden önce gelen # karakterleri, videonun dakika (veya saniye) sayısını belirten tam sayılardır. Örneğin, PT15M33S değeri videonun 15 dakika 33 saniye uzunluğunda olduğunu gösterir. Video en az bir saat uzunluğundaysa süre PT#H#M#S biçimindedir. Bu biçimte, H harfinden önce gelen #, videonun saat cinsinden uzunluğunu belirtir. 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 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 mi yoksa 2D mi olduğunu belirtir.
contentDetails.definition	string Videonun yüksek çözünürlükte (HD) mi yoksa yalnızca standart çözünürlükte mi izlenebileceğini belirtir. Bu mülk için geçerli değerler şunlardır: hd sd
contentDetails.caption	string Videoda altyazı olup olmadığını belirtir. Bu özelliğin geçerli değerleri şunlardır: false true
contentDetails.licensedContent	boolean Videonun lisanslı içerik gösterip göstermediğini belirtir. Lisanslı içerik, bir YouTube içerik iş ortağına bağlı kanala yüklenen ve daha sonra bu iş ortağı tarafından hak talebinde bulunulan içeriktir.
contentDetails.regionRestriction	object regionRestriction nesnesi, bir videonun görüntülenebileceği (veya görüntülenemeyeceği) ülkelerle ilgili bilgileri içerir. Nesne, contentDetails.regionRestriction.allowed veya contentDetails.regionRestriction.blocked özelliğini içerir.
contentDetails.regionRestriction.allowed[]	list Videonun görüntülenebileceği ülkeleri tanımlayan bölge kodlarının listesi. Bu özellik mevcutsa ve değerinde bir ülke listelenmemişse videonun söz konusu ülkede gösterilmesi engellenir. Bu özellik 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 özellik mevcutsa ve değerinde bir ülke listelenmemişse video o ülkede görüntülenebilir. Bu özellik mevcutsa ve boş bir liste içeriyorsa video tüm ülkelerde görüntülenebilir.
contentDetails.contentRating	object Videonun çeşitli derecelendirme sistemlerine göre aldığı derecelendirmeleri belirtir.
contentDetails.contentRating.acbRating	string Videonun Australian Classification Board (ACB) veya Australian Communications and Media Authority (ACMA) derecelendirmesi. ACMA derecelendirmeleri, çocuk 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ı verilen programlar. Bu programlar 14 yaşından küçük çocuklara (okul öncesi çağdaki çocukların dışında) yöneliktir. acbE – E acbG – G acbM – M acbMa15plus – MA15+ acbP: Avustralya İletişim ve Medya Kurumu tarafından P sınıflandırması verilen programlar. Bu programlar okul öncesi çağındaki çocuklara yöneliktir. acbPg – PG acbR18plus – R18+ acbUnrated
contentDetails.contentRating.agcomRating	string Videonun İtalya'daki Autorità per le Garanzie nelle Comunicazioni (AGCOM) tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler: agcomT – T agcomUnrated agcomVm14 – VM14 agcomVm18 – VM18
contentDetails.contentRating.anatelRating	string Videonun Şili televizyonu için Anatel (Asociación Nacional de Televisión) derecelendirmesi. Bu özellik için geçerli değerler: anatelA – A anatelF – F anatelI – I anatelI10 – I-10 anatelI12 – I-12 anatelI7 – I-7 anatelR – R anatelUnrated
contentDetails.contentRating.bbfcRating	string Videonun British Board of Film Classification (BBFC) derecelendirmesi. Bu mülk için geçerli değerler: bbfc12 – 12 bbfc12a – 12A bbfc15 – 15 bbfc18 – 18 bbfcPg – PG bbfcR18 – R18 bbfcU – U bbfcUnrated
contentDetails.contentRating.bfvcRating	string Videonun Tayland Film ve Video Sansür Kurulu tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler: bfvc13 – 13 bfvc15 – 15 bfvc18 – 18 bfvc20 – 20 bfvcB – B bfvcE – E bfvcG – G bfvcUnrated
contentDetails.contentRating.bmukkRating	string Videonun Avusturya Medya Sınıflandırma Kurulu (Bundesministerium für Unterricht, Kunst und Kultur) tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler şunlardır: bmukk10 – 10+ bmukk12 – 12+ bmukk14 – 14+ bmukk16 – 16+ bmukk6 – 6+ bmukk8 – 8+ bmukkAa – Kısıtlanmamış bmukkUnrated
contentDetails.contentRating.catvRating	string Kanada TV'si için derecelendirme sistemi - Kanada TV Sınıflandırma Sistemi Videonun, Kanada'da İngilizce yayın yapan Kanada Radyo, Televizyon ve Telekomünikasyon Komisyonu (CRTC) tarafından verilen 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: catv14plus – 14+ catv18plus – 18+ catvC – C catvC8 – C8 catvG – G catvPg – PG catvUnrated
contentDetails.contentRating.catvfrRating	string Videonun, Kanada'da Fransızca yayın yapan kuruluşlar için Kanada Radyo, Televizyon ve Telekomünikasyon Komisyonu (CRTC) tarafından verilen derecelendirmesi. Daha fazla bilgi için Kanada Yayın Standartları Konseyi web sitesine bakın. Bu özellik için geçerli değerler şunlardır: catvfr13plus – 13+ catvfr16plus – 16+ catvfr18plus – 18+ catvfr8plus – 8+ catvfrG – G catvfrUnrated
contentDetails.contentRating.cbfcRating	string Videonun Central Board of Film Certification (CBFC - Hindistan) derecelendirmesi. Bu özellik için geçerli değerler: cbfcA – A cbfcS – S cbfcU – U cbfcUnrated cbfcUA – U/A cbfcUA7plus – U/A cbfcUA13plus – U/A cbfcUA16plus – U/A
contentDetails.contentRating.cccRating	string Videonun Consejo de Calificación Cinematográfica (Şili) derecelendirmesi. Bu özellik için geçerli değerler: ccc14 – 14+ ccc18 – 18+ ccc18s – 18+ - contenido pornográfico ccc18v – 18+ - contenido excesivamente violento ccc6 – 6+ - Inconveniente para menores de 7 años cccTe – Todo espectador cccUnrated
contentDetails.contentRating.cceRating	string Videonun Portekiz'deki Comissão de Classificação de Espect´culos tarafından verilen derecelendirmesi. Bu özellik 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 özellik için geçerli değerler: chfilm0 – 0 chfilm12 – 12 chfilm16 – 16 chfilm18 – 18 chfilm6 – 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string Videonun Kanada Ev Videoları Derecelendirme Sistemi (CHVRS) derecelendirmesi. Bu mülk için geçerli değerler şunlardır: chvrs14a – 14A chvrs18a – 18A chvrsE – E chvrsG – G chvrsPg – PG chvrsR – R chvrsUnrated
contentDetails.contentRating.cicfRating	string Videonun, Commission de Contrôle des Films (Belçika) tarafından verilen derecelendirmesi. Bu mülk için geçerli değerler şunlardır: cicfE – E cicfKntEna – KNT/ENA cicfKtEa – KT/EA cicfUnrated
contentDetails.contentRating.cnaRating	string Videonun Romanya'daki CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler: cna12 – 12 cna15 – 15 cna18 – 18 cna18plus – 18+ cnaAp – AP cnaUnrated
contentDetails.contentRating.cncRating	string Fransa'daki derecelendirme sistemi - Commission de classification cinematographique Bu özellik için geçerli değerler şunlardır: cnc10 – 10 cnc12 – 12 cnc16 – 16 cnc18 – 18 cncE – E cncT – T cncUnrated
contentDetails.contentRating.csaRating	string Fransa'nın yayın içeriğini derecelendiren Conseil supérieur de l?audiovisuel tarafından verilen video derecelendirmesi. Bu mülk için geçerli değerler şunlardır: csa10 – 10 csa12 – 12 csa16 – 16 csa18 – 18 csaInterdiction – Engelleme csaT – T csaUnrated
contentDetails.contentRating.cscfRating	string Videonun Lüksemburg'daki Commission de surveillance de la classification des films (CSCF) tarafından verilen derecelendirmesi. Bu özellik 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 derecelendirmesi. Bu özellik 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 mülk için geçerli değerler: djctq10 – 10 djctq12 – 12 djctq14 – 14 djctq16 – 16 djctq18 – 18 djctqL – L djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list Videonun DJCQT (Brezilya) derecelendirmesini almasının nedenlerini açıklayan nedenler.
contentDetails.contentRating.ecbmctRating	string Türkiye'deki derecelendirme sistemi - Kültür ve Turizm Bakanlığı Değerlendirme ve Sınıflandırma Kurulu Bu özellik için geçerli değerler şunlardır: ecbmct13a – 13A ecbmct13plus – 13+ ecbmct15a – 15A ecbmct15plus – 15+ ecbmct18plus – 18+ ecbmct7a – 7A ecbmct7plus – 7+ ecbmctG – G ecbmctUnrated ecbmct6a – 6A ecbmct6plus – 6+ ecbmct10a – 10A ecbmct10plus – 10+ ecbmct16plus – 16+
contentDetails.contentRating.eefilmRating	string Videonun Estonya'daki derecelendirmesi. Bu özellik için geçerli değerler şunlardır: eefilmK12 – K-12 eefilmK14 – K-14 eefilmK16 – K-16 eefilmK6 – Anaokulu-6. sınıf eefilmL – L eefilmMs12 – MS-12 eefilmMs6 – MS-6 eefilmPere – Pere eefilmUnrated
contentDetails.contentRating.egfilmRating	string Videonun Mısır'daki derecelendirmesi. Bu özellik için geçerli değerler: egfilm18 – 18 egfilmBn – BN egfilmGn – GN egfilmUnrated
contentDetails.contentRating.eirinRating	string Videonun Eirin (映倫) derecelendirmesi. Eirin, Japonya'daki derecelendirme sistemidir. Bu özellik için geçerli değerler şunlardır: eirinG – G eirinPg12 – PG-12 eirinR15plus – R15+ eirinR18plus – R18+ eirinUnrated
contentDetails.contentRating.fcbmRating	string Videonun Malezya Film Sansür Kurulu tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler: fcbm13 – 13 fcbm16 – 16 fcbm18 – 18 fcbm18pa – 18PA fcbm18pl – 18PL fcbm18sg – 18SG fcbm18sx – 18SX fcbmP12 – P12 fcbmP13 – P13 fcbmPg13 – PG13 fcbmU – U fcbmUnrated
contentDetails.contentRating.fcoRating	string Videonun Hong Kong Film, Gazete ve Makale İdaresi tarafından verilen derecelendirmesi. Bu mülk için geçerli değerler şunlardır: fcoI – I fcoIi – II fcoIia – IIA fcoIib – IIB fcoIii – III fcoUnrated
contentDetails.contentRating.fmocRating	string Bu özelliğin desteği 2 Kasım 2015'ten itibaren sonlandırıldı. Bunun yerine contentDetails.contentRating.cncRating mülkünü kullanın. Videonun Centre national du cinéma et de l'image animé (Fransa Kültür Bakanlığı) derecelendirmesi. Bu mülk için geçerli değerler şunlardır: fmoc10 – 10 fmoc12 – 12 fmoc16 – 16 fmoc18 – 18 fmocE – E fmocU – U fmocUnrated
contentDetails.contentRating.fpbRating	string Videonun Güney Afrika Film ve Yayın Kurulu tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler şunlardır: fpb10 – 10 fpb1012Pg – 10-12PG fpb13 – 13 fpb16 – 16 fpb18 – 18 fpb79Pg – 7-9PG fpbA – A fpbPg – PG fpbUnrated fpbX18 – X18 fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[]	list Videonun FPB (Güney Afrika) derecelendirmesini neden aldığı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 – FSK 0 fsk12 – FSK 12 fsk16 – FSK 16 fsk18 – FSK 18 fsk6 – FSK 6 fskUnrated
contentDetails.contentRating.grfilmRating	string Videonun Yunanistan'daki derecelendirmesi. Bu özellik için geçerli değerler: grfilmE – E 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 mülk 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 Kurumu (IFCO - İrlanda) derecelendirmesi. Daha fazla bilgi için IFCO web sitesine bakın. Bu özellik için geçerli değerler şunlardır: ifco12 – 12 ifco12a – 12A ifco15 – 15 ifco15a – 15A ifco16 – 16 ifco18 – 18 ifcoG – G ifcoPg – PG ifcoUnrated
contentDetails.contentRating.ilfilmRating	string Videonun İsrail'deki derecelendirmesi. Bu özellik 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 mülk 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 verilen derecelendirmesi. Bu özellik için geçerli değerler: kfcb16plus – 16 kfcbG – GE kfcbPg – PG kfcbR – 18 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media (Hollanda). Bu mülk 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 (영상물등급위원회) derecelendirmesi. KMRB, Güney Kore'deki videoları derecelendirir. Bu özellik için geçerli değerler: kmrb12plus – 12세 이상 관람가 kmrb15plus – 15세 이상 관람가 kmrbAll – 전체관람가 kmrbR – 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string Videonun Endonezya'daki Lembaga Sensor Film tarafından verilen derecelendirmesi. Bu mülk için geçerli değerler şunlardır: lsf13 – 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo – BO lsfD – D lsfR – R lsfSu – SU lsfUnrated
contentDetails.contentRating.mccaaRating	string Videonun Malta Film Yaş Sınıflandırma Kurulu tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler: mccaa12 – 12 mccaa12a – 12A mccaa14 – 14: Bu derecelendirme, 2013'te kullanıma sunulan yeni sınıflandırma yapısından kaldırıldı. 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 Danimarka Film Enstitüsü'nün (Det Danske Filminstitut) Çocuklar ve Gençler İçin Medya Konseyi tarafından verilen derecelendirmesi. Bu mülk için geçerli değerler: mccyp11 – 11 mccyp15 – 15 mccyp7 – 7 mccypA – A mccypUnrated
contentDetails.contentRating.mcstRating	string Videonun Vietnam için derecelendirme sistemi - MCST Bu özellik için geçerli değerler: mcst0 – 0 mcst16plus – 16+ 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 de Film Sansür Kurulu (BFC) tarafından verilen derecelendirmesi. 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, Norveç Medya Kurumu Medietilsynet tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler: 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 Audiovisuaalinen Instituutti (Ulusal Görsel-İşitsel Enstitü) tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler şunlardır: meku12 – 12 meku16 – 16 meku18 – 18 meku7 – 7 mekuS – S mekuUnrated
contentDetails.contentRating.mibacRating	string Videonun, Ministero dei Beni e delle Attività Culturali e del Turismo (İtalya) tarafından verilen derecelendirmesi. Bu özellik 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 özellik için geçerli değerler: moc12 – 12 moc15 – 15 moc18 – 18 moc7 – 7 mocBanned – Yasaklandı mocE – E mocT – T mocUnrated mocX – X
contentDetails.contentRating.moctwRating	string Videonun Tayvan Kültür Bakanlığı (文化部) tarafından verilen derecelendirmesi. Bu mülk için geçerli değerler şunlardır: moctwG – G moctwP – P moctwPg – PG moctwR – R moctwR12 – R-12 moctwR15 – R-15 moctwUnrated
contentDetails.contentRating.mpaaRating	string Videonun Motion Picture Association of America (MPAA) derecelendirmesi. Bu mülk için geçerli değerler şunlardır: mpaaG – G mpaaNc17 – NC-17 mpaaPg – PG mpaaPg13 – PG-13 mpaaR – R mpaaUnrated
contentDetails.contentRating.mpaatRating	string Motion Picture Association of America'nın film fragmanları ve önizlemeleri için derecelendirmesi. Bu mülk 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 (Filipinler) tarafından verilen 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 Maldivler Ulusal Sınıflandırma Bürosu'nun videoya verdiği derecelendirme. Bu özellik için geçerli değerler: nbc12plus – 12+ nbc15plus – 15+ nbc18plus – 18+ nbc18plusr – 18+R nbcG – G nbcPg – PG nbcPu – PU nbcUnrated
contentDetails.contentRating.nfrcRating	string Bulgar Ulusal Film Merkezi'nin videoya verdiği derecelendirme. Bu mülk için geçerli değerler: nfrcA – A nfrcB – B nfrcC – C nfrcD – D nfrcUnrated nfrcX – X
contentDetails.contentRating.nfvcbRating	string Videonun, Nijerya Ulusal Film ve Video Sansür Kurulu tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler şunlardır: nfvcb12 – 12 nfvcb12a – 12A nfvcb15 – 15 nfvcb18 – 18 nfvcbG – G nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string Videonun Nacionãlais Kino centrs (Letonya Ulusal Film Merkezi) tarafından verilen derecelendirmesi. Bu mülk için geçerli değerler şunlardır: nkclv12plus – 12+ nkclv18plus – 18+ nkclv7plus – 7+ nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string Videonun Film ve Edebiyat Sınıflandırma Kurumu (OFLC - Yeni Zelanda) derecelendirmesi. Bu mülk 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 özellik 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 özellik için geçerli değerler şunlardır: resorteviolenciaA – A resorteviolenciaB – B resorteviolenciaC – C resorteviolenciaD – D resorteviolenciaE – E resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string Videonun Radyo, Televizyon ve Sinema Genel Müdürlüğü (Meksika) derecelendirmesi. Bu mülk için geçerli değerler: rtcA – A rtcAa – AA rtcB – B rtcB15 – B15 rtcC – C rtcD – D rtcUnrated
contentDetails.contentRating.rteRating	string Videonun İrlanda'daki Raidió Teilifís Éireann tarafından verilen derecelendirmesi. Bu özellik için geçerli değerler: rteCh – CH rteGa – GA rteMa – MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string Videonun Rusya Federasyonu Ulusal Film Kaydı (MKRF - Rusya) derecelendirmesi. Bu özellik için geçerli değerler: russia0 – 0+ russia12 – 12+ russia16 – 16+ russia18 – 18+ russia6 – 6+ russiaUnrated
contentDetails.contentRating.skfilmRating	string Videonun Slovakya'daki derecelendirmesi. Bu özellik için geçerli değerler: skfilmG – G skfilmP2 – P2 skfilmP5 – P5 skfilmP8 – P8 skfilmUnrated
contentDetails.contentRating.smaisRating	string Videonun İzlanda'daki derecelendirmesi. Bu özellik 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 Statens medieråd (İsveç Ulusal Medya Konseyi) tarafından verilen video derecelendirmesi. Bu özellik için geçerli değerler: smsa11 – 11 smsa15 – 15 smsa7 – 7 smsaA – Tüm yaşlar smsaUnrated
contentDetails.contentRating.tvpgRating	string Videonun TV Ebeveyn Yönergeleri (TVPG) derecelendirmesi. Bu mülk 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ı uygulanan içerikleri tanımlamak için kullandığı derecelendirme. Bu özellik için geçerli değerler: ytAgeRestricted
contentDetails.projection	string Videonun projeksiyon biçimini belirtir. Bu özellik için geçerli değerler şunlardır: 360 rectangular
contentDetails.hasCustomThumbnail	boolean Videoyu yükleyen kullanıcının video için özel bir küçük resim sağlayıp sağlamadığını belirtir. Bu mülkü yalnızca videoyu yükleyen kullanıcı görebilir.
status	object status nesnesi, videonun yüklenmesi, işlenmesi ve gizlilik durumları hakkında bilgi içerir.
status.uploadStatus	string Yüklenen videonun durumu. Bu özellik için geçerli değerler: deleted failed processed rejected uploaded
status.failureReason	string Bu değer, videonun neden yüklenemediğini açıklar. Bu özellik yalnızca uploadStatus özelliği yüklemenin başarısız olduğunu gösteriyorsa mevcuttur. Bu özellik 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 özellik 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 özellik için geçerli değerler şunlardır: private public unlisted
status.publishAt	datetime Videonun yayınlanması planlanan tarih ve saat. Bu seçenek yalnızca videonun gizlilik durumu gizliyse ayarlanabilir. Değer ISO 8601 biçiminde belirtilir. Bu mülkün davranışıyla ilgili aşağıdaki iki ek noktaya dikkat edin: videos.update yöntemini çağırırken bu özelliğin değerini ayarlarsanız video zaten gizli olsa bile status.privacyStatus özelliğinin değerini private olarak da ayarlamanız gerekir. İsteğiniz doğrultusunda videonun geçmişte yayınlanması planlanmışsa video hemen yayınlanır. Bu nedenle, status.publishAt mülkünün geçmiş bir tarih ve saate ayarlanmasının etkisi, videonun privacyStatus değerinin private yerine public olarak değiştirilmesiyle aynıdır.
status.license	string Videonun lisansı. Bu özellik 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 belirtir.
status.publicStatsViewable	boolean Bu değer, videonun izleme sayfasındaki genişletilmiş video istatistiklerinin herkese açık olup olmadığını belirtir. Bu istatistikler varsayılan olarak görüntülenebilir. 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 olarak görünmeye 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ın, videolarınızın veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.
status.selfDeclaredMadeForKids	boolean videos.insert veya videos.update isteğinde bu özellik, kanal sahibinin videoyu çocuklara yönelik olarak tanımlamasına olanak tanır. videos.list isteğinde, mülk değeri yalnızca kanal sahibi API isteğine yetki verdiyse döndürülür.
status.containsSyntheticMedia	boolean Bu özellik, videos.insert veya videos.update isteklerinde kanal sahibinin videoda gerçekçi Değiştirilmiş veya Yapay (D/Y) içerik bulunduğunu açıklamasına olanak tanır. A/S içerikleriyle ilgili YouTube politikaları hakkında daha fazla bilgi edinin. A/S içeriğine örnek olarak aşağıdaki videolar verilebilir: Gerçek bir insanı, söylemediği veya yapmadığı bir şeyi söylemiş ya da yapmış gibi gösterme Gerçek bir olayın veya yerin kamera görüntülerini değiştirme Gerçekte meydana gelmese de gerçekçi görünen bir sahne oluşturma
statistics	object statistics nesnesi, videoyla ilgili istatistikleri içerir.
statistics.viewCount	unsigned long Videonun görüntülenme sayısı. 31 Mart 2025'ten itibaren Shorts videolarında viewCount, minimum izlenme süresi şartı olmadan Shorts videosunun oynatılmaya veya tekrar oynatılmaya başlama sayısını döndürecek.
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, mülkün yalnızca API isteği video sahibi tarafından kimliği doğrulanmışsa API yanıtına dahil edileceği anlamına gelir. Daha fazla bilgi için düzeltme geçmişine bakın. Videoyu beğenmediğini belirten kullanıcıların sayısı.
statistics.favoriteCount	unsigned long Not: Bu özelliğin desteği sonlandırıldı. Destek sonlandırma işlemi 28 Ağustos 2015'ten itibaren geçerlidir. Mülkün değeri artık her zaman 0 olarak ayarlanır.
statistics.commentCount	unsigned long Videoya yapılan yorumların sayısı.
paidProductPlacementDetails	object paidProductPlacementDetails nesnesi, videodaki ücretli ürün yerleşimiyle ilgili bilgileri içerir.
paidProductPlacementDetails.hasPaidProductPlacement	boolean İçerikte ücretli ürün yerleşimi kullanılıyorsa true olarak ayarlayın. Varsayılan olarak false değerine ayarlanır.
player	object player nesnesi, videoyu yerleşik bir oynatıcıda oynatmak için kullanacağınız bilgileri içerir.
player.embedHtml	string Videoyu oynatan bir oynatıcıyı yerleştiren <iframe> etiketi. Kaynağı almak için yapılan API isteğinde maxHeight ve/veya maxWidth parametreleri için bir değer belirtilirse yerleşik oynatıcının boyutu, maxHeight ve/veya maxWidth koşullarını karşılayacak şekilde ölçeklendirilir. Videonun en boy oranı bilinmiyorsa yerleşik oynatıcı varsayılan olarak 4:3 biçiminde olur.
player.embedHeight	long player.embedHtml mülkünde döndürülen yerleşik oynatıcının yüksekliği. Bu özellik yalnızca istek 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 mülkünde döndürülen yerleşik oynatıcının genişliği. Bu özellik yalnızca istek 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 konularla ilgili bilgileri içerir. Önemli: Konu kimlikleriyle ilgili 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şine bakın.
topicDetails.topicIds[]	list Önemli: Bu özelliğin desteği 10 Kasım 2016'dan itibaren sonlandırılmıştır. API artık bu mülk için değer döndürmez ve bir videoyla ilişkili tüm konular artık topicDetails.relevantTopicIds[] mülk değeri tarafından döndürülür.
topicDetails.relevantTopicIds[]	list Videoyla alakalı konu kimliklerinin listesi. Bu özelliğin desteği 10 Kasım 2016'da sonlandırılmıştır. 10 Kasım 2017'ye kadar desteklenecektir. Önemli: Freebase ve Freebase API'nin desteğinin sonlandırılması nedeniyle konu kimlikleri 27 Şubat 2017'den itibaren farklı şekilde çalışmaya başlamıştır. O dönemde YouTube, küçük bir grup seçili konu kimliği döndürmeye başladı. 15 Şubat 2017'den itibaren desteklenen konu kimliklerini inceleyin Konular Müzik konuları /m/04rlf Müzik (üst konu) /m/02mscn Hristiyan müziği /m/0ggq0m Klasik müzik /m/01lyv Ülke /m/02lkt Elektronik müzik /m/0glt670 Hip hop müzik /m/05rwpb Bağımsız müzik /m/03_d0 Caz /m/028sqc Asya Müziği /m/0g293 Latin Amerika Müziği /m/064t9 Pop müzik /m/06cqb Reggae /m/06j6l R&B /m/06by7 Rock müzik /m/0gywn Soul müzik Oyun konuları /m/0bzvm2 Oyun (üst konu) /m/025zzc Aksiyon oyunu /m/02ntfj Aksiyon-macera oyunu /m/0b1vjn Basit oyun /m/02hygl Müzik videosu oyunu /m/04q1x3q Bulmaca video oyunu /m/01sjng Yarış temalı video oyunu /m/0403l3g Rol yapma video oyunu /m/021bp2 Simülasyon video oyunu /m/022dc6 Spor müsabakası /m/03hf_rm Strateji video oyunu Spor konuları /m/06ntj Spor (üst konu) /m/0jm_ Amerikan futbolu /m/018jz Beyzbol /m/018w8 Basketbol /m/01cgz Boks /m/09xp_ Kriket /m/02vx4 Futbol /m/037hz Golf /m/03tmr Buz hokeyi /m/01h7lh Karma savaş sanatları /m/0410tth Motor sporları /m/07bs0 Tenis /m/07_53 Voleybol Eğlence konuları /m/02jjt Eğlence (üst konu) /m/09kqc Mizah /m/02vxn Filmler /m/05qjc Performans sanatları /m/066wd Profesyonel güreş /m/0f2f9 TV programları Yaşam tarzı konuları /m/019_rr Yaşam Tarzı (üst konu) /m/032tl Moda /m/027x7n Fitness /m/02wbm Yiyecek /m/03glg Hobi /m/068hy Evcil hayvanlar /m/041xxh Fiziksel çekicilik [Güzellik] /m/07c1v Teknoloji /m/07bxq Turizm /m/07yv9 Araçlar Toplum konuları /m/098wr Toplum (ana konu) /m/09s1f İşletme /m/0kt51 Sağlık /m/01h6rj Askeriye /m/05qt0 Politika /m/06bvp Din Diğer konular /m/01k8wb Bilgi
topicDetails.topicCategories[]	list Videonun içeriğinin üst düzey bir açıklamasını sağlayan Wikipedia URL'lerinin listesi.
recordingDetails	object recordingDetails nesnesi, videonun çekildiği konum, tarih ve adresle ilgili bilgileri kapsar.
recordingDetails.locationDescription	string Bu özelliğin desteği 1 Haziran 2017'den itibaren sonlandırılmıştır. Daha fazla bilgi için lütfen kullanımdan kaldırma duyurusuna bakın. Videonun çekildiği yerin metin açıklaması.
recordingDetails.location	object Videoyla ilişkili coğrafi konum bilgileri. Alt mülk değerlerinin, video sahibinin videoyla ilişkilendirmek istediği konumu tanımladığını unutmayın. Değer düzenlenebilir, herkese açık videolarda aranabilir ve herkese açık videolarda kullanıcılara gösterilebilir.
recordingDetails.location.latitude	double Bu özelliğin desteği 1 Haziran 2017'den itibaren sonlandırılmıştır. Daha fazla bilgi için lütfen kullanımdan kaldırma duyurusuna bakın. Derece cinsinden enlem.
recordingDetails.location.longitude	double Bu özelliğin desteği 1 Haziran 2017'den itibaren sonlandırılmıştır. Daha fazla bilgi için lütfen kullanımdan kaldırma duyurusuna bakın. Derece cinsinden boylam.
recordingDetails.location.altitude	double Bu özelliğin desteği 9 Temmuz 2018'den itibaren sonlandırılmıştır. Daha fazla bilgi için lütfen kullanımdan kaldırma duyurusuna bakın. Referans elipsoitinden yükseklik (metre cinsinden).
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 (ör. dosya çözünürlüğü, süresi, ses ve video codec'leri, yayın bit hızları) kapsar. Bu verilere yalnızca videonun sahibi erişebilir. fileDetails nesnesi yalnızca processingDetails.fileAvailability mülkünün değeri available ise döndürülür.
fileDetails.fileName	string Yüklenen dosyanın adı. Bu alan, video dosyası veya başka bir dosya türü yüklendiğinde gösterilir.
fileDetails.fileSize	unsigned long Yüklenen dosyanın bayt cinsinden boyutu. Bu alan, video dosyası veya başka bir dosya türü yüklendiğinde gösterilir.
fileDetails.fileType	string YouTube'un video işleme motoru tarafından algılanan, yüklenen dosyanın türü. YouTube şu anda yalnızca video dosyalarını işlemektedir ancak video dosyası veya başka bir dosya türü yüklendiğinde bu alan mevcuttur. 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, bilinen bir ses dosyası türündedir (ör. .mp3 dosyası). document: Dosya, MS Word dokümanı gibi bir doküman veya metin dosyasıdır. image: Dosya, .jpeg resim gibi bir resim dosyasıdır. other: Dosya, video dışında başka bir dosya türündedir. project: Dosya, gerçek video verileri içermeyen bir video projesi dosyasıdır (ör. Microsoft Windows Movie Maker projesi). video: Dosya, bilinen bir video dosyası türündedir (ör. .mp4 dosyası).
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 veriler 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 olarak hesaplayabilirsiniz.
fileDetails.videoStreams[].heightPixels	unsigned integer Kodlanmış video içeriğinin piksel cinsinden yüksekliği.
fileDetails.videoStreams[].frameRateFps	double Video akışının kare hızı (saniyedeki kare sayısı).
fileDetails.videoStreams[].aspectRatio	double Video içeriğinin görüntüleme en boy oranı. Bu değer, videonun gösterileceği en boy oranını belirtir.
fileDetails.videoStreams[].codec	string Akışta kullanılan video codec'i.
fileDetails.videoStreams[].bitrateBps	unsigned long Video akışının bit hızı (bit/saniye).
fileDetails.videoStreams[].rotation	string YouTube'un videoyu düzgün şekilde görüntülemek için orijinal kaynak içeriği döndürmesi gereken miktar. Bu özellik 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 baş aşağı döndürülmesi gerekir.
fileDetails.videoStreams[].vendor	string Bir video tedarikçisini benzersiz şekilde tanımlayan değer. Değer genellikle 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 Yayının içerdiği ses kanallarının sayısı.
fileDetails.audioStreams[].codec	string Akışta kullanılan ses codec'i.
fileDetails.audioStreams[].bitrateBps	unsigned long Ses akışının bit hızı (bit/saniye).
fileDetails.audioStreams[].vendor	string Bir video tedarikçisini benzersiz şekilde tanımlayan değer. Değer genellikle 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 saniye başına bit 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 Basit zaman: YYYY-MM-DDTHH:MM:SS Saat dilimiyle saat: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object processingDetails nesnesi, YouTube'un yüklenen video dosyasını işlemedeki ilerleme durumuyla ilgili bilgileri kapsar. Nesnedeki mülkler, mevcut işleme durumunu ve YouTube'un videoyu işlemesine kalan tahmini süreyi tanımlar. Bu bölümde, dosya ayrıntıları veya küçük resimler gibi farklı veri veya içerik türlerinin video için kullanılıp kullanılamayacağını da görebilirsiniz. processingProgress nesnesi, yüklenen videonun YouTube'un yüklenen video dosyasını işlemedeki ilerleme durumunu izleyebilmesi için ankete tabi tutulacak şekilde tasarlanmıştır. Bu verilere yalnızca videonun sahibi erişebilir.
processingDetails.processingStatus	string Videonun işleme durumu. Bu değer, YouTube'un videoyu işleyip işleyemediğini veya videonun hâlâ işlenip işlenmediğini belirtir. Bu mülk için geçerli değerler şunlardır: failed – Video işlenemedi. ProcessingFailureReason değerine bakın. processing: Video şu anda işleniyor. ProcessingProgress'e bakın. succeeded: Video başarıyla işlendi. terminated – İşleme bilgileri artık mevcut değil.
processingDetails.processingProgress	object processingProgress nesnesi, YouTube'un videoyu işleme konusunda kaydettiği ilerlemeyle ilgili bilgileri içerir. Bu değerler yalnızca videonun işleme durumu processing ise geçerlidir.
processingDetails.processingProgress.partsTotal	unsigned long Video için işlenilmesi gereken toplam parça sayısına ilişkin bir tahmin. YouTube videoyu işlerken bu sayı daha kesin tahminlerle güncellenebilir.
processingDetails.processingProgress.partsProcessed	unsigned long Videonun YouTube tarafından işlenen bölümlerinin sayısı. YouTube'un videonun ne kadarını işlediğini tahmin etmek için şunları hesaplayabilirsiniz: 100 * parts_processed / parts_total Tahmini parça sayısı, işlenen parça sayısına karşılık gelmeden artabileceğinden, YouTube bir videoyu işlerken hesaplanan ilerlemenin zaman zaman azalabileceğini unutmayın.
processingDetails.processingProgress.timeLeftMs	unsigned long YouTube'un videoyu işleme sürecini tamamlaması için gereken tahmini süre (milisaniye cinsinden).
processingDetails.processingFailureReason	string YouTube'un videoyu işleyememesinin nedeni. Bu mülkün değeri yalnızca processingStatus mülkünün değeri failed ise geçerli olur. Bu mülk için geçerli değerler şunlardır: other: Diğer bir işleme bileşeni başarısız oldu. streamingFailed: Video, yayıncılara gönderilemedi. transcodeFailed – İçerik kod dönüştürme işlemi başarısız oldu. uploadFailed – Dosya teslim edilemedi.
processingDetails.fileDetailsAvailability	string Bu değer, yüklenen video için dosya ayrıntılarının mevcut olup olmadığını gösterir. videos.list() isteğinizde fileDetails bölümünü isteyerek videonun dosya ayrıntılarını alabilirsiniz.
processingDetails.processingIssuesAvailability	string Bu değer, video işleme motorunun YouTube'un videoyu işleme özelliğini iyileştirecek öneriler, video işleme sorunlarını açıklayan uyarılar veya video işleme sorunlarına neden olan hatalar oluşturup oluşturmadığını belirtir. videos.list() isteğinizde suggestions bölümünü isteyerek bu önerileri alabilirsiniz.
processingDetails.tagSuggestionsAvailability	string Bu değer, video için anahtar kelime (etiket) önerilerinin kullanılıp kullanılamayacağını gösterir. Diğer kullanıcıların videoyu bulmasını kolaylaştırmak için videonun 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ılıp kullanılamayacağını belirtir. 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ı belirtir.
suggestions	object suggestions nesnesi, yüklenen videonun video kalitesini veya meta verilerini iyileştirme fırsatlarını tanımlayan önerileri kapsar. Bu verilere yalnızca videonun sahibi erişebilir. suggestions nesnesi yalnızca processingDetails.tagSuggestionsAvailability veya processingDetails.editorSuggestionsAvailability özelliğinin değeri available ise döndürülür.
suggestions.processingErrors[]	list YouTube'un yüklenen videoyu başarıyla işlemesini engelleyen hataların listesi. Bu hatalar, videonun mevcut işleme durumundan bağımsız olarak, durumunun sonunda neredeyse kesin olarak failed olacağını gösterir. Bu mülk için geçerli değerler şunlardır: archiveFile: 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 resim). notAVideoFile: Video olmayan diğer dosyalar. projectFile – Film projesi dosyası (ör. Microsoft Windows Movie Maker projesi).
suggestions.processingWarnings[]	list YouTube'un yüklenen videoyu kod dönüştürme konusunda sorun yaşamasının veya hatalı kod dönüştürme işlemi yapmasının nedenlerinin listesi. Bu uyarılar, YouTube yüklenen video dosyasını işlemeden önce oluşturulur. Ayrıca, video işlemenin başarısız olacağını göstermeyen ancak senkronizasyon sorunları, video kusurları veya eksik ses parçası gibi sorunlara neden olabilecek sorunları da tanımlar. Bu mülkün geçerli değerleri şunlardır: hasEditlist: Listeleri düzenleme şu anda desteklenmemektedir. inconsistentResolution – Çakışan kapsayıcı ve yayın çözünürlüğü. problematicAudioCodec: Sorunlara neden olduğu bilinen ses codec'i kullanıldı. problematicVideoCodec: Sorunlara neden olduğu bilinen bir video codec'i kullanıldı. unknownAudioCodec: Tanınmayan ses codec'i. Kod dönüştürme işleminin başarısız olma olasılığı yüksektir. unknownContainer – Tanınmayan dosya biçimi. Kod dönüştürme işleminin başarısız olma olasılığı yüksektir. unknownVideoCodec: Tanınmayan video codec'i. Kod dönüştürme işleminin başarısız olma olasılığı yüksektir.
suggestions.processingHints[]	list YouTube'un videoyu işleme yeteneğini artırabilecek önerilerin listesi. Bu mülk için geçerli değerler şunlardır: nonStreamableMov: MP4 dosyası aktarılamaz. Bu durum, işlemeyi yavaşlatır. sendBestQualityVideo: Videonun daha kaliteli bir sürümü olabilir.
suggestions.tagSuggestions[]	list Kullanıcıların YouTube'da arama yaparken veya göz atarken videonuzu bulma olasılığını artırmak için videonun meta verilerine eklenebilecek anahtar kelime etiketlerinin listesi.
suggestions.tagSuggestions[].tag	string Video için önerilen anahtar kelime etiketi.
suggestions.tagSuggestions[].categoryRestricts[]	list Etiketin alakalı olduğu video kategorileri grubu. Bu bilgileri, videoyu yükleyen kullanıcının videoyla ilişkilendirdiği video kategorisine göre uygun etiket önerileri göstermek için kullanabilirsiniz. Anahtar kelime için tanımlanmış kısıtlama yoksa etiket önerileri varsayılan olarak tüm kategorilerle alakalı olur.
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 ve daha kaliteli bir parçayla değiştirilebilir. videoAutoLevels: Resim parlaklığı düzeyleri yanlış görünüyor ve düzeltilebilir. videoCrop: Resmin etrafında algılanan kenarlıklar (matlar) kırpılabilir. videoStabilize: Video titrek görünüyor ve sabitlenebilir.
liveStreamingDetails	object liveStreamingDetails nesnesi, canlı video yayınıyla ilgili meta verileri içerir. Nesne yalnızca video yaklaşan, canlı veya tamamlanmış bir canlı yayınsa video kaynağında bulunur.
liveStreamingDetails.actualStartTime	datetime Yayının gerçekte başladığı zaman. Değer ISO 8601 biçiminde belirtilir. Bu değer, yayın başlayana kadar kullanılamaz.
liveStreamingDetails.actualEndTime	datetime Yayının gerçekte sona erdiği zaman. Değer ISO 8601 biçiminde belirtilir. Bu değer, yayın sona erene kadar kullanılamaz.
liveStreamingDetails.scheduledStartTime	datetime Yayının başlamasının planlandığı zaman. Değer ISO 8601 biçiminde belirtilir.
liveStreamingDetails.scheduledEndTime	datetime Yayının sona ermesinin planlandığı saat. Değer ISO 8601 biçiminde belirtilir. Değer boşsa veya mülk mevcut değilse yayının süresiz olarak devam etmesi planlanır.
liveStreamingDetails.concurrentViewers	unsigned long Yayını şu anda izleyen kullanıcıların sayısı. Yayında şu anda izleyici varsa ve yayın sahibi videonun görüntüleme sayısını gizlemediyse mülk ve değeri gösterilir. YouTube, yayın sona erdiğinde yayındaki eşzamanlı izleyici sayısını izlemeyi durdurur. Bu nedenle, bu özellik, sona eren bir canlı yayının arşivlenmiş videosunu izleyen izleyici sayısını tanımlamaz. YouTube Data API'nin döndürdüğü eşzamanlı izleyici sayıları, YouTube Analytics üzerinden erişilebilen işlenen ve spam'den arındırılan eşzamanlı izleyici sayılarından farklı olabilir. Canlı yayın metrikleri hakkında daha fazla bilgi edinmek için YouTube Yardım Merkezi'ne göz atın.
liveStreamingDetails.activeLiveChatId	string Bu videoya eklenmiş ve şu anda etkin olan canlı sohbetin kimliği. Bu alan yalnızca videoda canlı sohbet olan ve şu anda canlı yayınlanan bir yayın varsa doldurulur. Yayın tamamlandığında bu alan kaldırılır ve canlı sohbet kapatılır. Kalıcı yayınlar için canlı sohbet kimliği artık bu videoya değil, kalıcı sayfada gösterilen yeni videoya bağlanır.
localizations	object localizations nesnesi, videonun meta verilerinin çevirilerini içerir.
localizations.(key)	object Anahtar değeriyle 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ı.