Captions: download

Bir altyazı parçası indirir. İ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.

Kota etkisi: Bu yönteme yapılan bir çağrının 200 birim kota maliyeti olur.

Yaygın kullanım alanları

İstek

HTTP isteği

GET https://www.googleapis.com/youtube/v3/captions/id

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biriyle yetkilendirme gerekir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsam
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen parametrelerin tümü sorgu parametreleridir.

Parametreler
Gerekli parametreler
id string
id parametresi, alınmakta olan altyazı parçasını tanımlar. Değer, caption kaynağında id özelliği tarafından tanımlandığı şekilde altyazı parçası kimliğidir.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortaklarına yöneliktir.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube CMS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahiplerinin, her kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulaması yaparak tüm video ve kanal verilerine erişmelerine olanak tanır. Kullanıcının kimlik doğrulaması yaptığı gerçek CMS hesabı, belirtilen YouTube içerik sahibine bağlanmalıdır.
tfmt string
tfmt parametresi, altyazı parçasının belirli bir biçimde döndürülmesi gerektiğini belirtir. Parametre isteğe dahil edilmezse parça orijinal biçiminde döndürülür.

Desteklenen değerler şunlardır:
  • sbv – SubViewer alt başlığı
  • scc – Scenarist Altyazı biçimi
  • srt – SubRip altyazısı
  • ttml - Zamanlanmış Metin Biçimlendirme Dili altyazısı
  • vtt - Web Videosu Metin Parçaları altyazısı
tlang string
tlang parametresi, API yanıtının belirtilen altyazı parçasının çevirisini döndürmesi gerektiğini belirtir. Parametre değeri, istenen altyazı dilini tanımlayan bir ISO 639-1 iki harfli dil kodudur. Çeviri, Google Çeviri gibi bir makine çevirisi kullanılarak oluşturulur.

İstek içeriği

Bu yöntemi çağırırken istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem bir ikili dosya döndürür. Yanıtın Content-Type başlığı application/octet-stream şeklindedir.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmıştır. Daha fazla bilgi için lütfen hata mesajı dokümanlarına bakın.

Hata türü Hata ayrıntısı Açıklama
forbidden (403) forbidden İstekle ilişkili izinler altyazı parçasını indirmek için yeterli değildir. İstek uygun şekilde yetkilendirilmemiş veya video siparişi, bu altyazı için üçüncü taraf katkıları etkinleştirmemiş olabilir.
invalidValue (400) couldNotConvert Altyazı parçası verileri istenen dile ve/veya biçime dönüştürülemedi. İstenen tfmt ve tlang değerlerinin geçerli olduğundan ve istenen altyazı parçasının snippet.status değerinin failed olmadığından emin olun.
notFound (404) captionNotFound Altyazı parçası bulunamadı. İsteğin id parametre değerinin doğru olup olmadığını kontrol edin.

Deneyin.

Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer kullanın.