Bu sayfa, Cloud Translation API ile çevrilmiştir.

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.