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 olarak senkronize edilmesi özelliği YouTube Studio'da kullanıma devam etmektedir. Daha fazla bilgi için API düzeltme geçmişine göz atın.

caption kaynağı, YouTube altyazı parçasını temsil eder. Altyazı parçaları 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 altyazı parçası alma olanağı sunduğunu unutmayın. Hemen deneyin.
insert
Altyazı parçası yükleyin. Hemen deneyin.
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. Hemen deneyin.
download
Altyazı parçasını indirin. İstek tfmt parametresi için bir değer belirtmediği sürece altyazı parçası orijinal biçiminde, tlang parametresi için bir değer belirtmediği sürece de orijinal dilinde döndürülür. Hemen deneyin.
sil
Belirli bir altyazı parçasını silme. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısında, captions kaynağının biçimi gösterilmektedir:

{
  "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 değeri.
id string
YouTube'un altyazı parçasını benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet object
snippet nesnesi, altyazı hakkında 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ı kanalının en son güncellendiği tarih ve saat. Değer ISO 8601 biçiminde belirtilir.
snippet.trackKind string
Altyazı kanalının türü.

Bu özellik için geçerli değerler şunlardır:
  • ASR: Otomatik konuşma tanıma kullanılarak oluşturulan altyazı parçası.
  • forced: Oynatıcıda başka bir parça seçili olmadığında oynatılan altyazı parçası. Örneğin, uzaylı dilinde konuşan uzaylıları gösteren bir videoda, yalnızca uzaylı dili altyazılarını gösteren zorunlu altyazı kanalı olabilir.
  • standard: Normal altyazı parçası. Bu, varsayılan değerdir.
snippet.language string
Altyazı parçasının dili. Ö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 seçenek olarak gösterilmesi amaçlanmış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ı, yorum içeren alternatif bir ses parçasına (ör. dizin yorumu) 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 kişiler için altyazı içerip içermediğini belirtir. Varsayılan değer: false.
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.
snippet.isEasyReader boolean
Altyazı kanalının "kolay okuyucu" için biçimlendirilip biçimlendirilmediğini belirtir. Yani, dil öğrenenler için üçüncü sınıf düzeyindedir. Varsayılan değer: false.
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.
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 sync parametresini true olarak ayarlayarak YouTube'a yüklenen parçayı videoyla senkronize etmesini talimat verebilirsiniz. Değer false ise YouTube, altyazıların ne zaman gösterileceğini belirlemek için yüklenen altyazı kanalındaki zaman kodlarını kullanır.
snippet.status string
Altyazı kanalı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şleyememesinin 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.