Captions: download

Altyazı parçasını indirir. İstek tfmt parametresi için bir değer belirtmediği sürece altyazı parçası orijinal biçiminde, istek tlang parametresi için bir değer belirtmediği sürece de orijinal dilinde döndürülür.

Kota etkisi: Bu yöntemin çağrısı 200 birim kota maliyetine sahiptir.

Yaygın kullanım örnekleri

İstek

HTTP isteği

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

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az birinde yetkilendirme gerektirir (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 tüm parametreler sorgu parametreleridir.

Parametreler
Gerekli parametreler
id string
id parametresi, alınan altyazı parçasını tanımlar. Değer, caption kaynağındaki id mülkü tarafından tanımlanan altyazı parçası kimliğidir.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube içerik yönetim sistemi kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip ve bu kanalları yöneten YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her kanal için kimlik doğrulama kimlik bilgilerini sağlamak zorunda kalmadan bir kez kimlik doğrulama yaparak tüm video ve kanal verilerine erişebilir. Kullanıcının kimliğini doğruladığı asıl İYS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.
tfmt string
tfmt parametresi, altyazı kanalı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:
  • sbv – SubViewer altyazı
  • scc – Scenarist Closed Caption biçimi
  • srt – SubRip altyazı
  • ttml – Zamanlanmış Metin Biçimlendirme Dili altyazı
  • vtt – Web Video Metin Parçaları altyazı
tlang string
tlang parametresi, API yanıtının belirtilen altyazı kanalı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ğlamaz.

Yanıt

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

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için lütfen hata mesajı belgelerine 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ğil. İstek düzgün bir şekilde yetkilendirilmemiş 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ı kanalının snippet.status değerinin failed olmadığından emin olun.
notFound (404) captionNotFound Altyazı parçası bulunamadı. İsteğin id parametresinin değerinin doğru olduğundan emin olun.

Deneyin!

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