Captions

Not: 13 Mart 2024'te YouTube, captions.insert ve captions.update API uç noktaları için sync parametresini kullanımdan kaldıracağını duyurdu. Altyazıları otomatik senkronize etme özelliği YouTube İçerik Stüdyosu'nda kullanılmaya devam edilebilir. Daha fazla bilgi için API düzeltme geçmişi'ne bakın.

caption kaynağı, bir 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

Belirtilen videoyla ilişkili 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 altyazı parçası alma olanağı sağladığını unutmayın. Hemen deneyin.

ekle

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 bir altyazı parçasını siler. Hemen deneyin.

indir

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

Kaynak temsili

Aşağıdaki JSON yapısı, 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, altyazıyla ilgili temel ayrıntıları içerir.
snippet.videoId	string YouTube'un altyazı parçasıyla ilişkilendirilen 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 özellik için geçerli değerler şunlardır: ASR – Otomatik konuşma tanıma kullanılarak oluşturulan bir altyazı parçası. forced – Oynatıcıda başka parça seçilmediğinde oynatılan bir altyazı parçası. Örneğin, yabancıların yabancı dilde konuştuğu bir videoda, altyazı parçasının yalnızca bu yabancı dildeki altyazıları gösterecek şekilde zorunlu tutulabilir. standard – Normal bir altyazı parçasıdır. 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ı. Adın, oynatma sırasında kullanıcıya bir seçenek olarak görülebilmesi amaçlanmıştır. Desteklenen maksimum ad uzunluğu 150 karakterdir.
snippet.audioTrackType	string Altyazı parçasıyla ilişkilendirilmiş ses parçasının türü. Bu özellik için geçerli değerler şunlardır: commentary – Altyazı parçası, dizin yorumu gibi yorum içeren alternatif bir ses parçasına karşılık gelir. descriptive – Altyazı parçası, ek açıklayıcı sesler içeren alternatif bir ses parçasına karşılık gelir. primary – Altyazı parçası, normalde videoyla ilişkilendirilen ses parçası olan videonun birincil ses parçasına karşılık gelir. unknown – Bu 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ı parçası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, yani dili öğrenenler için üçüncü sınıf seviyesinde olup olmadığını belirtir. 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 gösterir. Altyazı parçası yüklenirken senkronizasyon açıkça istendiyse değer true olur. Örneğin, captions.insert veya captions.update yöntemlerini çağırırken YouTube'a, yüklenen parçayı videoyla senkronize etmesini bildirmek 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 özellik için geçerli değerler şunlardır: failed serving syncing
snippet.failureReason	string YouTube'un altyazı parçasını işleyememe nedeni. Bu özellik yalnızca state özelliğinin değeri failed ise mevcuttur. Bu özellik 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.