Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Videos

28 Temmuz 2020'den sonra oluşturulan doğrulanmamış API projelerinden videos.insert uç noktası aracılığıyla yüklenen tüm videoların görüntüleme modu gizli olarak ayarlanacak. Bu kısıtlamanın kaldırılması için her API projesinin Hizmet Şartları'na uygunluğunu doğrulamak üzere denetlenmesi gerekir. Daha fazla bilgi için lütfen API Revision History (API Revizyon Geçmişi) bölümü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 bir video listesine verdiği puanları alır. Hemen deneyin.
list: API isteği parametreleriyle eşleşen videoların listesini döndürür. Hemen deneyin.
batchGetStats: API isteği parametreleriyle eşleşen video istatistiklerinin listesini alır. Hemen deneyin.
insert (ekle): YouTube'a video yükler ve isteğe bağlı olarak videonun meta verilerini ayarlar.
update: Bir videonun meta verilerini günceller. Hemen deneyin.
delete: YouTube videosunu siler. Hemen deneyin.
rate: Videolara beğenme veya beğenmeme puanı ekleyebilir ya da videolardan puan kaldırabilirsiniz. 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ı, 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,
    "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'i.

id string
YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimlik.

snippet object
snippet nesnesi, videoyla ilgili temel ayrıntıları (ör. başlık, açıklama ve kategori) içerir.

snippet.publishedAt

datetime
Videonun yayınlandığı tarih ve saat. Bu sürenin, videonun yüklendiği süreden farklı olabileceğini unutmayın. Örneğin, bir video gizli olarak yüklenip 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 video olarak yüklenir ve video meta verileri kanal sahibi tarafından alınırsa özellik değeri, videonun yüklendiği tarihi ve saati belirtir.
Liste dışı video olarak yüklenen videolarda özellik değeri, videonun yüklendiği tarihi ve saati de belirtir. Bu durumda, videonun benzersiz video kimliğini bilen herkes video meta verilerini alabilir.

Değer, ISO 8601 biçiminde belirtilir.

snippet.channelId string
YouTube'un, videonun yüklendiği kanalı benzersiz şekilde tanımlamak için kullandığı kimlik.

snippet.title string
Videonun başlığı. Özellik değeri en fazla 100 karakter uzunluğunda olabilir ve < ile > hariç tüm geçerli UTF-8 karakterlerini içerebilir. videos.update yöntemini çağırıp video kaynağının snippet bölümünü güncelliyorsanız bu özellik için bir değer ayarlamanız gerekir.

snippet.description string
Videonun açıklaması. Özellik değeri en fazla 5.000 bayt uzunluğunda olabilir ve < ve > hariç tüm geçerli UTF-8 karakterlerini içerebilir.

snippet.thumbnails object
Videoyla ilişkili küçük resimlerin haritası. Haritadaki her nesnenin anahtarı, küçük resim dosyasının adıdır. Değer ise 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 video veya videoya referans veren bir kaynak (ör. oynatma listesi öğesi ya da arama sonucu) için varsayılan küçük resim 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Bir kanalı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ü. Video (veya videoya atıfta bulunan bir kaynak) 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ü versiyonu. Video (veya videoya atıfta bulunan bir kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanal için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir.
standard: Küçük resmin, high çözünürlüklü resimden daha yüksek çözünürlüklü bir sürümüdür. Bu resim, bazı videolar ve videolara referans veren diğer kaynaklar (ör. oynatma listesi öğeleri veya arama sonuçları) için 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ü versiyonu. Bu resim boyutu, bazı videolar ve videolara referans veren 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. Özellik değeri en fazla 500 karakter uzunluğunda olabilir. Karakter sınırının hesaplanmasıyla ilgili aşağıdaki kurallara dikkat edin:

Özellik değeri bir listedir 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şaretleri içine alınmış gibi işler ve tırnak işaretleri karakter sınırına dahil edilir. Bu nedenle, karakter sınırları açısından Foo-Baz etiketi yedi karakter, Foo Baz etiketi ise dokuz karakter içerir.

snippet.categoryId string
Videoyla ilişkili YouTube video kategorisi. videos.update yöntemini çağırıyorsanız ve 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 değeri none olur.

Bu özellik için geçerli değerler şunlardır:

live
none
upcoming

snippet.defaultLanguage string
video kaynağının snippet.title ve snippet.description özelliklerindeki metnin dili.

snippet.localized

object
snippet.localized nesnesi, videonun meta verileri için videonun yerelleştirilmiş başlığını ve açıklamasını ya da varsayılan dildeki başlığını içerir.

videos.list isteğinde, yerelleştirilmiş metnin döndürülmesi gereken bir dil belirtmek için hl parametresi kullanıldıysa ve bu dilde yerelleştirilmiş metin varsa yerelleştirilmiş metin kaynak snippet'inde döndürülür.
Bir hl parametre değeri belirtilmemişse veya bir değer belirtilmiş ancak belirtilen dil için yerelleştirilmiş meta veriler mevcut değilse varsayılan dilin meta verileri döndürülür.

Özellik, salt okunur bir değer içeriyor. Yerelleştirilmiş başlıkları eklemek, güncellemek veya silmek için localizations nesnesini kullanın.

snippet.localized.title string
Yerelleştirilmiş video başlığı.

snippet.localized.description string
Yerelleştirilmiş video açıklaması.

snippet.defaultAudioLanguage string
default_audio_language özelliği, videonun varsayılan ses parçasında konuşulan dili belirtir.

contentDetails object
contentDetails nesnesi, video içeriğiyle ilgili bilgileri (ör. videonun uzunluğu ve videoda altyazıların kullanılıp kullanılamadığı) içerir.

contentDetails.duration string
Videonun uzunluğu. Özellik değeri, ISO 8601 süresidir. Örneğin, süresi en az bir dakika ve bir saatten kısa olan bir videonun süresi PT#M#S biçimindedir. Burada PT harfleri değerin bir zaman aralığını belirttiğini, M ve S harfleri ise sırasıyla dakika ve saniye cinsinden uzunluğu ifade eder. M ve S harflerinden önceki # 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. H harfinden önceki #, videonun uzunluğunu saat cinsinden belirtir. Diğer tüm ayrıntılar yukarıda açıklandığı gibidir. 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 veya 2D olarak kullanılabilir olup olmadığını belirtir.

contentDetails.definition

string
Videonun yüksek çözünürlükte (HD) mi yoksa yalnızca standart çözünürlükte mi sunulduğunu belirtir.

Bu özellik 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çeriği temsil edip etmediğini gösterir. Lisanslı içerik, YouTube içerik iş ortağına bağlı bir kanala yüklenip bu iş ortağı tarafından hak talebinde bulunulan içerik anlamına gelir.

contentDetails.regionRestriction object
regionRestriction nesnesi, bir videonun görüntülenebildiği (veya görüntülenemediği) ülkelerle ilgili bilgileri içerir. Nesne, contentDetails.regionRestriction.allowed özelliğini 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 varsa ve değerinde bir ülke listelenmiyorsa videonun o ü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 varsa ve değerinde bir ülke listelenmiyorsa 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 şemaları kapsamında aldığı derecelendirmeleri belirtir.

contentDetails.contentRating.acbRating

string
Videonun Avustralya Sınıflandırma Kurulu (ACB) veya Avustralya İletişim ve Medya Kurumu (ACMA) derecelendirmesi. ACMA derecelendirmeleri, çocuklara yönelik televizyon programlarını sınıflandırmak için kullanılır.

Bu özellik için geçerli değerler şunlardır:

acbC – Avustralya İletişim ve Medya Kurumu tarafından C sınıflandırması 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ğdaki çocuklara yöneliktir.
acbPg – PG
acbR18plus – R18+
acbUnrated

contentDetails.contentRating.agcomRating

string
İtalya'daki Autorità per le Garanzie nelle Comunicazioni (AGCOM) tarafından verilen video derecelendirmesi.

Bu özelliğin geçerli değerleri şunlardır:

agcomT – T
agcomUnrated
agcomVm14 – VM14
agcomVm18 – VM18

contentDetails.contentRating.anatelRating

string
Videonun Şili televizyonu için Anatel (Asociación Nacional de Televisión) derecelendirmesi.

Bu özelliğin geçerli değerleri şunlardır:

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 özellik 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
Tayland Film ve Video Sansür Kurulu'nun videoya verdiği derecelendirme.

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'nun (Bundesministerium für Unterricht, Kunst und Kultur) verdiği derecelendirme.

Bu özelliğin geçerli değerleri şunlardır:

bmukk10 – 10+
bmukk12 – 12 yaş ve üzeri
bmukk14 – 14 yaş ve üzeri
bmukk16 – 16 yaş ve üzeri
bmukk6 – 6 yaş ve üzeri
bmukk8 – 8 yaş ve üzeri
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 Radyo-Televizyon ve Telekomünikasyon Komisyonu'nun (CRTC) Kanada'daki İngilizce yayınlar için verdiği derecelendirme. Daha fazla bilgi için Canadian Broadcast Standards Council web sitesine bakın.

Bu özelliğin geçerli değerleri şunlardır:

catv14plus – 14 yaş ve üzeri
catv18plus – 18 yaş ve üzeri
catvC – C
catvC8 – C8
catvG – G
catvPg – PG
catvUnrated

contentDetails.contentRating.catvfrRating

string
Kanada'da Fransızca yayınlar için Kanada Radyo ve Televizyon Komisyonu'nun (CRTC) videoya verdiği derecelendirme. Daha fazla bilgi için Canadian Broadcast Standards Council web sitesine bakın.

Bu özelliğin geçerli değerleri şunlardır:

catvfr13plus – 13 yaş ve üzeri
catvfr16plus – 16 yaş ve üzeri
catvfr18plus – 18 yaş ve üzeri
catvfr8plus – 8 yaş ve üzeri
catvfrG – G
catvfrUnrated

contentDetails.contentRating.cbfcRating

string
Videonun Central Board of Film Certification (CBFC - Hindistan) derecesi.

Bu özelliğin geçerli değerleri şunlardır:

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) derecesi.

Bu özelliğin geçerli değerleri şunlardır:

ccc14 – 14 yaş ve üzeri
ccc18 – 18 yaş ve üzeri
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
Portekiz'deki Comissão de Classificação de Espect´culos'un videoya verdiği derecelendirme.

Bu özelliğin geçerli değerleri şunlardır:

cceM12 – 12
cceM14 – 14
cceM16 – 16
cceM18 – 18
cceM4 – 4
cceM6 – 6
cceUnrated

contentDetails.contentRating.chfilmRating

string
İsviçre'deki videonun derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:

chfilm0 – 0
chfilm12 – 12
chfilm16 – 16
chfilm18 – 18
chfilm6 – 6
chfilmUnrated

contentDetails.contentRating.chvrsRating

string
Videonun Kanada Ev Video Derecelendirme Sistemi (CHVRS) derecelendirmesi.

Bu özellik 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
Commission de Contrôle des Films (Belçika) tarafından verilen video derecelendirmesi.

Bu özelliğin geçerli değerleri şunlardır:

cicfE – E
cicfKntEna – KNT/ENA
cicfKtEa – KT/EA
cicfUnrated

contentDetails.contentRating.cnaRating

string
Romanya'daki CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) tarafından verilen video derecelendirmesi.

Bu özellik için geçerli değerler:

cna12 – 12
cna15 – 15
cna18 – 18
cna18plus – 18 yaş ve üzeri
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
Yayın içeriğini derecelendiren Fransa'daki Conseil supérieur de l'audiovisuel'in videoya verdiği derecelendirme.

Bu özelliğin geçerli değerleri şunlardır:

csa10 – 10
csa12 – 12
csa16 – 16
csa18 – 18
csaInterdiction – Yasaklama
csaT – T
csaUnrated

contentDetails.contentRating.cscfRating

string
Lüksemburg'daki Commission de surveillance de la classification des films (CSCF) tarafından verilen video 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
Çekya'daki videonun 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 özellik için geçerli değerler şunlardır:

djctq10 – 10
djctq12 – 12
djctq14 – 14
djctq16 – 16
djctq18 – 18
djctqL – L
djctqUnrated

contentDetails.contentRating.djctqRatingReasons[] list
Videonun DJCQT (Brezilya) derecelendirmesini neden aldığına dair açıklamalar.

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 yaş ve üzeri
ecbmct15a – 15A
ecbmct15plus – 15 yaş ve üzeri
ecbmct18plus – 18 yaş ve üzeri
ecbmct7a – 7A
ecbmct7plus – 7+
ecbmctG – G
ecbmctUnrated
ecbmct6a – 6A
ecbmct6plus – 6 yaş ve üzeri
ecbmct10a – 10A
ecbmct10plus – 10+
ecbmct16plus – 16 yaş ve üzeri

contentDetails.contentRating.eefilmRating

string
Estonya'daki videonun derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:

eefilmK12 – K-12
eefilmK14 – K-14
eefilmK16 – K-16
eefilmK6 – K-6
eefilmL – L
eefilmMs12 – MS-12
eefilmMs6 – MS-6
eefilmPere – Pere
eefilmUnrated

contentDetails.contentRating.egfilmRating

string
Mısır'daki videonun derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:

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
Malezya Film Sansür Kurulu'nun videoya verdiği derecelendirme.

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
Hong Kong'daki Film, Gazete ve Makale Yönetimi Ofisi'nin videoya verdiği derecelendirme.

Bu özelliğin geçerli değerleri ş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 özelliğini kullanın.

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

Bu özelliğin geçerli değerleri şunlardır:

fmoc10 – 10
fmoc12 – 12
fmoc16 – 16
fmoc18 – 18
fmocE – E
fmocU – U
fmocUnrated

contentDetails.contentRating.fpbRating

string
Güney Afrika'daki Film ve Yayın Kurulu'nun videoya verdiği derecelendirme.

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 neden FPB (Güney Afrika) derecelendirmesi aldığını açıklayan nedenler.

contentDetails.contentRating.fskRating

string
Videonun Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Almanya) derecelendirmesi.

Bu özelliğin geçerli değerleri şunlardır:

fsk0 – FSK 0
fsk12 – FSK 12
fsk16 – FSK 16
fsk18 – FSK 18
fsk6 – FSK 6
fskUnrated

contentDetails.contentRating.grfilmRating

string
Yunanistan'daki videonun derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:

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 özellik için geçerli değerler şunlardır:

icaa12 – 12
icaa13 – 13
icaa16 – 16
icaa18 – 18
icaa7 – 7
icaaApta – APTA
icaaUnrated
icaaX – X

contentDetails.contentRating.ifcoRating

string
Videonun İrlanda Film Sınıflandırma Ofisi (IFCO - İrlanda) derecelendirmesi. Daha fazla bilgi için IFCO web sitesini ziyaret edin.

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
İsrail'deki videonun 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) derecesi.

Bu özellik 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
Kenya Film Classification Board'un videoya verdiği derecelendirme.

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 özellik 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 şunlardır:

kmrb12plus – 12세 이상 관람가
kmrb15plus – 15세 이상 관람가
kmrbAll – 전체관람가
kmrbR – 청소년 관람불가
kmrbTeenr
kmrbUnrated

contentDetails.contentRating.lsfRating

string
Endonezya'daki Lembaga Sensor Film'in videoya verdiği derecelendirme.

Bu özellik 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
Malta'daki Film Yaş Sınıflandırma Kurulu'nun videoya verdiği derecelendirme.

Bu özellik için geçerli değerler şunlardır:

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ıldı.
mccaa18 – 18
mccaaPg – PG
mccaaU – U
mccaaUnrated

contentDetails.contentRating.mccypRating

string
Danimarka Film Enstitüsü'nün (Det Danske Filminstitut) Çocuk ve Gençler için Medya Konseyi'nin videoya verdiği derecelendirme.

Bu özellik için geçerli değerler şunlardır:

mccyp11 – 11
mccyp15 – 15
mccyp7 – 7
mccypA – A
mccypUnrated

contentDetails.contentRating.mcstRating

string
Vietnam'daki videolar için derecelendirme sistemi - MCST

Bu özellik için geçerli değerler:

mcst0 – 0
mcst16plus – 16 yaş ve üzeri
mcstC13 – C13
mcstC16 – C16
mcstC18 – C18
mcstP – P
mcstUnrated
mcstT13 – T13
mcstT16 – T16
mcstT18 – T18
mcstK – K

contentDetails.contentRating.mdaRating

string
Singapur'daki Medya Geliştirme Kurumu (MDA) ve özellikle de Film Sansür Kurulu (BFC) tarafından verilen video derecelendirmesi.

Bu özellik 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
Norveç Medya Kurumu Medietilsynet'in videoya verdiği derecelendirme.

Bu özellik için geçerli değerler şunlardır:

medietilsynet11 – 11
medietilsynet12 – 12
medietilsynet15 – 15
medietilsynet18 – 18
medietilsynet6 – 6
medietilsynet7 – 7
medietilsynet9 – 9
medietilsynetA – A
medietilsynetUnrated

contentDetails.contentRating.mekuRating

string
Finlandiya'daki Kansallinen Audiovisuaalinen Instituutti'nin (Ulusal Görsel-İşitsel Enstitü) videoya verdiği derecelendirme.

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
Ministero dei Beni e delle Attività Culturali e del Turismo (İtalya) tarafından verilen videonun derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:

mibacT
mibacUnrated
mibacVap
mibacVm6
mibacVm12
mibacVm14
mibacVm18

contentDetails.contentRating.mocRating

string
Videoya verilen Ministerio de Cultura (Kolombiya) derecesi.

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
Tayvan Kültür Bakanlığı'nın (文化部) videoya verdiği derecelendirme.

Bu özellik 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 özellik 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
Film fragmanları ve önizlemeleri için Motion Picture Association of America'nın derecelendirmesi.

Bu özelliğin geçerli değerleri şunlardır:

mpaatGb – GB (Yeşil Bant - Tüm kitleler için uygun)
mpaatRb – RB (Red Band - Recommended for ages 17+)

contentDetails.contentRating.mtrcbRating

string
Filmler ve Televizyon İnceleme ve Sınıflandırma Kurulu'nun (Filipinler) videoya verdiği derecelendirme.

Bu özelliğin geçerli değerleri ş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 verdiği video derecelendirmesi.

Bu özellik için geçerli değerler:

nbc12plus – 12 yaş ve üzeri
nbc15plus – 15 yaş ve üzeri
nbc18plus – 18 yaş ve üzeri
nbc18plusr – 18+R
nbcG – G
nbcPg – PG
nbcPu – PU
nbcUnrated

contentDetails.contentRating.nfrcRating

string
Bulgaristan Ulusal Film Merkezi'nin videoya verdiği derecelendirme.

Bu özellik için geçerli değerler:

nfrcA – A
nfrcB – B
nfrcC – C
nfrcD – D
nfrcUnrated
nfrcX – X

contentDetails.contentRating.nfvcbRating

string
Nijerya Ulusal Film ve Video Sansür Kurulu'nun videoya verdiği derecelendirme.

Bu özellik için geçerli değerler:

nfvcb12 – 12
nfvcb12a – 12A
nfvcb15 – 15
nfvcb18 – 18
nfvcbG – G
nfvcbPg – PG
nfvcbRe – RE
nfvcbUnrated

contentDetails.contentRating.nkclvRating

string
Nacionãlais Kino centrs (Letonya Ulusal Film Merkezi) tarafından verilen video derecelendirmesi.

Bu özelliğin geçerli değerleri şunlardır:

nkclv12plus – 12 yaş ve üzeri
nkclv18plus – 18 yaş ve üzeri
nkclv7plus – 7 yaş ve üzeri
nkclvU – U
nkclvUnrated

contentDetails.contentRating.oflcRating

string
Videonun Office of Film and Literature Classification (OFLC - Yeni Zelanda) derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:

oflcG – G
oflcM – M
oflcPg – PG
oflcR13 – R13
oflcR15 – R15
oflcR16 – R16
oflcR18 – R18
oflcRp13 – RP13
oflcRp16 – RP16
oflcUnrated

contentDetails.contentRating.pefilmRating

string
Peru'daki videonun 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 Meksika Radyo, Televizyon ve Sinematografi Genel Müdürlüğü derecelendirmesi.

Bu özelliğin geçerli değerleri şunlardır:

rtcA – A
rtcAa – AA
rtcB – B
rtcB15 – B15
rtcC – C
rtcD – D
rtcUnrated

contentDetails.contentRating.rteRating

string
İrlanda'daki Raidió Teilifís Éireann'ın videoya verdiği derecelendirme.

Bu özellik için geçerli değerler şunlardır:

rteCh – CH
rteGa – GA
rteMa – MA
rtePs – PS
rteUnrated

contentDetails.contentRating.russiaRating

string
Videonun Rusya Federasyonu Ulusal Film Kayıtları (MKRF - Rusya) derecelendirmesi.

Bu özellik için geçerli değerler:

russia0 – 0+
russia12 – 12 yaş ve üzeri
russia16 – 16 yaş ve üzeri
russia18 – 18 yaş ve üzeri
russia6 – 6 yaş ve üzeri
russiaUnrated

contentDetails.contentRating.skfilmRating

string
Slovakya'daki videonun derecelendirmesi.

Bu özellik için geçerli değerler:

skfilmG – G
skfilmP2 – P2
skfilmP5 – P5
skfilmP8 – P8
skfilmUnrated

contentDetails.contentRating.smaisRating

string
İzlanda'daki videonun 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'ın (İsveç Ulusal Medya Konseyi) videoya verdiği derecelendirme.

Bu özellik için geçerli değerler şunlardır:

smsa11 – 11
smsa15 – 15
smsa7 – 7
smsaA – Tüm yaşlar
smsaUnrated

contentDetails.contentRating.tvpgRating

string
Videonun TV Ebeveyn Yönergeleri (TVPG) derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:

tvpgG – TV-G
tvpgMa – TV-MA
tvpgPg – TV-PG
tvpgUnrated
tvpgY – TV-Y
tvpgY7 – TV-Y7
tvpgY7Fv – TV-Y7-FV
pg14 – TV-14

contentDetails.contentRating.ytRating

string
YouTube'un yaş kısıtlaması uygulanan içerikleri belirlemek için kullandığı derecelendirme.

Bu özelliğin geçerli değerleri şunlardır:

ytAgeRestricted

contentDetails.projection

string
Videonun projeksiyon biçimini belirtir.

Bu özellik için geçerli değerler şunlardır:

360
rectangular

contentDetails.hasCustomThumbnail boolean
Videoyu yükleyenin, video için özel küçük resim sağlayıp sağlamadığını gösterir. Bu özellik yalnızca videoyu yükleyen kişi tarafından görülebilir.

status object
status nesnesi, videonun yükleme, işleme ve gizlilik durumlarıyla ilgili bilgileri içerir.

status.uploadStatus

string
Yüklenen videonun durumu.

Bu özellik için geçerli değerler şunlardır:

deleted
failed
processed
rejected
uploaded

status.failureReason

string
Bu değer, bir videonun neden yüklenemediğini açıklar. Bu özellik yalnızca uploadStatus özelliği yüklemenin başarısız olduğunu gösteriyorsa bulunur.

Bu özelliğin geçerli değerleri ş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 bulunur.

Bu özelliğin geçerli değerleri ş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ının planlandığı tarih ve saat. Bu ayar yalnızca videonun gizlilik durumu "gizli" ise belirlenebilir. Değer, ISO 8601 biçiminde belirtilir. Bu özelliğin davranışı hakkında aşağıdaki iki ek noktayı göz önünde bulundurun:

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.
Bu özellik yalnızca videonun gizlilik durumu private ise ve video daha önce hiç yayınlanmamışsa ayarlanabilir.
İsteğinizde bir videonun geçmişte yayınlanması planlanıyorsa video hemen yayınlanır. Bu nedenle, status.publishAt özelliğini geçmiş bir tarih ve saate ayarlamanın etkisi, videonun privacyStatus özelliğini private değerinden public değerine değiştirmekle 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 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 gösterir. Bu istatistikler varsayılan olarak görüntülenebilir. Bu özelliğin değeri false olarak ayarlanmış olsa bile videonun görüntüleme sayısı ve derecelendirmeleri gibi istatistikler herkese açık olarak görünmeye devam eder.

status.madeForKids boolean
Bu değer, videonun çocuklara yönelik olarak belirlenip belirlenmediğini gösterir ve videonun mevcut "çocuklara özel" durumunu içerir. Örneğin, durum selfDeclaredMadeForKids özelliğinin değerine göre belirlenebilir. Kanalınız, videolarınız veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.

status.selfDeclaredMadeForKids boolean
videos.insert veya videos.update isteğinde bu özellik, kanal sahibinin videoyu çocuklara yönelik olarak belirlemesine olanak tanır. videos.list isteğinde özellik 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 isteğinde kanal sahibinin, videoda gerçekçi Değiştirilmiş veya Yapay (D/Y) içerik bulunduğunu bildirmesine olanak tanır. YouTube'un A/S içerikleriyle ilgili politikaları hakkında daha fazla bilgi edinin.

A/S içeriğine örnek olarak şunlar 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, video hakkındaki istatistikleri içerir.

statistics.viewCount

unsigned long

Videonun görüntülenme sayısı.

31 Mart 2025'ten itibaren Shorts videoları için viewCount, Shorts videolarının oynatılmaya veya tekrar oynatılmaya başlama sayısını ifade edecek. Minimum izlenme süresi şartı olmayacak.

statistics.likeCount unsigned long
Videoyu beğendiğini belirten kullanıcıların sayısı.

statistics.dislikeCount

unsigned long

Not: statistics.dislikeCount özelliği 13 Aralık 2021 itibarıyla gizli hale getirildi. Bu nedenle, özellik yalnızca API isteği video sahibi tarafından kimliği doğrulanmışsa API yanıtına dahil edilir. 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ı. Desteğin sonlandırılması 28 Ağustos 2015'ten itibaren geçerlidir. Özelliğin 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şimi hakkında bilgiler 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ştirilmiş 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ştirilmiş oynatıcının boyutu, maxHeight ve/veya maxWidth şartlarını karşılayacak şekilde ölçeklendirilir.
Videonun en boy oranı bilinmiyorsa yerleştirilmiş oynatıcı varsayılan olarak 4:3 biçimini kullanır.

player.embedHeight long
player.embedHtml özelliğinde döndürülen yerleştirilmiş oynatıcının yüksekliği. Bu özellik yalnızca istekte maxHeight ve/veya maxWidth parametreleri için bir değer 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 kapsar.

Önemli: Konu kimlikleriyle ilgili yaklaşan 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 özellik, 10 Kasım 2016'dan itibaren kullanımdan kaldırılmıştır. API artık bu özellik için değer döndürmemektedir ve bir videoyla ilişkili tüm konular topicDetails.relevantTopicIds[] özellik değeriyle döndürülmektedir.

topicDetails.relevantTopicIds[]

list
Video ile alakalı konu kimliklerinin listesi.

Bu özellik, 10 Kasım 2016'da kullanımdan kaldırıldı. 10 Kasım 2017'ye kadar desteklenecek.

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

15 Şubat 2017 itibarıyla desteklenen konu kimliklerini görün

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
Oyunlarla ilgili konular
/m/0bzvm2	Oyun (üst konu)
/m/025zzc	Aksiyon oyunu
/m/02ntfj	Aksiyon-macera oyunu
/m/0b1vjn	Basit oyun
/m/02hygl	Müzik video oyunu
/m/04q1x3q	Bulmaca video oyunu
/m/01sjng	Yarış video oyunu
/m/0403l3g	Rol yapma video oyunu
/m/021bp2	Simülasyon video oyunu
/m/022dc6	Spor oyunları
/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	Yiyecekler
/m/03glg	Hobi
/m/068hy	Evcil hayvanlar
/m/041xxh	Fiziksel çekicilik [Güzellik]
/m/07c1v	Teknoloji
/m/07bxq	Turizm
/m/07yv9	Taşıtlar
Toplumla ilgili konular
/m/098wr	Toplum (üst 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ği hakkında üst düzey bir açıklama sağlayan Wikipedia URL'lerinin listesi.

recordingDetails object
The recordingDetails object encapsulates information about the location, date and address where the video was recorded.

recordingDetails.locationDescription string
Bu özelliğin desteği 1 Haziran 2017'de sonlandırıldı. Daha fazla bilgi için lütfen desteği sonlandırma duyurusuna bakın.

Videonun kaydedildiği yerin metin açıklaması.

recordingDetails.location object
Video ile ilişkili coğrafi konum bilgileri. Alt mülk değerlerinin, video sahibinin video ile 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'de sonlandırıldı. Daha fazla bilgi için lütfen desteği sonlandırma duyurusuna bakın.

Enlem (derece).

recordingDetails.location.longitude double
Bu özelliğin desteği 1 Haziran 2017'de sonlandırıldı. Daha fazla bilgi için lütfen desteği sonlandırma duyurusuna bakın.

Derece cinsinden boylam.

recordingDetails.location.altitude double
Bu özelliğin desteği 9 Temmuz 2018'de sonlandırıldı. Daha fazla bilgi için lütfen desteği sonlandırma duyurusuna bakın.

Referans elipsoidinin üzerindeki 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, dosyanın çözünürlüğü, süresi, ses ve video codec'leri, akış bit hızları gibi YouTube'a yüklenen video dosyasıyla ilgili bilgileri kapsar. Bu veriler yalnızca videonun sahibi tarafından alınabilir.

fileDetails nesnesi yalnızca processingDetails.fileAvailability özelliğinin 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üklenmiş olsa da bulunur.

fileDetails.fileSize unsigned long
Yüklenen dosyanın bayt cinsinden boyutu. Bu alan, video dosyası veya başka bir dosya türü yüklenmiş olsa da bulunur.

fileDetails.fileType

string
Yüklenen dosyanın, YouTube'un video işleme motoru tarafından algılanan türü. YouTube şu anda yalnızca video dosyalarını işlemektedir ancak bu alan, video dosyası veya başka bir dosya türü yüklenmiş olsa da mevcuttur.

Bu özelliğin geçerli değerleri şunlardır:

archive – Dosya, .zip arşivi gibi bir arşiv dosyasıdır.
audio – Dosya, .mp3 dosyası gibi bilinen bir ses dosyası türündedir.
document: Dosya, MS Word belgesi gibi bir doküman veya metin dosyasıdır.
image – Dosya, .jpeg resmi gibi bir resim dosyasıdır.
other: Dosya, video olmayan başka bir dosya türüdür.
project – Dosya, gerçek video verileri içermeyen bir video proje dosyasıdır (ör. Microsoft Windows Movie Maker projesi).
video – Dosya, .mp4 dosyası gibi bilinen bir video dosyası türüdür.

fileDetails.container string
Yüklenen video dosyasının kapsayıcı biçimi.

fileDetails.videoStreams[] list
Yüklenen video dosyasında bulunan video akışlarının listesi. Listedeki her öğe, bir video akışıyla ilgili ayrıntılı meta 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österim en-boy oranı. Bu oran, videonun hangi en-boy oranıyla gösterileceğini belirtir.

fileDetails.videoStreams[].codec string
Akışın kullandığı 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östermek için orijinal kaynak içeriği döndürmesi gereken miktar.

Bu özelliğin geçerli değerleri şunlardır:

clockwise: Video, saat yönünde 90 derece döndürülmelidir.
counterClockwise: Video, saat yönünün tersine 90 derece döndürülmelidir.
none: Videonun döndürülmesi gerekmez.
other – Video, başka bir şekilde (önemsiz olmayan) döndürülmelidir.
upsideDown: Video ters çevrilmelidir.

fileDetails.videoStreams[].vendor string
Bir video tedarikçisini benzersiz şekilde tanımlayan değer. Genellikle bu değer, dört harfli bir tedarikçi kodudur.

fileDetails.audioStreams[] list
Yüklenen video dosyasında bulunan ses akışlarının listesi. Listedeki her öğe, bir ses akışıyla ilgili ayrıntılı meta veriler içerir.

fileDetails.audioStreams[].channelCount unsigned integer
Akışın içerdiği ses kanallarının sayısı.

fileDetails.audioStreams[].codec string
Akışın kullandığı 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. Genellikle bu değer, dört harfli bir tedarikçi kodudur.

fileDetails.durationMs unsigned long
Yüklenen videonun milisaniye cinsinden uzunluğu.

fileDetails.bitrateBps unsigned long
Yüklenen video dosyasının saniye başına bit cinsinden birleştirilmiş (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
Naive time: YYYY-MM-DDTHH:MM:SS
Saat dilimiyle birlikte saat: YYYY-MM-DDTHH:MM:SS+HH:MM

processingDetails object
processingDetails nesnesi, yüklenen video dosyasının işlenmesiyle ilgili YouTube'un ilerleme durumu hakkındaki bilgileri kapsar. Nesnedeki özellikler, mevcut işleme durumunu ve YouTube'un videoyu işlemeyi tamamlamasına kadar kalan sürenin tahminini 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ılabilir olup olmadığı da belirtilir.

processingProgress nesnesi, yüklenen videonun YouTube'un yüklenen video dosyasını işlemede kaydettiği ilerlemeyi takip edebilmesi için yoklanacak şekilde tasarlanmıştır. Bu veriler yalnızca videonun sahibi tarafından alınabilir.

processingDetails.processingStatus

string
Videonun işlenme durumu. Bu değer, YouTube'un videoyu işleyip işlemediğini veya videonun işlenmeye devam edip etmediğini gösterir.

Bu özelliğin geçerli değerleri şunlardır:

failed – Video işleme başarısız oldu. ProcessingFailureReason'a bakın.
processing: Video şu anda işleniyor. ProcessingProgress'i inceleyin.
succeeded: Video başarıyla işlendi.
terminated – İşleme bilgileri artık kullanılamıyor.

processingDetails.processingProgress object
processingProgress nesnesi, YouTube'un videoyu işleme sürecinde kaydettiği ilerlemeyle ilgili bilgileri içerir. Değerler yalnızca videonun işleme durumu processing ise geçerlidir.

processingDetails.processingProgress.partsTotal unsigned long
Video için işlenmesi gereken toplam bölüm sayısının tahmini. YouTube videoyu işlerken bu sayı daha kesin tahminlerle güncellenebilir.

processingDetails.processingProgress.partsProcessed unsigned long
YouTube'un videonun kaç bölümünü işlediğini gösterir. YouTube'un videonun ne kadarını işlediğini şu şekilde tahmin edebilirsiniz:
100 * parts_processed / parts_total

Tahmini bölüm sayısı, işlenen bölüm sayısında artış olmadan yükselebileceğinden YouTube bir videoyu işlerken hesaplanan ilerleme durumunun zaman zaman düşebileceğini unutmayın.

processingDetails.processingProgress.timeLeftMs unsigned long
YouTube'un videoyu işleme sürecini tamamlaması için gereken sürenin milisaniye cinsinden tahmini.

processingDetails.processingFailureReason

string
YouTube'un videoyu işlemeyi başaramamasının nedeni. Bu özelliğin değeri yalnızca processingStatus özelliğinin değeri failed ise olur.

Bu özelliğin geçerli değerleri şunlardır:

other – Başka bir işleme bileşeni başarısız oldu.
streamingFailed: Video, yayıncılara gönderilemedi.
transcodeFailed – İçeriğin kodu dönüştürülemedi.
uploadFailed: Dosya teslimi başarısız oldu.

processingDetails.fileDetailsAvailability string
Bu değer, yüklenen videonun dosya ayrıntılarının kullanılabilir olup olmadığını gösterir. videos.list() isteğinizde fileDetails bölümünü isteyerek bir videonun dosya ayrıntılarını alabilirsiniz.

processingDetails.processingIssuesAvailability string
Bu değer, video işleme motorunun YouTube'un videoyu işleme yeteneğini iyileştirebilecek öneriler, video işleme sorunlarını açıklayan uyarılar veya video işleme sorunlarına neden olan hatalar oluşturup oluşturmadığını gösterir. suggestions bölümünü videos.list() isteğinizde talep ederek bu önerileri alabilirsiniz.

processingDetails.tagSuggestionsAvailability string
Bu değer, video için anahtar kelime (etiket) önerilerinin olup olmadığını gösterir. Etiketler, diğer kullanıcıların videoyu daha kolay bulabilmesi için videonun meta verilerine 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 video için kullanılabilir olup olmadığı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 resimlerin oluşturulup oluşturulmadığını gösterir.

suggestions object
suggestions nesnesi, yüklenen videonun kalitesini veya meta verilerini iyileştirme fırsatlarını belirleyen önerileri kapsar. Bu veriler yalnızca video sahibi tarafından alınabilir.

suggestions nesnesi yalnızca processingDetails.tagSuggestionsAvailability özelliği veya processingDetails.editorSuggestionsAvailability özelliği available değerine sahipse döndürülür.

suggestions.processingErrors[]

list
YouTube'un yüklenen videoyu başarıyla işlemesini engelleyecek hataların listesi. Bu hatalar, videonun mevcut işleme durumundan bağımsız olarak bu durumun sonunda neredeyse kesinlikle failed olacağını gösterir.

Bu özellik için geçerli değerler şunlardır:

archiveFile – Arşiv dosyası (ör. ZIP arşivi).
audioFile – Dosya yalnızca ses içeriyor (ör. MP3 dosyası).
docFile – Doküman veya metin dosyası (ör. MS Word dokümanı)
imageFile – Resim dosyası (ör. JPEG resmi).
notAVideoFile: Video olmayan diğer dosyalar.
projectFile – Film proje dosyası (ör. Microsoft Windows Movie Maker projesi).

suggestions.processingWarnings[]

list
YouTube'un yüklenen videoyu kod dönüştürmede zorlanmasına veya hatalı bir kod dönüştürme işlemine neden olabilecek 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ğını mutlaka belirtmeyen ancak yine de senkronizasyon sorunları, video artefaktları veya eksik bir ses parçası gibi sorunlara neden olabilecek sorunları tanımlar.

Bu özellik için geçerli değerler şunlardır:

hasEditlist – Düzenleme listeleri şu anda desteklenmemektedir.
inconsistentResolution – Çakışan kapsayıcı ve akış çözünürlükleri.
problematicAudioCodec – Sorunlara neden olduğu bilinen bir 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 olması muhtemeldir.
unknownContainer – Tanınmayan dosya biçimi. Kod dönüştürme işleminin başarısız olması muhtemeldir.
unknownVideoCodec – Video codec'i tanınmıyor. Kod dönüştürme işleminin başarısız olması muhtemeldir.

suggestions.processingHints[]

list
YouTube'un videoyu işleme yeteneğini artırabilecek önerilerin listesi.

Bu özellik için geçerli değerler şunlardır:

nonStreamableMov – MP4 dosyası yayınlanamıyor. Bu durum, işleme sürecini yavaşlatır.
sendBestQualityVideo: Videonun daha kaliteli bir sürümü olabilir.

suggestions.tagSuggestions[] list
YouTube'da arama veya göz atma sırasında kullanıcıların 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 bir dizi video kategorisi. 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. Varsayılan olarak, anahtar kelime için kısıtlama tanımlanmamışsa 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 özellik için geçerli değerler şunlardır:

audioQuietAudioSwap – Ses parçası sessiz görünüyor ve daha kaliteli bir ses parçasıyla değiştirilebilir.
videoAutoLevels – Resim parlaklık düzeyleri yanlış görünüyor ve düzeltilebilir.
videoCrop – Resmin etrafında algılanan kenarlar (paspartular) 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. Bu nesne yalnızca video yaklaşan, canlı veya tamamlanmış bir canlı yayınsa video kaynağında bulunur.

liveStreamingDetails.actualStartTime datetime
Yayınların gerçekten 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 süresinin fiilen 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ığı zaman. Değer, ISO 8601 biçiminde belirtilir. Değer boşsa veya özellik mevcut değilse yayının süresiz olarak devam etmesi planlanır.

liveStreamingDetails.concurrentViewers

unsigned long
Yayını şu anda izleyen izleyici sayısı. Yayın sahibi videonun izlenme sayısını gizlemediyse ve yayında şu anda izleyiciler varsa özellik ve değeri gösterilir. YouTube'un, yayın sona erdiğinde yayının eşzamanlı izleyici sayısını izlemeyi durdurduğunu unutmayın. Bu nedenle, bu özellik, zaten sona ermiş bir canlı yayının arşivlenmiş videosunu izleyen izleyici sayısını belirlemez.

YouTube Data API'nin döndürdüğü eşzamanlı izleyici sayıları, YouTube Analytics'te sunulan işlenmiş ve spam'den arındırılmış eşzamanlı izleyici sayılarından farklı olabilir. Canlı yayın metrikleri hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.

liveStreamingDetails.activeLiveChatId string
Bu videoya eklenmiş olan ve şu anda etkin olan canlı sohbetin kimliği. Bu alan yalnızca videonun canlı sohbet içeren, şu anda canlı yayınlanan bir video olması durumunda doldurulur. Yayın geçişi tamamlandıktan sonra bu alan kaldırılır ve canlı sohbet kapatılır. Sürekli yayınlarda canlı sohbet kimliği artık bu videoya değil, sürekli 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ı.

Videos Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Yöntemler

Kaynak temsili

Özellikler

Videos