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 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.