Captions

Not: YouTube, 13 Mart 2024'te captions.insert ve captions.update API uç noktaları için sync parametresinin desteğinin sonlandırılacağını duyurdu. Altyazıların otomatik senkronizasyonu, YouTube İçerik Stüdyosu'nda hâlâ kullanılabilir. Bkz. Şunun için API düzeltme geçmişi: inceleyebilirsiniz.

caption kaynağı, YouTube altyazı parçasını temsil eder. Bir altyazı parçası tam olarak bir YouTube videosuyla ilişkilendirilir.

Yöntemler

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

list

Belirli bir videoyla ilişkilendirilmiş altyazı parçalarının listesini alın. API yanıtının gerçek altyazıları içermediğini ve captions.download yönteminin bir altyazı parçası alma özelliği sağladığını unutmayın. Hemen deneyin.

ekle

Bir altyazı parçası yükleyin.

güncelle

Altyazı parçasını güncelleme. Bir altyazı parçasını güncellerken parçanın taslak durumunu değiştirebilir, parça için yeni bir altyazı dosyası yükleyebilir veya her ikisini birden yapabilirsiniz.

sil

Belirtilen altyazı parçasını silme Hemen deneyin.

indirin

Bir altyazı parçası indirin. tlang parametresi için bir değer belirtilmediği sürece istek, tfmt parametresi için bir değer ve orijinal dilinde bir değer belirtmediği sürece altyazı parçası orijinal biçiminde döndürülür.

Kaynak temsili

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

{
  "kind": "youtube#caption",
  "etag": etag,
  "id": string,
  "snippet": {
    "videoId": string,
    "lastUpdated": datetime,
    "trackKind": string,
    "language": string,
    "name": string,
    "audioTrackType": string,
    "isCC": boolean,
    "isLarge": boolean,
    "isEasyReader": boolean,
    "isDraft": boolean,
    "isAutoSynced": boolean,
    "status": string,
    "failureReason": 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#caption olur.
etag	etag Bu kaynağın ETag'i.
id	string YouTube'un altyazı parçasını benzersiz şekilde tanımlamak için kullandığı kimliktir.
snippet	object snippet nesnesi, başlıkla ilgili temel ayrıntıları içerir.
snippet.videoId	string YouTube'un altyazı parçasıyla ilişkili videoyu benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet.lastUpdated	datetime Altyazı parçasının en son güncellendiği tarih ve saat. Değer, ISO 8601 biçiminde belirtilir.
snippet.trackKind	string Altyazı parçasının türü. Bu tesis için geçerli değerler şunlardır: ASR – Otomatik konuşma tanıma kullanılarak oluşturulmuş bir altyazı parçası. forced – Oynatıcıda başka parça seçilmediğinde çalınan bir altyazı parçası. Örneğin, uzaylıların yabancı bir dilde konuştuğu bir videoda, sadece yabancı dilde altyazı gösterilmesi zorunlu bir altyazı parçası bulunabilir. standard – Normal bir altyazı parçası. Bu, varsayılan değerdir.
snippet.language	string Altyazı parçasının dilidir. Özellik değeri bir BCP-47 dil etiketidir.
snippet.name	string Altyazı parçasının adıdır. Ad, oynatma sırasında kullanıcıya bir seçenek olarak gösterilecek şekilde tasarlanmıştır. En fazla 150 karakter desteklenir.
snippet.audioTrackType	string Altyazı parçasıyla ilişkili ses parçasının türü. Bu özellik için geçerli değerler şunlardır: commentary – Altyazı parçası, dizin yorumları gibi anlatım içeren alternatif bir ses parçasına karşılık gelir. descriptive: Altyazı parçası, ek açıklayıcı ses içeren alternatif bir ses parçasına karşılık gelir. primary: Altyazı parçası, videonun birincil ses parçasına (normalde videoyla ilişkilendirilen ses parçası) karşılık gelir. unknown: Varsayılan değerdir.
snippet.isCC	boolean Parçanın işitme engelli ve duyma zorluğu çeken kullanıcılar için altyazı içerip içermediğini belirtir. Varsayılan değer false değeridir.
snippet.isLarge	boolean Altyazı kanalında görme engelliler için büyük metin kullanılıp kullanılmadığını belirtir. Varsayılan değer false değeridir.
snippet.isEasyReader	boolean Altyazı parçasının "kolay okuyucu" olarak biçimlendirilip biçimlendirilmediğini belirtir. yani dil öğrencileri için üçüncü sınıf seviyesindedir. Varsayılan değer false değeridir.
snippet.isDraft	boolean Altyazı parçasının taslak olup olmadığını belirtir. Değer true ise parça herkese açık değildir. Varsayılan değer false değeridir.
snippet.isAutoSynced	boolean YouTube'un altyazı parçasını videodaki ses parçasıyla senkronize edip etmediğini belirtir. Altyazı parçası yüklenirken açıkça senkronizasyon istenmişse değer true olur. Örneğin, captions.insert veya captions.update yöntemlerini çağırırken YouTube'a yüklenen parçayı videoyla senkronize etmesi için sync parametresini true olarak ayarlayabilirsiniz. Değer false ise YouTube, altyazıların ne zaman gösterileceğini belirlemek için yüklenen altyazı parçasındaki zaman kodlarını kullanır.
snippet.status	string Altyazı parçasının durumu. Bu tesis için geçerli değerler şunlardır: failed serving syncing
snippet.failureReason	string YouTube'un altyazı parçasını işleyememesinin nedeni. Bu özellik yalnızca state özelliğinin değeri failed olduğunda bulunur. Bu mülk için geçerli değerler şunlardır: processingFailed – YouTube, yüklenen altyazı parçasını işleyemedi. unknownFormat – Altyazı parçasının biçimi tanınmadı. unsupportedFormat: Altyazı parçasının biçimi desteklenmiyor.