Captions: download

Altyazı dosyası indirir. İstekte tfmt parametresi için bir değer belirtilmediği sürece altyazı dosyası orijinal biçiminde, tlang parametresi için bir değer belirtilmediği sürece orijinal dilinde döndürülür.

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

Bu yöntem, kullanıcının videoyu düzenleme iznine sahip olmasını gerektirir.

Yaygın kullanım alanları

İstek

HTTP isteği

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

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle 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ı dosyasını tanımlar. Değer, caption kaynağındaki id özelliği tarafından tanımlanan bir altyazı dosyası 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 İçerik Yönetim Sistemi 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. Bu sayede içerik sahipleri, her kanal için ayrı ayrı kimlik doğrulama bilgileri girmek zorunda kalmadan tek bir kimlik doğrulama işlemiyle tüm video ve kanal verilerine erişebilir. Kullanıcının kimliğini doğruladığı asıl İçerik Yönetim Sistemi hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.
tfmt string
tfmt parametresi, altyazı dosyası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ısı
  • scc – Scenarist Altyazı biçimi
  • srt – SubRip altyazısı
  • ttml: Timed Text Markup Language altyazısı
  • vtt: Web Video Metin Kanalları altyazısı
tlang string
tlang parametresi, API yanıtının belirtilen altyazı dosyası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 makine çevirisi kullanılarak oluşturulur.

İstek metni

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

Yanıt

Başarılı olursa bu yöntem bir ikili program dosyası döndürür. Yanıtın Content-Type üstbilgisi 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ı belirtilmektedir. 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ı dosyasını indirmek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
invalidValue (400) couldNotConvert Altyazı dosyası 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ı dosyasının snippet.status değerinin failed olmadığından emin olun.
notFound (404) captionNotFound Altyazı dosyası bulunamadı. İsteğin id parametresinin değerini kontrol ederek 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.