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 dilindetlang
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:
|
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:
|
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:
|
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:
|