Videos

28 Temmuz 2020'den sonra oluşturulan doğrulanmamış API projelerinden videos.insert uç noktası aracılığıyla yüklenen tüm videolar, gizli izleme moduyla sınırlandırılacak. Bu kısıtlamanın kaldırılması için her API projesinin Hizmet Şartları'na uygunluğunu doğrulamak amacıyla denetime tabi tutulması gerekir. Daha fazla bilgi için lütfen API Düzeltme Geçmişi'ne bakın.

video kaynağı, bir YouTube videosunu temsil eder.

Yöntemler

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

getRating
Yetkili kullanıcının, belirtilen videoların listesine verdiği puanları alır. Hemen deneyin.
list
API istek parametreleriyle eşleşen videoların listesini döndürür. Hemen deneyin.
ekle
YouTube'a video yükler ve isteğe bağlı olarak videonun meta verilerini ayarlar.
güncelle
Videonun meta verilerini günceller. Hemen deneyin.
sil
YouTube videosunu siler. Hemen deneyin.
oran
Bir videoya beğenme veya beğenmeme puanı ekleyin ya da videonun derecelendirmesini kaldırın. 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
  },
  "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ığı, açıklaması ve kategorisi) içerir.
snippet.publishedAt datetime
Videonun yayınlandığı tarih ve saat. Bu sürenin, videonun yüklendiği zamandan farklı olabileceğini unutmayın. Örneğin, bir video gizli olarak yü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 olarak yüklenirse ve video meta verileri kanal sahibi tarafından alınırsa mülk değeri, videonun yüklendiği tarih ve saati belirtir.
  • Bir video liste dışı olarak yüklenirse özellik değeri, videonun yüklenildiği tarih ve saati de belirtir. Bu durumda, videonun benzersiz video kimliğini bilen herkes video meta verilerini alabilir.
Değer, ISO 8601 biçiminde belirtilir.
snippet.channelId string
YouTube'un, videonun yüklendiği kanalı benzersiz şekilde tanımlamak için kullandığı kimliktir.
snippet.title string
Videonun başlığı. Mülk değeri en fazla 100 karakter uzunluğundadır ve < ile > hariç tüm geçerli UTF-8 karakterlerini içerebilir. videos.update yöntemini çağırıyor ve bir video kaynağının snippet bölümünü güncelliyorsanız bu mülk için bir değer ayarlamanız gerekir.
snippet.description string
Videonun açıklaması Özellik değerinin maksimum uzunluğu 5.000 bayttır ve < ve > dışındaki geçerli tüm UTF-8 karakterlerini içerebilir.
snippet.thumbnails object
Videoyla ilişkili küçük resimlerin haritası. Haritadaki her nesne için anahtar, küçük resmin adıdır ve değer, küçük resimle ilgili diğer bilgileri içeren bir nesnedir.
snippet.thumbnails.(key) object
Geçerli anahtar değerleri şunlardır:
  • default: Varsayılan küçük resim. Bir videonun veya videoya atıfta bulunan bir kaynağın (ör. oynatma listesi öğesi veya arama sonucu) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Kanalların varsayılan küçük resmi 88 piksel genişliğinde ve 88 piksel yüksekliğindedir.
  • medium – Küçük resmin daha yüksek çözünürlüklü sürümü. Videolar (veya videoya atıfta bulunan kaynaklar) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Bir kanal için bu resim 240 piksel genişliğinde ve 240 piksel yüksekliğindedir.
  • high: Küçük resmin yüksek çözünürlüklü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu görüntü 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanallar için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir.
  • standard: Küçük resmin, high çözünürlüğündeki resimden daha yüksek çözünürlüklü bir sürümü. Bu resim, bazı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri veya arama sonuçları) kullanılabilir. Bu görselin genişliği 640 piksel, yüksekliği 480 pikseldir.
  • maxres: Küçük resmin en yüksek çözünürlüklü sürümü. Bu resim boyutu, bazı videolar ve videolara atıfta bulunan diğer kaynaklar (ör. oynatma listesi öğeleri veya arama sonuçları) için kullanılabilir. Bu resim 1.280 piksel genişliğinde ve 720 piksel yüksekliğindedir.
snippet.thumbnails.(key).url string
Resmin URL'si.
snippet.thumbnails.(key).width unsigned integer
Resmin genişliği.
snippet.thumbnails.(key).height unsigned integer
Resmin yüksekliği.
snippet.channelTitle string
Videonun ait olduğu kanalın başlığı.
snippet.tags[] list
Videoyla ilişkili anahtar kelime etiketlerinin listesi. Etiketler boşluk içerebilir. Mülk değeri en fazla 500 karakter uzunluğunda olabilir. Karakter sınırının hesaplanma şekliyle ilgili aşağıdaki kurallara dikkat edin:
  • Mülk değeri bir listetir ve listedeki öğeler arasındaki virgüller sınıra dahil edilir.
  • Bir etiket boşluk içeriyorsa API sunucusu, etiket değerini tırnak içine alınmış gibi işler ve tırnak işaretleri karakter sınırlamasına dahil edilir. Bu nedenle, karakter sınırları açısından Foo-Baz etiketi yedi karakter içerirken Foo Baz etiketi dokuz karakter içerir.
snippet.categoryId string
Videoyla ilişkili YouTube video kategorisi. videos.update yöntemini çağırıyorsanız ve bir video kaynağının snippet bölümünü güncelliyorsanız bu özellik için bir değer ayarlamanız gerekir.
snippet.liveBroadcastContent string
Videonun yaklaşan/etkin bir canlı yayın olup olmadığını gösterir. Video yaklaşan/etkin bir canlı yayın değilse "none" (yok) değerini alır.

Bu özelliğin geçerli değerleri şunlardır:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
video kaynağının snippet.title ve snippet.description özelliklerindeki metnin dili.
snippet.localized object
snippet.localized nesnesi, video için yerelleştirilmiş bir başlık ve açıklama veya videonun meta verileri için varsayılan dilde başlık içerir.
  • videos.list isteği, yerelleştirilmiş metnin döndürülmesi gereken bir dili belirtmek için hl parametresini kullandıysa ve yerelleştirilmiş metin bu dilde mevcutsa kaynak snippet'inde yerelleştirilmiş metin döndürülür.
  • hl parametresi değeri belirtilmezse veya bir değer belirtilirse ancak belirtilen dil için yerelleştirilmiş meta veri mevcut değilse varsayılan dilin meta verileri döndürülür.
Mülk salt okunur bir değer içeriyor. Yerelleştirilmiş başlıklar eklemek, güncellemek veya silmek için localizations nesnesini kullanın.
snippet.localized.title string
Yerelleştirilmiş video başlığı.
snippet.localized.description string
Yerelleştirilmiş video açıklaması.
snippet.defaultAudioLanguage string
default_audio_language mülkü, videonun varsayılan ses parçasında konuşulan dili belirtir.
contentDetails object
contentDetails nesnesi, video içeriği hakkında, videonun uzunluğu ve videoda altyazı olup olmadığının göstergesi gibi bilgileri içerir.
contentDetails.duration string
Videonun uzunluğu. Özellik değeri, ISO 8601 biçiminde bir süredir. Örneğin, en az bir dakika ve en fazla bir saat uzunluğundaki bir videonun süresi PT#M#S biçimindedir. Bu biçimte PT harfleri, değerin bir süreyi belirttiğini, M ve S harfleri ise süreyi sırasıyla dakika ve saniye cinsinden ifade eder. M ve S harflerinden önceki # karakterleri, videonun dakika (veya saniye) sayısını belirten tam sayıdır. Örneğin, PT15M33S değeri videonun 15 dakika 33 saniye uzunluğunda olduğunu gösterir.

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

Bu mülk için geçerli değerler şunlardır:
  • hd
  • sd
contentDetails.caption string
Videoda altyazı olup olmadığını belirtir.

Bu özelliğin geçerli değerleri şunlardır:
  • false
  • true
contentDetails.licensedContent boolean
Videonun lisanslı içerik gösterip göstermediğini belirtir. Lisanslı içerik, bir YouTube içerik iş ortağına bağlı kanala yüklenen ve ardından bu iş ortağı tarafından hak talebinde bulunulan içeriktir.
contentDetails.regionRestriction object
regionRestriction nesnesi, bir videonun görüntülenebileceği (veya görüntülenemeyeceği) ülkelerle ilgili bilgileri içerir. Nesne, contentDetails.regionRestriction.allowed veya contentDetails.regionRestriction.blocked özelliğini içerir.
contentDetails.regionRestriction.allowed[] list
Videonun görüntülenebileceği ülkeleri tanımlayan bölge kodlarının listesi. Bu özellik mevcutsa ve değerinde bir ülke listelenmemişse videonun söz konusu ülkede gösterilmesi engellenir. Bu özellik mevcutsa ve boş bir liste içeriyorsa video tüm ülkelerde engellenir.
contentDetails.regionRestriction.blocked[] list
Videonun engellendiği ülkeleri tanımlayan bölge kodlarının listesi. Bu özellik mevcutsa ve değerinde bir ülke listelenmemişse video o ülkede görüntülenebilir. Bu mülk mevcutsa ve boş bir liste içeriyorsa video tüm ülkelerde görüntülenebilir.
contentDetails.contentRating object
Videonun çeşitli derecelendirme sistemlerine göre aldığı derecelendirmeleri belirtir.
contentDetails.contentRating.acbRating string
Videonun Australian Classification Board (ACB) veya Australian Communications and Media Authority (ACMA) derecelendirmesi. ACMA derecelendirmeleri, çocuk televizyon programlarını sınıflandırmak için kullanılır.

Bu özellik için geçerli değerler şunlardır:
  • acbC - Avustralya İletişim ve Medya Kurumu tarafından C sınıflandırması yapılan programlardır. 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ı yapılan programlardır. Bu programlar okul öncesi çağındaki çocuklara yöneliktir.
  • acbPg - PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Videonun İtalya'da Autorità per le Garanzie nelle Comunicazioni (AGCOM) tarafından aldığı derecelendirme.

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

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

Bu mülk için geçerli değerler:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 - 18
  • bbfcPg – PG
  • bbfcR18 - 18 Brezilya reali
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Videonun Tayland Film ve Video Sansür Kurulu tarafından verilen derecelendirmesi.

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

Bu tesis için geçerli değerler şunlardır:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14 yaş ve üzeri
  • bmukk16 – 16+
  • bmukk6 - 6 yaş ve üzeri
  • bmukk8 - 8 Yaş ve Üzeri
  • bmukkAa – Kısıtlanmamış
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Kanada TV için derecelendirme sistemi - Kanada TV Sınıflandırma Sistemi Videonun Kanada İngilizcesi yayınları için Kanada Radyo-Televizyon ve Telekomünikasyon Komisyonu'nun (CRTC) derecelendirmesi. Daha fazla bilgi için Kanada Yayın Standartları Konseyi web sitesini inceleyin.

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

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

Bu özellik için geçerli değerler:
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
Videonun Consejo de Calificación Cinematográfica (Şili) derecelendirmesi.

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

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

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

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

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

Bu tesis için geçerli değerler:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18 yaşından büyük
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Fransa'da derecelendirme sistemi - Commission deClassification Cinematographique

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

Bu özellik için geçerli değerler şunlardır:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – Engelleme
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Videonun Lüksemburg Commission de surveillance de laClassification des films (CSCF) tarafından verilen derecelendirmesi.

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

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

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

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

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

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

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

Bu tesis için geçerli değerler şunlardır:
  • fcbm13 – 13
  • fcbm16 - 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl - 18 Polonya zlotisi
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Videonun Hong Kong Film, Gazete ve Makale İdaresi tarafından verilen derecelendirmesi.

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

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

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

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

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

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

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

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

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

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

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

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

Bu özellik için geçerli değerler:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus - 15 이 çözümünü 미람장
  • kmrbAll - 체이람이
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Endonezya'daki Lembaga Sensor Film'den alınan video derecelendirmesi.

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

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

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

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

Bu mülk için geçerli değerler şunlardır:
  • mdaG - G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 - 21. Seviye
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Videonun, Norveç Medya Kurumu Medietilsynet tarafından derecelendirmesi.

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

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

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

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

Bu mülk için geçerli değerler:
  • moctwG – G
  • moctwP – P
  • moctwPg - PG
  • moctwR – R
  • moctwR12 - 12.R
  • moctwR15 - 15 R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
Videonun Motion Picture Association of America (MPAA) derecelendirmesi.

Bu mülk için geçerli değerler şunlardır:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Motion Picture Association of America'nın film fragmanları ve önizlemeleri için derecelendirmesi.

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

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

Bu özellik için geçerli değerler:
  • nbc12plus – 12+
  • nbc15plus – 15+
  • nbc18plus - 18 yaş ve üzeri
  • nbc18plusr - 18+ Sağ
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Bulgar Ulusal Film Merkezi'nin videoya verdiği derecelendirme.

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

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

Bu mülk için geçerli değerler şunlardır:
  • nkclv12plus – 12+
  • nkclv18plus - 18 yaş ve üzeri
  • nkclv7plus - 7 yaş ve üzeri
  • nkclvU - U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Videonun Film ve Edebiyat Sınıflandırma Ofisi (OFLC - Yeni Zelanda) derecelendirmesi.

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

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

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

Bu tesis için geçerli değerler şunlardır:
  • rtcA – A
  • rtcAa – AA
  • rtcB-B
  • rtcB15 – B15
  • rtcC - C
  • rtcD – 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 - Massachusetts, ABD
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Videonun Rusya Federasyonu Ulusal Film Kaydı (MKRF - Rusya) derecelendirmesi.

Bu özellik için geçerli değerler:
  • russia0 - 0+
  • russia12 - 12 yaş ve üzeri
  • russia16 - 16 yaş ve üzeri
  • russia18 – 18 yaşından büyük
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Videonun Slovakya'daki derecelendirmesi.

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

Bu ö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
Videonun, Statens medier dad (İsveç Ulusal Medya Konseyi) tarafından derecelendirmesi.

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

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

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

Bu özellik için geçerli değerler şunlardır:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Videoyu yükleyen kullanıcının video için özel bir küçük resim sağlayıp sağlamadığını belirtir. Bu özellik yalnızca videoyu yükleyen kullanıcı tarafından görülebilir.
status object
status nesnesi videonun yüklenme, işlenme ve gizlilik durumlarıyla ilgili bilgiler 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 mülkü yüklemenin reddedildiğini gösteriyorsa mevcuttur.

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

Bu tesis için geçerli değerler şunlardır:
  • private
  • public
  • unlisted
status.publishAt datetime
Videonun yayınlanmasının planlandığı tarih ve saat. Bu seçenek yalnızca videonun gizlilik durumu gizliyse ayarlanabilir. Değer, ISO 8601 biçiminde belirtilir. Bu mülkün davranışıyla ilgili aşağıdaki iki ek noktaya dikkat edin:
  • videos.update yöntemini çağırırken bu özelliğin değerini ayarlarsanız video zaten gizli olsa bile status.privacyStatus özelliğinin değerini private olarak da ayarlamanız gerekir.
  • İsteğiniz doğrultusunda videonun geçmişte yayınlanması planlanmışsa video hemen yayınlanır. Bu nedenle, status.publishAt mülkünün geçmiş bir tarih ve saate ayarlanmasının etkisi, videonun privacyStatus değerinin private yerine public olarak değiştirilmesiyle aynıdır.
status.license string
Videonun lisansı.

Bu özellik için geçerli değerler şunlardır:
  • creativeCommon
  • youtube
status.embeddable boolean
Bu değer, videonun başka bir web sitesine yerleştirilip yerleştirilemeyeceğini belirtir.
status.publicStatsViewable boolean
Bu değer, videonun izleme sayfasındaki genişletilmiş video istatistiklerinin herkese açık olup olmadığını belirtir. Bu istatistikler varsayılan olarak görüntülenebilir. Bu mülkün değeri false olarak ayarlanmış olsa bile videonun görüntüleme sayısı ve puanları gibi istatistikler herkese açık olarak görünmeye devam eder.
status.madeForKids boolean
Bu değer, videonun çocuklara yönelik olarak tanımlanıp tanımlanmadığını gösterir ve videonun mevcut "çocuklara özel" durumunu içerir. Örneğin, durum selfDeclaredMadeForKids özelliğinin değerine göre belirlenebilir. Kanalınızın, videolarınızın veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.
status.selfDeclaredMadeForKids boolean
videos.insert veya videos.update isteğinde bu özellik, kanal sahibinin videoyu çocuklara yönelik olarak tanımlamasına olanak tanır. videos.list isteğinde, mülk değeri yalnızca kanal sahibi API isteğine yetki verdiyse döndürülür.
status.containsSyntheticMedia boolean
Bu özellik, videos.insert veya videos.update taleplerinde, kanal sahibinin videoda gerçekçi Değiştirilmiş veya Sentetik (A/S) içerik barındırdığını bildirmesine imkan tanır. A/S içeriğiyle ilgili YouTube politikaları hakkında daha fazla bilgi edinin.

A/S içeriğine örnek olarak aşağıdaki videolar verilebilir:
  • Gerçek bir insanı, söylemediği veya yapmadığı bir şeyi söylemiş veya yapmış gibi göstermek
  • 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şturmak
statistics object
statistics nesnesi, videoyla ilgili istatistikleri içerir.
statistics.viewCount unsigned long
Videonun görüntülenme sayısı.
statistics.likeCount unsigned long
Videoyu beğendiğini belirten kullanıcıların sayısı.
statistics.dislikeCount unsigned long
Not: statistics.dislikeCount mülkü 13 Aralık 2021 itibarıyla gizli hale getirilmiştir. Bu, yalnızca API isteğinin kimliği video sahibi tarafından doğrulanırsa özelliğin API yanıtına dahil edileceği anlamına gelir. Daha fazla bilgi için düzeltme geçmişine bakın.

Videoyu beğenmediğini belirten kullanıcıların sayısı.
statistics.favoriteCount unsigned long
Not: Bu özelliğin desteği sonlandırıldı. Desteğin sonlandırılması, 28 Ağustos 2015 tarihinden itibaren geçerli olacaktır. Mülkün değeri artık her zaman 0 olarak ayarlanıyor.
statistics.commentCount unsigned long
Videoya yapılan yorumların sayısı.
paidProductPlacementDetails object
paidProductPlacementDetails nesnesi, videodaki ücretli ürün yerleşimiyle ilgili bilgileri içerir.
paidProductPlacementDetails.hasPaidProductPlacement boolean
İçerikte ücretli ürün yerleşimi kullanılıyorsa true olarak ayarlayın. Varsayılan olarak false değerine ayarlanır.
player object
player nesnesi, videoyu yerleşik bir oynatıcıda oynatmak için kullanacağınız bilgileri içerir.
player.embedHtml string
Videoyu oynatan bir oynatıcıyı yerleştiren <iframe> etiketi.
  • Kaynağı almak için yapılan API isteğinde maxHeight ve/veya maxWidth parametreleri için bir değer belirtilirse yerleşik oynatıcının boyutu, maxHeight ve/veya maxWidth koşullarını karşılayacak şekilde ölçeklendirilir.
  • Videonun en boy oranı bilinmiyorsa yerleşik oynatıcı varsayılan olarak 4:3 biçiminde olur.
player.embedHeight long
player.embedHtml özelliğinde döndürülen yerleşik oynatıcının yüksekliği. Bu özellik yalnızca istek maxHeight ve/veya maxWidth parametreleri için bir değer belirtmişse ve videonun en boy oranı biliniyorsa döndürülür.
player.embedWidth long
player.embedHtml mülkünde döndürülen yerleşik oynatıcının genişliği. Bu özellik yalnızca istek maxHeight ve/veya maxWidth parametreleri için bir değer belirtmişse ve videonun en boy oranı biliniyorsa döndürülür.
topicDetails object
topicDetails nesnesi, videoyla ilişkili konularla ilgili bilgileri içerir.

Önemli: Konu kimlikleriyle ilgili yapılacak değişiklikler hakkında daha fazla bilgi için topicDetails.relevantTopicIds[] ve topicDetails.topicIds[] özelliklerinin tanımlarını ve düzeltme geçmişini inceleyin.
topicDetails.topicIds[] list
Önemli: Bu özelliğin desteği 10 Kasım 2016'dan itibaren sonlandırılmıştır. API artık bu mülk için değer döndürmez ve bir videoyla ilişkili tüm konular artık topicDetails.relevantTopicIds[] mülk değeri tarafından döndürülür.
topicDetails.relevantTopicIds[] list
Videoyla alakalı konu kimliklerinin listesi.

Bu özelliğin desteği, 10 Kasım 2016 itibarıyla sonlandı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 itibarıyla farklı şekilde çalışmaya başladı. Bu dönemde YouTube, az sayıda seçilmiş konu kimliği yayınlamaya başladı.
topicDetails.topicCategories[] list
Videonun içeriğinin üst düzey bir açıklamasını sağlayan Wikipedia URL'lerinin listesi.
recordingDetails object
recordingDetails nesnesi, videonun çekildiği konum, tarih ve adresle ilgili bilgileri kapsar.
recordingDetails.locationDescription string
Bu özelliğin desteği 1 Haziran 2017'den itibaren sonlandırılmıştır. Daha ayrıntılı bilgi için lütfen kullanımdan kaldırma duyurusunu inceleyin.

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

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

Derece cinsinden boylam.
recordingDetails.location.altitude double
Bu özelliğin desteği 9 Temmuz 2018'den itibaren sonlandırılmıştır. Daha ayrıntılı bilgi için lütfen kullanımdan kaldırma duyurusunu inceleyin.

Referans elipsoitinden yükseklik (metre cinsinden).
recordingDetails.recordingDate datetime
Videonun kaydedildiği tarih ve saat. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) biçiminde belirtilir.
fileDetails object
fileDetails nesnesi, YouTube'a yüklenen video dosyasıyla ilgili bilgileri (ör. dosya çözünürlüğü, süresi, ses ve video codec'leri, yayın bit hızları) kapsar. Bu verilere yalnızca videonun sahibi erişebilir.

fileDetails nesnesi yalnızca processingDetails.fileAvailability özelliğinin available değerine sahip olması durumunda döndürülür.
fileDetails.fileName string
Yüklenen dosyanın adı. Bu alan, bir video dosyası veya başka türde bir dosya yüklendiğinde mevcuttur.
fileDetails.fileSize unsigned long
Yüklenen dosyanın bayt cinsinden boyutu. Bu alan, video dosyası veya başka bir dosya türü yüklendiğinde gösterilir.
fileDetails.fileType string
YouTube'un video işleme motoru tarafından algılanan, yüklenen dosyanın türü. YouTube şu anda yalnızca video dosyalarını işlemektedir ancak video dosyası veya başka bir dosya türü yüklendiğinde bu alan mevcuttur.

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

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

processingProgress nesnesi, yüklenen videonun YouTube'un yüklenen video dosyasını işlemedeki ilerleme durumunu izleyebilmesi için ankete tabi tutulacak şekilde tasarlanmıştır. Bu verileri yalnızca video sahibi alabilir.
processingDetails.processingStatus string
Videonun işlenme durumu Bu değer, YouTube'un videoyu işleyip işleyemediğini veya videonun hâlâ işlenip işlenmediğini belirtir.

Bu mülk için geçerli değerler şunlardır:
  • failed – Video işleme başarısız oldu. ProcessingFailureReason değerine bakın.
  • processing: Video şu anda işleniyor. İşleme İlerleme Durumunu görün.
  • succeeded: Video başarıyla işlendi.
  • terminated – İşleme bilgileri artık mevcut değil.
processingDetails.processingProgress object
processingProgress nesnesi, YouTube'un videoyu işleme konusunda kaydettiği ilerlemeyle ilgili bilgileri içerir. Bu değerler yalnızca videonun işleme durumu processing ise geçerlidir.
processingDetails.processingProgress.partsTotal unsigned long
Video için işlenilmesi gereken toplam parça sayısına ilişkin bir tahmin. YouTube videoyu işlerken bu sayı daha kesin tahminlerle güncellenebilir.
processingDetails.processingProgress.partsProcessed unsigned long
Videonun YouTube tarafından işlenen bölümlerinin sayısı. YouTube'un videonun ne kadarını işlediğini tahmin etmek için şunları hesaplayabilirsiniz:
100 * parts_processed / parts_total

Tahmini parça sayısı, işlenen parça sayısına karşılık gelmeden artabileceğinden, YouTube bir videoyu işlerken hesaplanan ilerlemenin zaman zaman azalabileceğini unutmayın.
processingDetails.processingProgress.timeLeftMs unsigned long
YouTube'un videoyu iş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 olduğunda bir değere sahip olur.

Bu mülk için geçerli değerler şunlardır:
  • other – Diğer işleme bileşenlerinden bazıları başarısız oldu.
  • streamingFailed: Video, yayıncılara gönderilemedi.
  • transcodeFailed – İçerik kod dönüştürme işlemi başarısız oldu.
  • uploadFailed – Dosya teslimi başarısız oldu.
processingDetails.fileDetailsAvailability string
Bu değer, yüklenen video için dosya ayrıntılarının mevcut olup olmadığını gösterir. videos.list() isteğinizde fileDetails bölümünü isteyerek videonun dosya ayrıntılarını alabilirsiniz.
processingDetails.processingIssuesAvailability string
Bu değer, video işleme motorunun YouTube'un videoyu işleme özelliğini iyileştirecek öneriler, video işleme sorunlarını açıklayan uyarılar veya video işleme sorunlarına neden olan hatalar oluşturup oluşturmadığını belirtir. videos.list() isteğinizde suggestions bölümünü isteyerek bu önerileri alabilirsiniz.
processingDetails.tagSuggestionsAvailability string
Bu değer, video için anahtar kelime (etiket) önerilerinin kullanılıp kullanılamayacağını gösterir. Diğer kullanıcıların videoyu bulmasını kolaylaştırmak için videonun meta verilerine etiketler eklenebilir. videos.list() isteğinizdeki suggestions bölümünü isteyerek bu önerileri alabilirsiniz.
processingDetails.editorSuggestionsAvailability string
Bu değer, video kalitesini veya oynatma deneyimini iyileştirebilecek video düzenleme önerilerinin video için kullanılıp kullanılamayacağını belirtir. videos.list() isteğinizde suggestions bölümünü isteyerek bu önerileri alabilirsiniz.
processingDetails.thumbnailsAvailability string
Bu değer, video için küçük 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ı tanımlayan önerileri kapsar. Bu verileri yalnızca video sahibi alabilir.

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ılı bir şekilde işlemesini engelleyecek hataların listesi. Bu hatalar, videonun mevcut işleme durumundan bağımsız olarak durumun neredeyse kesinlikle failed olacağını gösterir.

Bu mülk için geçerli değerler şunlardır:
  • archiveFile: Arşiv dosyası (ör. ZIP arşivi).
  • audioFile: Dosya yalnızca ses içerir (ör. MP3 dosyası).
  • docFile – Doküman veya metin dosyası (ör. MS Word dokümanı).
  • imageFile: Resim dosyası (ör. JPEG resim).
  • notAVideoFile – Video olmayan diğer dosya.
  • projectFile – Film projesi dosyası (ör. Microsoft Windows Movie Maker projesi).
suggestions.processingWarnings[] list
YouTube'un yüklenen videonun kodunu dönüştürürken zorluk yaşamasının veya hatalı bir kod dönüştürme işlemine yol açabilecek nedenlerin listesi. Bu uyarılar, YouTube yüklenen video dosyasını işlemeden önce oluşturulur. Ayrıca, video işlemenin başarısız olacağını göstermeyen ancak senkronizasyon sorunları, video kusurları veya eksik ses parçası gibi sorunlara neden olabilecek sorunları da tanımlar.

Bu mülkün geçerli değerleri şunlardır:
  • hasEditlist: Listeleri düzenleme şu anda desteklenmemektedir.
  • inconsistentResolution: Çakışan kapsayıcı ve akış çözünürlükleri.
  • problematicAudioCodec – Sorunlara neden olduğu bilinen ses codec'i kullanıldı.
  • problematicVideoCodec – Sorunlara neden olduğu bilinen video codec'i kullanıldı.
  • unknownAudioCodec: Tanınmayan ses codec'i. Kod dönüştürme işleminin başarısız olma olasılığı yüksektir.
  • unknownContainer: Tanınmayan dosya biçimi. Kod dönüştürme işleminin başarısız olma olasılığı yüksektir.
  • unknownVideoCodec: Tanınmayan video codec'i. Kod dönüştürme işleminin başarısız olma olasılığı yüksektir.
suggestions.processingHints[] list
YouTube'un videoyu işleme yeteneğini artırabilecek önerilerin listesi.

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

Bu mülk için geçerli değerler şunlardır:
  • audioQuietAudioSwap – Ses parçası sessiz görünür ve daha iyi kaliteli bir parçayla değiştirilebilir.
  • videoAutoLevels: Resim parlaklığı düzeyleri yanlış görünüyor ve düzeltilebilir.
  • videoCrop: Resmin etrafında algılanan kenarlıklar (matlar) kırpılabilir.
  • videoStabilize: Video titrek görünüyor ve sabitlenebilir.
liveStreamingDetails object
liveStreamingDetails nesnesi, canlı video yayınıyla ilgili meta verileri içerir. Nesne yalnızca video yaklaşan, canlı veya tamamlanmış bir canlı yayınsa video kaynağında bulunur.
liveStreamingDetails.actualStartTime datetime
Yayının gerçekte başladığı zaman. Değer ISO 8601 biçiminde belirtilir. Bu değer, yayın başlayana kadar kullanılamaz.
liveStreamingDetails.actualEndTime datetime
Yayının gerçekte sona erdiği zaman. Değer ISO 8601 biçiminde belirtilir. Bu değer, yayın sona erene kadar kullanılamaz.
liveStreamingDetails.scheduledStartTime datetime
Yayının başlamasının planlandığı zaman. Değer ISO 8601 biçiminde belirtilir.
liveStreamingDetails.scheduledEndTime datetime
Yayının sona ermesinin planlandığı saat. Değer ISO 8601 biçiminde belirtilir. Değer boşsa veya mülk mevcut değilse yayının süresiz olarak devam etmesi planlanır.
liveStreamingDetails.concurrentViewers unsigned long
Yayını şu anda izleyen kullanıcıların sayısı. Yayında şu anda izleyici varsa ve yayın sahibi videonun görüntüleme sayısını gizlemediyse mülk ve değeri gösterilir. YouTube'un, yayın sona erdiğinde yayındaki eşzamanlı izleyici sayısını izlemeyi durdurduğunu unutmayın. Dolayısıyla bu özellik, sona ermiş bir canlı yayının arşivlenmiş videosunu izleyen izleyicilerin sayısını tanımlamaz.
YouTube Data API'nin döndürdüğü eşzamanlı izleyici sayıları, YouTube Analytics üzerinden erişilebilen, spam'den arındırılmış ve işlenmiş eşzamanlı izleyici sayılarından farklı olabilir. YouTube Yardım Merkezi'nde canlı yayın metrikleri hakkında daha fazla bilgi edinin.
liveStreamingDetails.activeLiveChatId string
Bu videoya eklenmiş ve şu anda etkin olan canlı sohbetin kimliği. Bu alan yalnızca videoda canlı sohbet olan ve şu anda canlı yayınlanan bir yayın varsa doldurulur. Bu alan tamamlanmak üzere yayın geçişleri yapıldıktan sonra canlı sohbet kapatılır. Kalıcı yayınlar için canlı sohbet kimliği artık bu videoya değil, kalıcı sayfada gösterilen yeni videoya bağlanır.
localizations object
localizations nesnesi, videonun meta verilerinin çevirilerini içerir.
localizations.(key) object
Anahtar değeriyle ilişkili yerelleştirilmiş metnin dilidir. 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ı.