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ıtlamanın kaldırılması için her API projesinin bir denetime tabi tutulması ve projenin Hizmet Şartları'na uygunluğun doğrulanması 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 videolar listesine verdiği derecelendirmeleri alır. Hemen deneyin.
- list
- API istek 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
- Bir videonun meta verilerini günceller. Hemen deneyin.
- sil
- Bir 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.
- reportAbuse
- Kötüye kullanım amaçlı içerik barındırdığı için bir videoyu bildirin. Hemen deneyin.
Kaynak temsili
Aşağıdaki JSON yapısı, 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 olur. |
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 zamanın, 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:
|
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ğeri en fazla 100 karakter uzunluğunda olabilir 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 özellik için bir değer belirlemeniz gerekir. |
snippet.description |
string Videonun açıklaması. Mülk değerinin maksimum uzunluğu 5.000 bayttır ve < ve > 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ı 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:
|
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ırlamasının hesaplanma şekliyle ilgili aşağıdaki kurallara dikkat edin:
|
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ı belirtir. Video, yaklaşan/etkin bir canlı yayın değilse "none" değerini alır. Bu mülk için geçerli değerler şunlardır:
|
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 verilerinin varsayılan dildeki başlığını içerir.
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 videoda altyazı olup olmadığına dair 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ğunda ve bir saatten kısa bir video için süre PT#M#S biçimindedir. Burada PT harfleri değerin bir süreyi belirttiğini, M ve S harfleri ise dakika ve saniye cinsinden uzunluğu ifade eder. M ve S harflerinden önceki # karakterleri, videonun dakika sayısını (veya saniyesini) belirten tamsayı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çiminde olur. Burada, H harfinin önündeki # , videonun uzunluğunu saat cinsinden belirtir ve diğer tüm ayrıntılar da yukarıda açıklanan şekildedir. Video en az bir gün uzunluğundaysa P ve T harfleri ayrılır ve değer 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 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 sunulduğunu belirtir.Bu özellik için geçerli değerler şunlardır:
|
contentDetails.caption |
string Videoda altyazı bulunup bulunmadığını gösterir. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.licensedContent |
boolean Videonun lisanslı içeriği temsil edip etmediğini gösterir. Bu, içeriğin bir YouTube içerik iş ortağına bağlı bir kanala yüklendiği ve ardından bu iş ortağı tarafından hak talebinde bulunulduğu anlamına gelir. |
contentDetails.regionRestriction |
object regionRestriction nesnesi, bir videonun görüntülenebildiği (veya görüntülenemediği) ülkeler hakkında bilgiler 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 tesis mevcutsa ve değerinde bir ülke listelenmiyorsa videonun bu ülkede gösterilmesi engellenir. Bu tesis 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 değerinde bir ülke 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üzenlerine göre aldığı derecelendirmeleri belirtir. |
contentDetails.contentRating.acbRating |
string Videonun Avustralya Sınıflandırma Kurulu (ACB) veya Avustralya İletişim ve Medya Kurumu (ACMA) derecelendirmeleri. 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:
|
contentDetails.contentRating.agcomRating |
string İtalya'daki Autorità per le Garanzie nelle Comunicazioni (AGCOM) sitesinde videonun derecelendirmesi: Bu tesis için geçerli değerler:
|
contentDetails.contentRating.anatelRating |
string Videonun Şili televizyonu için Anatel (Asociación Nacional de Televisión) puanı. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.bbfcRating |
string Videonun British Board of Film Classification (BBFC) derecelendirmesidir. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.bfvcRating |
string Videonun, Tayland Film ve Video Sansürleri Kurulu'nun aldığı derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.bmukkRating |
string Videonun Avusturya Medya Sınıflandırma Kurulu (Bundesministerium für Unterricht, Kunst und Kultur) derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.catvRating |
string Kanada TV'si için derecelendirme sistemi - Kanada TV Sınıflandırma Sistemi, Kanada'daki İngilizce yayınlar için Kanada Radyo-Televizyon ve Telekomünikasyon Komisyonu'nun (CRTC) verdiği derecelendirme. Daha fazla bilgi için Kanada Yayın Standartları Konseyi web sitesini ziyaret edin. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.catvfrRating |
string Videonun Kanada Radyo-Televizyon ve Telekomünikasyon Komisyonu'nun (CRTC) Kanada'daki Fransızca yayınlar için belirlediği derecelendirme. Daha fazla bilgi için Kanada Yayın Standartları Konseyi web sitesini ziyaret edin. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.cbfcRating |
string Videonun Merkez Film Sertifikasyonu Kurulu (CBFC - Hindistan) puanı. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.cccRating |
string Videonun Consejo de Calificación Cinematográfica (Şili) puanı. Bu mülk için geçerli değerler şunlardır:
|
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:
|
contentDetails.contentRating.chfilmRating |
string Videonun İsviçre'deki derecelendirmesi. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.chvrsRating |
string Videonun Kanada Ev Videosu Derecelendirme Sistemi (CHVRS) derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.cicfRating |
string Videonun Commission de Contrôle des Films (Belçika) derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.cnaRating |
string Videonun Romanya CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.cncRating |
string Fransa'da derecelendirme sistemi - Commission deClassification sinematographique Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.csaRating |
string France's Conseil supérieur de l?audiovisuel'in videonun, yayın içeriğini derecelendiren puanı. Bu tesis için geçerli değerler:
|
contentDetails.contentRating.cscfRating |
string Videonun, Lüksemburg Komisyonu'ndaki Commission de surveillance de laClassification des films (CSCF) derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.czfilmRating |
string Videonun Çek Cumhuriyeti'ndeki puanı. Bu tesis için geçerli değerler şunlardır:
|
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 şunlardır:
|
contentDetails.contentRating.djctqRatingReasons[] |
list Videonun DJCQT (Brezilya) derecelendirmesi neden aldığını açıklayan nedenler. |
contentDetails.contentRating.ecbmctRating |
string Türkiye'de derecelendirme sistemi - Kültür ve Turizm Bakanlığının Değerlendirme ve Sınıflandırma Kurulu Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.eefilmRating |
string Videonun Estonya'daki derecelendirmesi. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.egfilmRating |
string Videonun Mısır'daki derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.eirinRating |
string Videonun Eirin (映倫) derecelendirmesi. Eirin, Japon derecelendirme sistemidir. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.fcbmRating |
string Videonun Malezya Film Sansürü Kurulu'ndan alınan derecelendirme. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.fcoRating |
string Hong Kong Film, Gazete ve Makale İdaresi Ofisi'nin video derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.fmocRating |
string Bu özellik 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ığı) puanı. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.fpbRating |
string Güney Afrika Film ve Yayın Kurulu'ndan videonun derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.fpbRatingReasons[] |
list Videonun neden FPB (Güney Afrika) derecelendirmesini 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:
|
contentDetails.contentRating.grfilmRating |
string Videonun Yunanistan'daki derecelendirmesi. Bu tesis için geçerli değerler:
|
contentDetails.contentRating.icaaRating |
string Videonun Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - İspanya) puanı. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.ifcoRating |
string Videonun İrlanda Film Sınıflandırma Ofisi (IFCO - İrlanda) derecelendirmesi. Daha fazla bilgi için IFCO web sitesini ziyaret edin. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.ilfilmRating |
string Videonun İsrail'deki derecelendirmesi. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.incaaRating |
string Videonun INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Arjantin) puanı. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.kfcbRating |
string Videonun Kenya Film Classification Board'daki derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (Hollanda). Bu özellik için geçerli değerler şunlardır:
|
contentDetails.contentRating.kmrbRating |
string Videonun Kore Medya Derecelendirme Kurulu (以물물등ORDERED사니니니) derecelendirmesi. KMRB, Güney Kore'deki videoları ücretlendiriyor. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.lsfRating |
string Videonun Endonezya'daki Lembaga Sensor Film'deki derecelendirmesi. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.mccaaRating |
string Videonun, Malta Film Yaş Sınıflandırma Kurulu tarafından aldığı derecelendirme. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.mccypRating |
string Videonun, Danimarka Film Enstitüsü'nün (Det Danske Filminstitut) Çocuklar ve Gençler için Medya Konseyi'ndeki derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.mcstRating |
string Videonun Vietnam - MCST için derecelendirme sistemi Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.mdaRating |
string Videonun Singapur Medya Geliştirme Kurumu (MDA) ve özellikle Film Censors Board of Film Censors (BFC) derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.medietilsynetRating |
string Videonun, Norveç Medya Kurumu Medietilsynet'deki derecelendirmesi. Bu mülk için geçerli değerler:
|
contentDetails.contentRating.mekuRating |
string Videonun Finlandiya'daki Kansallinen Audiovisuaalinen Instituutti (Ulusal Görsel İşitsel Enstitüsü) değerlendirmesinden alınan puan. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.mibacRating |
string Videonun derecelendirmesi Ministero dei Beni e delle Attività Culturali e del Turismo (İtalya) tarafından verilmiş. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.mocRating |
string Videonun Ministerio de Cultura (Kolombiya) puanı. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.moctwRating |
string Videonun Tayvan Kültür Bakanlığı'ndan (kısmında 化部) derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.mpaaRating |
string Videonun Sinema Filmleri Derneği (MPAA) puanı. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.mpaatRating |
string Motion Picture Association of America'nın film fragmanları ve önizlemesi için verdiği derecelendirme. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.mtrcbRating |
string Videonun Sinema ve Televizyon İnceleme ve Sınıflandırma Kurulu'ndan (Filipinler) aldığı derecelendirme. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.nbcRating |
string Videonun, Maldivler Ulusal Sınıflandırma Bürosu'nun derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.nfrcRating |
string Videonun Bulgaristan Ulusal Film Merkezi'ndeki derecelendirmesi. Bu tesis için geçerli değerler:
|
contentDetails.contentRating.nfvcbRating |
string Videonun Nijerya Ulusal Film ve Video Sansürleri Kurulu'nun verdiği derecelendirme. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.nkclvRating |
string Videonun, Nacionãlais Kino sentri'nden (Letonya Ulusal Film Merkezi) puanı. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.oflcRating |
string Videonun Ofisi Film ve Edebiyat Sınıflandırması (OFLC - Yeni Zelanda) derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.pefilmRating |
string Videonun Peru'daki puanı. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.resorteviolenciaRating |
string Videonun Venezuela'daki derecelendirmesi. Bu tesis için geçerli değerler şunlardır:
|
contentDetails.contentRating.rtcRating |
string Videonun Radyo, Televizyon ve Sinematografi Genel Müdürlüğü (Meksika) puanı. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.rteRating |
string Videonun puanı İrlanda'lı Raidió Teilifís Éireann sitesinde. Bu tesis için geçerli değerler:
|
contentDetails.contentRating.russiaRating |
string Videonun Rusya Federasyonu Ulusal Film Tescili (MKRF - Rusya) derecelendirmesine sahip. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.skfilmRating |
string Videonun Slovakya'daki puanı. Bu tesis için geçerli değerler:
|
contentDetails.contentRating.smaisRating |
string Videonun İzlanda'daki derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.smsaRating |
string Videonun Statens medieråd (İsveç Ulusal Medya Konseyi) derecelendirmesi. Bu mülk için geçerli değerler:
|
contentDetails.contentRating.tvpgRating |
string Videonun TV Ebeveyn Yönergeleri (TVPG) derecelendirmesi. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.contentRating.ytRating |
string YouTube'un yaş kısıtlaması olan içerikleri belirlemek için kullandığı bir derecelendirme. Bu mülk için geçerli değerler şunlardır:
|
contentDetails.projection |
string Videonun projeksiyon biçimini belirtir. Bu özellik için geçerli değerler şunlardır:
|
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 videoyu yükleyen kullanıcı görebilir. |
status |
object status nesnesi, videonun yüklenmesi, işlenmesi ve gizlilik durumuyla ilgili bilgiler içerir. |
status.uploadStatus |
string Yüklenen videonun durumu. Bu mülk için geçerli değerler şunlardır:
|
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:
|
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:
|
status.privacyStatus |
string Videonun gizlilik durumu. Bu mülk için geçerli değerler şunlardır:
|
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:
|
status.license |
string Videonun lisansı. Bu mülk için geçerli değerler şunlardır:
|
status.embeddable |
boolean Bu değer, videonun başka bir web sitesine yerleştirilip yerleştirilemeyeceğini gösterir. |
status.publicStatsViewable |
boolean Bu değer, videonun izleme sayfasındaki genişletilmiş video istatistiklerinin herkese açık olarak görüntülenip görüntülenemeyeceğini ifade eder. Varsayılan olarak bu istatistikler görüntülenebilirdir. 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ı 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 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 hâle getirildi. Bu, mülkün yalnızca API isteğinin video sahibi tarafından kimliği doğrulandığı takdirde 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ıdır. |
statistics.favoriteCount |
unsigned long Not: Bu özellik kullanımdan kaldırılmıştır. Kullanımdan kaldırma, 28 Ağustos 2015 tarihinden itibaren geçerlidir. Bu özelliğin değeri artık her zaman 0 olarak ayarlandı. |
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. |
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 belirtilmiş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 belirtilmiş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 yapılacak değişiklikler hakkında daha fazla bilgi edinmek 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 özellik 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şkilendirilmiş tüm konular topicDetails.relevantTopicIds[] özellik değeri tarafından döndürülür. |
topicDetails.relevantTopicIds[] |
list Video ile alakalı konu kimliklerinin listesi. Bu özellik 10 Kasım 2016 itibarıyla kullanımdan kaldırılmıştır. Bu özellik 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 dönemde, YouTube az sayıda seçilmiş konu kimliği 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 özellik 1 Haziran 2017 itibarıyla 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 bilgisi. 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 özellik 1 Haziran 2017 itibarıyla 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 özellik 1 Haziran 2017 itibarıyla 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 özellik 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 elipsoitin üzerindeki rakım (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 (dosyanın çözünürlüğü, süresi, ses ve video codec'leri, akış bit hızları vb.) 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ı veya başka türde bir dosya yüklenip yüklenmediğine bakılmaksızın bulunur. |
fileDetails.fileSize |
unsigned long Yüklenen dosyanın bayt cinsinden boyutu. Bu alan, bir video dosyası veya başka türde bir dosya yüklenip yüklenmediğine bakılmaksızın bulunur. |
fileDetails.fileType |
string Yüklenen dosyanın, YouTube'un video işleme motoru tarafından algılanan türü. Şu anda YouTube yalnızca video dosyalarını işlemektedir ancak bu alan ister video dosyası ister başka türde bir dosya yüklenmişse bulunur. Bu mülk için geçerli değerler şunlardı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 kare hızı (saniyedeki kare sayısı). |
fileDetails.videoStreams[].aspectRatio |
double Video içeriğinin, videonun görüntülenmesi gereken en boy oranını belirten ekran en boy oranı. |
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). |
fileDetails.videoStreams[].rotation |
string Videoyu düzgün bir şekilde görüntülemek için YouTube'un orijinal kaynak içeriği döndürmesi gereken miktar. Bu mülk için geçerli değerler şunlardır:
|
fileDetails.videoStreams[].vendor |
string Video tedarikçi firmasını benzersiz şekilde tanımlayan bir değerdir. Değer, genellikle dört harfli bir tedarikçi firma 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 verileri içerir. |
fileDetails.audioStreams[].channelCount |
unsigned integer Yayının içerdiği 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çi firmasını benzersiz şekilde tanımlayan bir değerdir. Değer, genellikle dört harfli bir tedarikçi firma 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:
|
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 bitirmesine kalan tahmini süreyi tanımlar. Bu bölüm, video için dosya ayrıntıları veya küçük resimler gibi farklı veri veya içerik türlerinin mevcut olup olmadığını da belirtir.processingProgress nesnesi, yüklenen videonun YouTube'un yüklenen video dosyasını işlerken kaydettiği ilerlemeyi izleyebilmesi için anket yapılacak ş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:
|
processingDetails.processingProgress |
object processingProgress nesnesi, YouTube'un videoyu işleme sürecinde kaydettiği ilerlemeyle ilgili bilgiler içerir. Değerler yalnızca videonun işlenme durumu processing ise alakalıdır. |
processingDetails.processingProgress.partsTotal |
unsigned long Video için işlenmesi gereken toplam parça sayısına dair bir tahmin. YouTube videoyu işlerken sayı daha kesin tahminlerle güncellenebilir. |
processingDetails.processingProgress.partsProcessed |
unsigned long Videonun YouTube'un önceden işlediği bölümlerin sayısı. YouTube'un işleme koyduğu videonun yüzdesini şu hesaplamaları yaparak tahmin edebilirsiniz: 100 * parts_processed / parts_total Tahmini parça sayısı, işlenmiş parça sayısında buna karşılık gelen bir artış olmadan artabileceği için YouTube 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 ise değer içerir.Bu özellik için geçerli değerler şunlardır:
|
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 becerisini 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ı gösterir. Bu önerileri, videos.list() isteğinizde suggestions bölümünü isteyerek 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. Bu önerileri, videos.list() isteğinizde suggestions bölümünü isteyerek alabilirsiniz. |
processingDetails.editorSuggestionsAvailability |
string Bu değer, video kalitesini veya oynatma deneyimini iyileştirebilecek video düzenleme önerilerinin videoda kullanılıp kullanılamadığını gösterir. Bu önerileri, videos.list() isteğinizde suggestions bölümünü isteyerek alabilirsiniz. |
processingDetails.thumbnailsAvailability |
string Bu değer, video için küçük resim görüntülerinin 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, nihayetinde bu durumun neredeyse kesinlikle failed olacağını gösterir.Bu mülk için geçerli değerler şunlardır:
|
suggestions.processingWarnings[] |
list YouTube'un yüklenen videonun kodunu dönüştürmekte zorluk yaşamasının veya hatalı bir kod dönüştürme işlemiyle sonuçlanabilecek 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:
|
suggestions.processingHints[] |
list YouTube'un videoyu işleme becerisini geliştirebilecek önerilerin listesi. Bu mülk için geçerli değerler şunlardı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 etiketleri 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örüntülemek için kullanabilirsiniz. Varsayılan olarak, anahtar kelime için tanımlanmış hiç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:
|
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 yer alır. |
liveStreamingDetails.actualStartTime |
datetime Yayının fiilen 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 fiilen 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şlamasının planlandığı zaman. Değer, ISO 8601 biçiminde belirtilir. |
liveStreamingDetails.scheduledEndTime |
datetime Yayının sona ermesinin planlandığı zaman. Değer, ISO 8601 biçiminde belirtilir. Değer boşsa veya özellik mevcut değilse 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 geçerli izleyicileri varsa ve yayın sahibi videonun görüntüleme sayısını gizlemediyse özellik ve değeri gösterilir. YouTube, yayın sona erdiğinde yayını eşzamanlı görüntüleyen sayısını izlemeyi durdurur. Dolayısıyla bu mülk, sona ermiş bir canlı yayının arşivlenmiş videosunu izleyen izleyicilerin 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'nden canlı yayın metrikleri hakkında daha fazla bilgi edinebilirsiniz.
|
liveStreamingDetails.activeLiveChatId |
string Şu anda etkin olan canlı sohbetin bu videoya ekli kimliği. Bu alan, yalnızca videonun canlı sohbet içeren canlı bir yayın olması durumunda doldurulur. Yayının tamamlanacağı geçişten sonra bu alan kaldırılacak ve canlı sohbet kapatılacak. Kalıcı yayınlarda, 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ğerle ilişkili yerelleştirilmiş metnin dili. Bu 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ı. |