Videos

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 belirli 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
YouTube'a video yükler ve isteğe bağlı olarak videonun meta verilerini ayarlar.
güncelleme
Bir videonun meta verilerini günceller. Hemen deneyin.
delete
YouTube videolarını siler. Hemen deneyin.
rate
Bir videoya beğenme veya beğenmeme puanı ekleme ya da videodan puan kaldırma Hemen deneyin.
reportAbuse
Kötüye kullanım amaçlı içerik barındıran videoları bildirme Hemen deneyin.

Kaynak temsili

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

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "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
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Özellikler

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

Özellikler
kind string
API kaynağının türünü tanımlar. Değer youtube#video olacak.
etag etag
Bu kaynağın Etag'i.
id string
YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet object
snippet nesnesi, videoyla ilgili başlık, açıklama ve kategori gibi temel bilgileri içerir.
snippet.publishedAt datetime
Videonun yayınlandığı tarih ve saat. Bu saat, videonun yüklendiği saatten farklı olabilir. Ö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üklenirse ve video meta verileri kanal sahibi tarafından alınırsa özellik değeri, videonun yüklendiği tarih ve saati belirtir.
  • Video, liste dışı olarak yüklenirse özellik değeri, videonun yüklendiği tarih ve saati de belirtir. Bu durumda, videonun benzersiz video kimliğini bilen herkes video meta verilerini alabilir.
  • Bir video, üyelere özel video olarak yüklenirse özellik değeri, videonun yüklendiği tarih ve saati belirtir.
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. Bu değer, bir videonun farklı bir kanala (ör. konu kanalı veya sanatçı kanalı) yeniden atanması gibi durumlarda zaman içinde değişebilir.
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ıyorsanız ve bir video kaynağının snippet bölümünü güncelliyorsanız bu özellik için bir değer ayarlamanız gerekir.
snippet.description string
Videonun açıklaması. Mülk değeri en fazla 5.000 bayt uzunluğunda olabilir ve < ile > hariç tüm geçerli UTF-8 karakterlerini içerebilir.

Açıklama metnine biçimlendirilmiş zaman damgaları (ör. 00:00) ekleyerek video bölümleri oluşturabilirsiniz.
snippet.thumbnails object
Videoyla ilişkili küçük resimlerin haritası. Haritadaki her nesne için anahtar, küçük resmin adıdır ve değer, küçük resimle ilgili diğer bilgileri içeren bir nesnedir.
snippet.thumbnails.(key) object
Geçerli anahtar değerleri:
  • default: Varsayılan küçük resim. Bir videonun (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya başvuran kaynağın) varsayılan küçük resmi 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ü. Bir video (veya videoya referans veren 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. Bir video (veya videoya referans veren bir kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanallar için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir.
  • standard: Küçük resmin, high çözünürlüklü resimden daha yüksek çözünürlüklü bir sürümüdür. Bu resim, bazı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri veya arama sonuçları) kullanılabilir. Bu resim 640 piksel genişliğinde ve 480 piksel yüksekliğindedir.
  • maxres: Küçük resmin 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 1280 piksel genişliğinde ve 720 piksel yüksekliğindedir.
  • fhd: Küçük resmin tam yüksek çözünürlüklü (1080p) sürümü. Bu resim boyutu bazı videolarda kullanılabilir. Bu resim 1920 piksel genişliğinde ve 1080 piksel yüksekliğindedir.
  • qhd: Küçük resmin Quad Yüksek Tanımlı (1440p/2K) sürümü. Bu resim boyutu bazı videolarda kullanılabilir. Bu resim 2.560 piksel genişliğinde ve 1.440 piksel yüksekliğindedir.
  • uhd: Küçük resmin ultra yüksek çözünürlüklü (4K) sürümü. Bu resim boyutu bazı videolarda kullanılabilir. Bu resim 3.840 piksel genişliğinde ve 2.160 piksel yüksekliğindedir.
snippet.thumbnails.(key).url string
Resmin URL'si.
snippet.thumbnails.(key).width unsigned integer
Resmin genişliği.
snippet.thumbnails.(key).height unsigned integer
Resmin yüksekliği.
snippet.channelTitle string
Videonun ait olduğu kanalın başlığı.
snippet.tags[] list
Videoyla ilişkili anahtar kelime etiketlerinin listesi. Etiketler boşluk içerebilir. Mülk değeri en fazla 500 karakter uzunluğunda olabilir. Karakter sınırlamasının hesaplanma şekliyle 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çine alınmış gibi işler ve tırnak işaretleri karakter sınırlamasına dahil edilir. Bu nedenle, karakter sınırlaması 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 bir video kaynağının snippet bölümünü güncelliyorsanız bu özellik için bir değer ayarlamanız gerekir.
snippet.liveBroadcastContent string

Videonun yaklaşan/etkin bir canlı yayın olup olmadığını gösterir. Video, yaklaşan/etkin bir canlı yayın değilse 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 yerelleştirilmiş başlığını ve açıklamasını ya da videonun meta verileri için varsayılan dildeki başlığını içerir.
  • videos.list isteği, yerelleştirilmiş metnin döndürülmesi gereken dili belirtmek için hl parametresini kullandıysa ve yerelleştirilmiş metin bu dilde mevcutsa yerelleştirilmiş metin, kaynak snippet'inde döndürülür.
  • hl parametre değeri belirtilmezse veya bir değer belirtilir 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
Videonun yerelleştirilmiş 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ığı gibi video içeriğiyle ilgili bilgileri içerir.
contentDetails.duration string
Videonun uzunluğu. Özellik değeri, ISO 8601 süresidir. Örneğin, en az bir dakika ve bir saatten kısa olan 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 sırasıyla dakika ve saniye cinsinden uzunluğu ifade eder. M ve S harflerinden önceki # karakter, 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. Burada H harfinden önceki #, videonun saat cinsinden uzunluğunu belirtir ve 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ı gösterir.
contentDetails.definition string
Videonun yüksek çözünürlükte (HD) mi yoksa yalnızca standart çözünürlükte mi kullanılabildiğini belirtir.

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

Bu özellik için geçerli değerler şunlardır:
  • false
  • true
contentDetails.licensedContent boolean
Videonun lisanslı içeriği temsil edip etmediğini belirtir. Bu, içeriğin bir YouTube içerik iş ortağına bağlı bir kanala yüklendiği ve ardından 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 bilgi içerir. Nesne, contentDetails.regionRestriction.allowed veya contentDetails.regionRestriction.blocked özelliğini içerir.
contentDetails.regionRestriction.allowed[] list
Videonun izlenebildiği ülkeleri tanımlayan bölge kodlarının listesi. Bu özellik mevcutsa ve değerinde bir ülke listelenmemişse 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 mevcutsa ve değerinde bir ülke listelenmemişse video o ülkede görüntülenebilir. Bu özellik mevcutsa ve boş bir liste içeriyorsa video tüm ülkelerde görüntülenebilir.
contentDetails.contentRating object
Videonun çeşitli derecelendirme ş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
Videonun İtalya'daki Autorità per le Garanzie nelle Comunicazioni (AGCOM) tarafından verilen derecelendirmesi.

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

Bu özellik için geçerli değerler:
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Videonun British Board of Film Classification (BBFC) derecelendirmesi.

Bu ö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
Videonun Tayland Film ve Video Sansür Kurulu tarafından verilen derecelendirmesi.

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

Bu özellik için geçerli değerler şunlardır:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14+
  • bmukk16 – 16+
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa – Kısıtlanmamış
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Kanada TV'si için derecelendirme sistemi - Kanada TV Sınıflandırma Sistemi Videonun, Kanada Radyo-Televizyon ve Telekomünikasyon Komisyonu (CRTC) tarafından Kanada İngilizcesi yayınları için belirlenen derecelendirmesi. Daha fazla bilgi için Canadian Broadcast Standards Council web sitesini ziyaret edin.

Bu özellik için geçerli değerler şunlardır:
  • catv14plus – 14+
  • catv18plus – 18+
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Kanada Fransızcası yayınlar için Kanada Radyo-Televizyon ve Telekomünikasyon Komisyonu'nun (CRTC) videoya verdiği derecelendirme. Daha fazla bilgi için Canadian Broadcast Standards Council web sitesini ziyaret edin.

Bu özellik için geçerli değerler şunlardır:
  • catvfr13plus – 13+
  • catvfr16plus – 16+
  • catvfr18plus – 18+
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Videonun Central Board of Film Certification (CBFC - Hindistan) derecelendirmesi.

Bu özellik için geçerli değerler ş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) derecelendirmesi.

Bu özellik için geçerli değerler:
  • ccc14 – 14+
  • ccc18 – 18+
  • ccc18s – 18+ - contenido pornográfico
  • ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
Videonun Portekiz'deki Comissão de Classificação de Espect´culos tarafından verilen derecelendirmesi.

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

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

Bu mülk için geçerli değerler şunlardır:
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Videonun Commission de Contrôle des Films (Belçika) tarafından verilen derecelendirmesi.

Bu mülk için geçerli değerler:
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
Videonun Romanya'daki CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) tarafından verilen derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18+
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Fransa'daki derecelendirme sistemi - Commission de classification cinematographique

Bu özellik için geçerli değerler:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
Videonun, Fransa'da yayın içeriklerini derecelendiren Conseil supérieur de l'audiovisuel tarafından verilen derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – Yasaklama
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Videonun Lüksemburg'un Commission de surveillance de la classification des films (CSCF) kurumundan aldığı derecelendirme.

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

Bu özellik için geçerli değerler:
  • 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 alma nedenleri.
contentDetails.contentRating.ecbmctRating string
Türkiye'deki derecelendirme sistemi - Kültür ve Turizm Bakanlığı Değerlendirme ve Sınıflandırma Kurulu

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

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

Bu özellik için geçerli değerler:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Videonun Eirin (映倫) derecelendirmesi. Eirin, Japonya'da kullanılan derecelendirme sistemidir.

Bu özellik için geçerli değerler şunlardır:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
Videonun Malezya Film Sansür Kurulu tarafından belirlenen derecelendirmesi.

Bu özellik için geçerli değerler:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Videonun Hong Kong'un Film, Gazete ve Makale Yönetimi Ofisi'nden aldığı derecelendirme.

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

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

Bu özellik için geçerli değerler şunlardır:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Videonun Güney Afrika Film ve Yayın Kurulu tarafından verilen derecelendirmesi.

Bu mülk için geçerli değerler:
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Videonun FPB (Güney Afrika) derecelendirmesini alma nedenleri.
contentDetails.contentRating.fskRating string
Videonun Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Almanya) derecelendirmesi.

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

Bu özellik için geçerli değerler:
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – K-12
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Videonun Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - İspanya) derecelendirmesi.

Bu ö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
Videonun İsrail'deki derecelendirmesi.

Bu özellik için geçerli değerler:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Videonun INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Arjantin) derecelendirmesi.

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

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

Bu mülk için geçerli değerler şunlardır:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Videonun Kore Medya Derecelendirme Kurulu (영상물등급위원회) derecelendirmesi. KMRB, Güney Kore'deki videoları derecelendirir.

Bu özellik için geçerli değerler:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Videonun Endonezya'daki Lembaga Sensor Film tarafından verilen derecelendirmesi.

Bu ö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
Videonun Malta'nın Film Yaş Sınıflandırma Kurulu'ndan aldığı 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ılmıştır.
  • mccaa15 – 15
  • mccaa16 – 16: Bu derecelendirme, 2013'te kullanıma sunulan yeni sınıflandırma yapısından kaldırılmıştır.
  • mccaa18 – 18
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Videonun Danimarka Film Enstitüsü (Det Danske Filminstitut) Çocuk ve Gençler için Medya Konseyi tarafından verilen derecelendirmesi.

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

Bu mülk için geçerli değerler:
  • mcst0 – 0
  • mcst16plus – 16+
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
Videonun Singapur'un Medya Geliştirme Kurumu (MDA) ve özellikle Film Sansür Kurulu (BFC) tarafından verilen derecelendirmesi.

Bu mülk için geçerli değerler şunlardır:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Videonun Norveç Medya Kurumu Medietilsynet'ten aldığı 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
Videonun Finlandiya'daki Kansallinen Audiovisuaalinen Instituutti (Ulusal Görsel-İşitsel Enstitü) tarafından belirlenen derecelendirmesi.

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

Bu mülk için geçerli değerler:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Videonun Ministerio de Cultura (Kolombiya) derecelendirmesi.

Bu özellik için geçerli değerler:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – Yasaklandı
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
Videonun Tayvan Kültür Bakanlığı (文化部) tarafından verilen derecelendirmesi.

Bu mülk için geçerli değerler:
  • 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 özellik için geçerli değerler şunlardır:
  • mpaatGb – GB (Yeşil Bant - Tüm kitleler için onaylı)
  • mpaatRb – RB (Red Band - 17 yaş ve üzeri için önerilir)
contentDetails.contentRating.mtrcbRating string
Videonun Film ve Televizyon İnceleme ve Sınıflandırma Kurulu (Filipinler) tarafından verilen derecelendirmesi.

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

Bu mülk için geçerli değerler:
  • nbc12plus – 12+
  • nbc15plus – 15+
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Videonun Bulgaristan Ulusal Film Merkezi tarafından verilen derecelendirmesi.

Bu özellik için geçerli değerler:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
Videonun Nijerya Ulusal Film ve Video Sansür Kurulu tarafından verilen derecelendirmesi.

Bu mülk için geçerli değerler şunlardır:
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Videonun Nacionãlais Kino centrs (Letonya Ulusal Film Merkezi) tarafından verilen derecelendirmesi.

Bu mülk için geçerli değerler:
  • nkclv12plus – 12+
  • nkclv18plus – 18+
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Videonun Office of Film and Literature Classification (OFLC - Yeni Zelanda) derecelendirmesi.

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

Bu özellik için geçerli değerler:
  • 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:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Videonun Radyo, Televizyon ve Sinematografi Genel Müdürlüğü (Meksika) derecelendirmesi.

Bu özellik için geçerli değerler şunlardır:
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC – C
  • rtcD – D
  • rtcUnrated
contentDetails.contentRating.rteRating string
Videonun İrlanda'daki Raidió Teilifís Éireann'dan aldığı derecelendirme.

Bu özellik için geçerli değerler:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Videonun Rusya Federasyonu Ulusal Film Sicili (MKRF - Rusya) derecelendirmesi.

Bu özellik için geçerli değerler:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16+
  • russia18 – 18+
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Videonun Slovakya'daki derecelendirmesi.

Bu özellik için geçerli değerler:
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
Videonun İzlanda'daki derecelendirmesi.

Bu özellik için geçerli değerler:
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Videonun Statens medieråd (İsveç Ulusal Medya Konseyi) tarafından verilen derecelendirmesi.

Bu mülk için geçerli değerler:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – Tüm yaşlar
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Videonun TV Ebeveyn Yönergeleri (TVPG) derecelendirmesi.

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

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

Bu özellik için geçerli değerler şunlardır:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Videoyu yükleyen kullanıcının video için özel bir küçük resim sağlayıp sağlamadığını belirtir. Bu özellik yalnızca videoyu yükleyen kullanıcı tarafından görülebilir.
status object
status nesnesi, videonun yükleme, işleme ve gizlilik durumları hakkında bilgi 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, videonun neden yüklenemediğini açıklar. Bu özellik yalnızca uploadStatus özelliği yüklemenin başarısız olduğunu gösteriyorsa mevcuttur.

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

Bu özellik için geçerli değerler şunlardır:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Videonun gizlilik durumu. Bir videos.insert isteğinde bu özellik için değer belirtmezseniz yüklenen videonun gizlilik durumu varsayılan olarak public olur. YouTube Yardım Merkezi'nde açıklandığı üzere, içerik üretici hesap ayarlarına bağlı olarak belirli yüklemeler varsayılan olarak private şeklinde ayarlanabilir. Doğrulanmamış API projelerinden yüklenen videolar, gizli görüntüleme moduyla kısıtlanmaz.

Bu özelliğin geçerli değerleri şunlardır:
  • private
  • public
  • unlisted
status.publishAt datetime
Videonun yayınlanmasının planlandığı tarih ve saat. Yalnızca videonun gizlilik durumu "gizli" ise ayarlanabilir. Değer, ISO 8601 biçiminde belirtilir. Bu özelliğin davranışıyla ilgili aşağıdaki iki noktaya dikkat edin:
  • videos.update yöntemini çağırırken bu özelliğin değerini ayarlarsanız video zaten gizli olsa bile status.privacyStatus özellik değerini private olarak ayarlamanız gerekir.
  • Bu özellik yalnızca videonun gizlilik durumu private ise ve video daha önce hiç yayınlanmadıysa ayarlanabilir.
  • İsteğiniz, bir videonun geçmişteki bir zamanda yayınlanmasını planlıyorsa video hemen yayınlanır. Bu nedenle, status.publishAt özelliğini geçmiş bir tarih ve saate ayarlamanın etkisi, videonun privacyStatus değerini private yerine public olarak değiştirmenin etkisiyle 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 belirtir. Varsayılan olarak bu istatistikler görüntülenebilir. Bu özelliğin değeri false olarak ayarlanmış olsa bile videonun görüntüleme sayısı ve puanları gibi istatistikler herkese açık olarak gösterilmeye devam eder.
status.madeForKids boolean
Bu değer, videonun çocuklara yönelik olarak ayarlanıp ayarlanmadığını gösterir ve videonun mevcut "çocuklara özel" durumunu içerir. Örneğin, durum selfDeclaredMadeForKids özelliğinin değerine göre belirlenebilir. Kanalınız, videolarınız veya yayınlarınız için kitle ayarlama hakkında daha fazla bilgi edinmek istiyorsanız YouTube Yardım Merkezi'ni ziyaret edin.
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ğini yetkilendirdiyse döndürülür.
status.containsSyntheticMedia boolean
videos.insert veya videos.update isteğinde bu özellik, kanal sahibinin bir videonun gerçekçi değiştirilmiş veya yapay (D/Y) içerik barındırdığını bildirmesine olanak tanır. A/S içerikleriyle ilgili YouTube politikaları hakkında daha fazla bilgi edinin.

A/S içeriklere örnek olarak şu videolar verilebilir:
  • Gerçek bir insanı, söylemediği veya yapmadığı bir şeyi söylemiş ya da yapmış gibi gösterme
  • Gerçek bir olayın veya yerin kamera görüntülerini değiştirme
  • Gerçekte meydana gelmese de gerçekçi görünen bir sahne oluşturma
statistics object
statistics nesnesi, videoyla ilgili istatistikleri içerir.
statistics.viewCount unsigned long

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

Tüm video formatlarında (uzun videolar, canlı yayınlar ve Shorts videoları) viewCount, video oynatılmaya başlandığı andan itibaren görüntülemeleri sayar (otomatik oynatma, imleci üzerine getirme ve oynatmak için tıklama/dokunma dahildir).

Tüm video formatlarında (uzun videolar, canlı yayınlar ve Shorts videoları) viewCount, birden fazla kişinin televizyon ekranında birlikte izlediği birlikte izleme sayısını içerir.

statistics.likeCount unsigned long
Videoyu beğendiğini belirten kullanıcıların sayısı.
statistics.dislikeCount unsigned long
Not: statistics.dislikeCount mülkü 13 Aralık 2021 itibarıyla gizli hale getirildi. Bu, özelliğin yalnızca API isteğinin video sahibi tarafından kimlik doğrulaması yapıldığında API yanıtına dahil edildiği anlamına gelir. Daha fazla bilgi için düzeltme geçmişine bakın.

Videoyu beğenmediğini belirten kullanıcıların sayısı.
statistics.favoriteCount unsigned long
Not: Bu özelliğin desteği sonlandırıldı. Bu değişiklik 28 Ağustos 2015'ten itibaren geçerlidir. Özelliğin değeri artık her zaman 0 olarak ayarlanır.
statistics.commentCount unsigned long
Videonun yorum sayısı.
paidProductPlacementDetails object
paidProductPlacementDetails nesnesi, videodaki ücretli ürün yerleşimi hakkında bilgi içerir.
paidProductPlacementDetails.hasPaidProductPlacement boolean
İçerikte ücretli ürün yerleşimi kullanılıyorsa true olarak ayarlayın. İçerikte ücretli ürün yerleşimi kullanılmıyorsa false olarak ayarlayın.
player object
player nesnesi, videoyu yerleşik bir oynatıcıda oynatmak için kullanacağınız bilgileri içerir.
player.embedHtml string
Videoyu oynatan bir oynatıcıyı yerleştiren <iframe> etiketi.
  • Kaynağı almak için gönderilen API isteği, maxHeight ve/veya maxWidth parametreleri için bir değer belirtiyorsa 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
Yerleştirilmiş oynatıcının yüksekliği, player.embedHtml özelliğinde döndürülür. 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ına ve düzeltme geçmişine bakın.
topicDetails.topicIds[] list
Önemli: Bu mülk, 10 Kasım 2016 itibarıyla kullanımdan kaldırılmıştır. API artık bu özellik için değer döndürmüyor ve bir videoyla ilişkili tüm konular artık topicDetails.relevantTopicIds[] özellik değeri tarafından döndürülüyor.
topicDetails.relevantTopicIds[] list
Videoyla alakalı konu kimliklerinin listesi.

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

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

topicDetails.topicCategories[] list
Videonun içeriğiyle ilgili üst düzey bir açıklama sağlayan Wikipedia URL'lerinin listesi.
recordingDetails object
recordingDetails nesnesi, videonun kaydedildiği konum, tarih ve adresle ilgili bilgileri kapsar.
recordingDetails.locationDescription string
Bu özelliğin desteği 1 Haziran 2017'den itibaren sonlandırılmıştır. Daha fazla bilgi için lütfen desteği sonlandırma duyurusunu inceleyin.

Videonun kaydedildiği konumun metin açıklaması.
recordingDetails.location object
Bu özelliğin desteği sonlandırıldı. Tüm alt mülkleri (enlem, boylam, rakım) kullanımdan kaldırılmıştır.

Videoyla ilişkili coğrafi konum bilgileri. Alt mülk değerleri, video sahibinin videoyla ilişkilendirmek istediği konumu tanımlar. 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 özelliğin desteği 1 Haziran 2017'den itibaren sonlandırılmıştır. Daha fazla bilgi için lütfen desteği sonlandırma duyurusunu inceleyin.

Derece cinsinden enlem.
recordingDetails.location.longitude double
Bu özelliğin desteği 1 Haziran 2017'den itibaren sonlandırılmıştır. Daha fazla bilgi için lütfen desteği sonlandırma duyurusunu inceleyin.

Derece cinsinden boylam.
recordingDetails.location.altitude double
Bu özelliğin desteği 9 Temmuz 2018 itibarıyla sonlandırılmıştır. Daha fazla bilgi için lütfen desteği sonlandırma duyurusunu inceleyin.

Referans elipsoidin ü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.) kapsar. Bu veriler yalnızca video 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şse gösterilir.
fileDetails.fileSize unsigned long
Yüklenen dosyanın bayt cinsinden boyutu. Bu alan, video dosyası veya başka bir dosya türü yüklenmişse gösterilir.
fileDetails.fileType string
YouTube'un video işleme motoru tarafından algılanan, yüklenen dosyanın türü. Şu anda YouTube 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 özellik için geçerli değerler şunlardır:
  • archive: Dosya, .zip arşivi gibi bir arşiv dosyasıdır.
  • audio: Dosya, .mp3 dosyası gibi bilinen bir ses dosyası türüdür.
  • document: Dosya, MS Word belgesi gibi bir belge 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, Microsoft Windows Movie Maker projesi gibi gerçek video verileri içermeyen bir video projesi dosyasıdır.
  • 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 saniyedeki kare sayısı (FPS) cinsinden kare hızı.
fileDetails.videoStreams[].aspectRatio double
Video içeriğinin görüntü en boy oranı. Bu, videonun gösterilmesi gereken en boy oranını belirtir.
fileDetails.videoStreams[].codec string
Yayının kullandığı video codec'i.
fileDetails.videoStreams[].bitrateBps unsigned long
Video akışının saniye başına bit cinsinden bit hızı.
fileDetails.videoStreams[].rotation string
YouTube'un videoyu düzgün şekilde görüntülemek için orijinal kaynak içeriği döndürmesi gereken miktar.

Bu özellik için geçerli değerler şunlardır:
  • clockwise: Videonun saat yönünde 90 derece döndürülmesi gerekiyor.
  • counterClockwise: Videonun saat yönünün tersine 90 derece döndürülmesi gerekiyor.
  • none: Videonun döndürülmesi gerekmez.
  • other: Video, başka bir şekilde döndürülmelidir.
  • upsideDown: Videonun ters çevrilmesi gerekiyor.
fileDetails.videoStreams[].vendor string
Bir video tedarikçisini benzersiz şekilde tanımlayan değer. Değer genellikle dört harfli bir tedarikçi kodu olur.
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
Yayının kullandığı ses codec'i.
fileDetails.audioStreams[].bitrateBps unsigned long
Ses akışının saniye başına bit cinsinden bit hızı.
fileDetails.audioStreams[].vendor string
Bir video tedarikçisini benzersiz şekilde tanımlayan değer. Değer genellikle dört harfli bir tedarikçi kodu olur.
fileDetails.durationMs unsigned long
Yüklenen videonun milisaniye cinsinden uzunluğu.
fileDetails.bitrateBps unsigned long
Yüklenen video dosyasının saniyede 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, YouTube'un yüklenen video dosyasını işleme süreciyle ilgili bilgileri kapsar. Nesnedeki özellikler, mevcut işleme durumunu ve YouTube'un videoyu işlemeyi tamamlamasına kadar kalan tahmini süreyi belirtir. Bu bölümde, video için dosya ayrıntıları veya küçük resimler gibi farklı veri ya da içerik türlerinin mevcut olup olmadığı da belirtilir.

processingProgress nesnesi, yüklenen videonun YouTube'un yüklenen video dosyasını işleme sürecinde kaydettiği ilerlemeyi takip edebilmesi için sorgulanacak şekilde tasarlanmıştır. Bu veriler yalnızca video sahibi tarafından alınabilir.
processingDetails.processingStatus string
Videonun işlenme durumu. Bu değer, YouTube'un videoyu işleyip işlemediğini veya videonun hâlâ işlenip işlenmediğini gösterir.

Bu özellik için geçerli değerler şunlardır:
  • failed: Video işleme başarısız oldu. ProcessingFailureReason bölümüne bakın.
  • processing: Video şu anda işleniyor. ProcessingProgress bölümüne bakın.
  • succeeded: Video başarıyla işlendi.
  • terminated: İşleme bilgileri artık kullanılamıyor.
processingDetails.processingProgress object
processingProgress nesnesi, YouTube'un videoyu işleme konusunda kaydettiği ilerleme hakkında bilgi içerir. Değerler yalnızca videonun işleme durumu processing olduğunda geçerlidir.
processingDetails.processingProgress.partsTotal unsigned long
Video için işlenmesi gereken toplam parça sayısının tahmini. YouTube videoyu işlerken bu sayı daha kesin tahminlerle güncellenebilir.
processingDetails.processingProgress.partsProcessed unsigned long
YouTube'un videonun işlediği bölümlerinin sayısı. YouTube'un videonun ne kadarını işlediğini şu şekilde hesaplayabilirsiniz:
100 * parts_processed / parts_total

Tahmini parça sayısı, işlenen parça sayısında bir artış olmadan artabileceğinden, YouTube bir videoyu işlerken hesaplanan ilerleme durumunun zaman zaman azalabileceğini unutmayın.
processingDetails.processingProgress.timeLeftMs unsigned long
YouTube'un videoyu işlemeyi tamamlaması için gereken tahmini süre (milisaniye cinsinden).
processingDetails.processingFailureReason string
YouTube'un videoyu işleyememesinin nedeni. Bu özellik yalnızca processingStatus özelliğinin değeri failed ise bir değere sahip olur.

Bu özellik için geçerli değerler şunlardır:
  • other: Başka bir işleme bileşeni başarısız oldu.
  • streamingFailed: Video, canlı yayıncılara gönderilemedi.
  • transcodeFailed: İçerik kod dönüştürme işlemi başarısız oldu.
  • uploadFailed – Dosya teslim edilemedi.
processingDetails.fileDetailsAvailability string
Bu değer, yüklenen videonun dosya ayrıntılarının mevcut olup olmadığını gösterir. videos.list() isteğinizde fileDetails bölümünü isteyerek videonun dosya ayrıntılarını alabilirsiniz.
processingDetails.processingIssuesAvailability string
Bu değer, video işleme motorunun YouTube'un videoyu işleme 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. videos.list() isteğinizde suggestions bölümünü talep ederek bu önerileri alabilirsiniz.
processingDetails.tagSuggestionsAvailability string
Bu değer, video için anahtar kelime (etiket) önerilerinin mevcut olup olmadığını gösterir. Diğer kullanıcıların videoyu daha kolay bulabilmesi için videonun meta verilerine etiketler eklenebilir. videos.list() isteğinizde suggestions bölümünü talep ederek bu önerileri alabilirsiniz.
processingDetails.editorSuggestionsAvailability string
Bu değer, video kalitesini veya oynatma deneyimini iyileştirebilecek video düzenleme önerilerinin video için mevcut olup olmadığını gösterir. videos.list() isteğinizde suggestions bölümünü talep ederek bu önerileri 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 video 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 veya processingDetails.editorSuggestionsAvailability özelliğinin değeri available ise döndürülür.
suggestions.processingErrors[] list
YouTube'un yüklenen videoyu başarıyla işlemesini engelleyecek hataların listesi. Bu hatalar, videonun mevcut işleme durumundan bağımsız olarak, bu durumun 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çerir (ör. MP3 dosyası).
  • docFile: Doküman veya metin dosyası (ör. MS Word belgesi).
  • imageFile: Resim dosyası (ör. JPEG resmi).
  • notAVideoFile: Video olmayan diğer dosya.
  • projectFile: Film projesi dosyası (ör. Microsoft Windows Movie Maker projesi).
suggestions.processingWarnings[] list
YouTube'un yüklenen videonun kodunu dönüştürmekte zorlanmasına veya hatalı bir kod dönüştürme işlemine neden olabilecek sorunların listesi. Bu uyarılar, YouTube yüklenen video dosyasını işlemeden önce oluşturulur. Ayrıca, video işlemenin başarısız olacağını kesin olarak göstermeyen ancak senkronizasyon sorunları, video kusurları veya eksik ses parçası gibi sorunlara neden olabilecek sorunları da tanımlar.

Bu özellik için geçerli değerler şunlardır:
  • hasEditlist: Düzenleme listeleri şu anda desteklenmiyor.
  • inconsistentResolution: Kapsayıcı ve akış çözünürlükleri çakışıyor.
  • 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şlemi muhtemelen başarısız olacak.
  • unknownContainer: Tanınmayan dosya biçimi. Kod dönüştürme işlemi muhtemelen başarısız olacak.
  • unknownVideoCodec: Tanınmayan video codec'i, kod dönüştürme işlemi muhtemelen başarısız olacak.
suggestions.processingHints[] list
YouTube'un videoyu işleme yeteneğini iyileştirebilecek önerilerin listesi.

Bu özellik için geçerli değerler şunlardır:
  • nonStreamableMov: MP4 dosyası akışa uygun değil. Bu durum, işleme sürecini yavaşlatır.
  • sendBestQualityVideo: Videonun muhtemelen daha kaliteli bir sürümü vardır.
suggestions.tagSuggestions[] list
Kullanıcıların YouTube'da arama yaparken veya gezinirken videonuzu bulma olasılığını artırmak için videonun meta verilerine eklenebilecek anahtar kelime etiketlerinin listesi.
suggestions.tagSuggestions[].tag string
Video için önerilen anahtar kelime etiketi.
suggestions.tagSuggestions[].categoryRestricts[] list
Etiketin alakalı olduğu video kategorileri grubu. Bu bilgileri, videoyu yükleyen kullanıcının videoyla ilişkilendirdiği video kategorisine göre uygun etiket önerileri göstermek için kullanabilirsiniz. Varsayılan olarak, anahtar kelime için tanımlanmış bir kısıtlama yoksa etiket önerileri tüm kategoriler için geçerlidir.
suggestions.editorSuggestions[] list
Yüklenen videonun 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ında ses yok ve daha kaliteli bir parçayla değiştirilebilir.
  • videoAutoLevels: Resim parlaklık seviyeleri yanlış görünüyor ve düzeltilebilir.
  • videoCrop: Resmin etrafında algılanan kenar boşlukları (paspartular) kırpılabilir.
  • videoStabilize: Video titrek görünüyor ve sabitlenebilir.
liveStreamingDetails object
liveStreamingDetails nesnesi, canlı video yayınıyla ilgili meta veriler içerir. Nesne, yalnızca video yaklaşan, canlı veya tamamlanmış bir canlı yayınsa video kaynağında bulunur.
liveStreamingDetails.actualStartTime datetime
Yayının gerçekte başladığı zaman. Değer, ISO 8601 biçiminde belirtilir. Bu değer, yayın başlayana kadar kullanılamaz.
liveStreamingDetails.actualEndTime datetime
Yayının gerçekte sona erdiği zaman. Değer, ISO 8601 biçiminde belirtilir. Bu değer, yayın sona erene kadar kullanılamaz.
liveStreamingDetails.scheduledStartTime datetime
Yayın için planlanan başlangıç zamanı. Değer, ISO 8601 biçiminde belirtilir.
liveStreamingDetails.scheduledEndTime datetime
Yayının sona ermesi planlanan 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
İstek sırasında yayını izleyen kullanıcıların sayısı. Bu sayı, birden fazla kişi bir televizyon ekranında birlikte izlediğinde birlikte izleyenleri içerir. Yayın, mevcut izleyicilere sahipse ve yayın sahibi videonun görüntüleme sayısını gizlemediyse özellik ve değeri mevcut olur. 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 sona ermiş bir canlı yayının arşivlenmiş videosunu izleyenlerin sayısını belirlemez.
YouTube Data API'nin döndürdüğü eşzamanlı görüntülenme sayısı, YouTube Analytics'te bulunan işlenmiş ve spam'den arındırılmış eşzamanlı görüntülenme sayısından farklı olabilir. Canlı yayın metrikleri hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.
liveStreamingDetails.activeLiveChatId string
Bu videoya ekli olan ve şu anda etkin olan canlı sohbetin kimliği. Bu alan, yalnızca video canlı sohbet içeren ve şu anda canlı yayınlanan bir videoysa doldurulur. Yayın tamamlandı durumuna geçtiğinde bu alan kaldırılır ve canlı sohbet kapatılır. Kalıcı yayınlarda, canlı sohbet kimliği artık bu videoya değil, kalıcı sayfada gösterilen yeni videoya bağlı olur.
brandPartner object
brandPartner nesnesi, içerik üretici tarafından başlatılan marka iş ortağı erişimi (CI BPA) için videoya bağlı marka iş ortağıyla ilgili ayrıntıları içerir.
brandPartner.channelId string
Marka iş ortağının harici kanal kimliği. Bu alan "UC" ile başlamalıdır. Erişim oluşturulurken channelId veya channelHandle ayarlanmalıdır ancak yanıtta yalnızca channelId döndürülür.
brandPartner.channelHandle string
Marka iş ortağının kanal herkese açık kullanıcı adı. Bu alan "@" ile başlamalıdır. Erişim oluşturulurken channelId veya channelHandle ayarlanmalıdır ancak yanıtta yalnızca channelId döndürülür.
localizations object
localizations nesnesi, videonun meta verilerinin çevirilerini içerir.
localizations.(key) object
Anahtar değerle ilişkili yerelleştirilmiş metnin dili. Değer, BCP-47 dil kodu içeren bir dizedir.
localizations.(key).title string
Yerelleştirilmiş video başlığı.
localizations.(key).description string
Videonun yerelleştirilmiş açıklaması.