Captions: insert

Altyazı parçası yükler.

Bu yöntem, medya yüklemeyi destekler. Yüklenen dosyalar aşağıdaki kısıtlamalara uygun olmalıdır:

  • Maksimum dosya boyutu: 100 MB
  • Kabul edilen medya MIME türleri: text/xml, application/octet-stream, */*

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

Yaygın kullanım örnekleri

İstek

HTTP isteği

POST https://www.googleapis.com/upload/youtube/v3/captions

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir. Kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinmek için OAuth 2.0 yetkilendirmesini uygulama başlıklı makaleyi inceleyin.

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
part string
part parametresi, API yanıtının içereceği caption kaynak parçalarını belirtir. Parametre değerini snippet olarak ayarlayın.

Aşağıdaki listede, parametre değerine dahil edebileceğiniz part adları yer almaktadır:
  • id
  • snippet
İ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 olan 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 tek seferde kimlik doğrulama yapabilir ve tüm video ve kanal verilerine erişebilir. Kullanıcının kimliğini doğruladığı gerçek İYS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.
sync boolean
Bu parametrenin desteği sonlandırılmıştır. sync parametresi, YouTube'un altyazı dosyasını videonun ses parçasıyla otomatik olarak senkronize edip etmeyeceğinizi belirtir. Değeri true olarak ayarlarsanız YouTube, yüklenen altyazı dosyasında bulunan zaman kodlarını yoksayıp altyazılar için yeni zaman kodları oluşturur.

Zaman kodu içermeyen bir transkript yüklüyorsanız veya dosyanızdaki zaman kodlarının yanlış olduğundan şüphelenip YouTube'un bunları düzeltmeye çalışmasını istiyorsanız sync parametresini true olarak ayarlamanız gerekir.

İstek içeriği

İstek gövdesinde bir caption kaynağı sağlayın. Bu kaynak için:

Aşağıdaki özellikler için bir değer belirtmeniz gerekir:

  • snippet.videoId
  • snippet.language
  • snippet.name

Aşağıdaki özellikler için değer ayarlayabilirsiniz:

  • snippet.videoId
  • snippet.language
  • snippet.name
  • snippet.isDraft

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir caption kaynağı döndürür.

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 YouTube Data API - Errors başlıklı makaleyi inceleyin.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) contentRequired İstek, altyazı parçası içeriklerini içermiyor.
conflict (409) captionExists Belirtilen videoda, belirtilen snippet.language ve snippet.name ile altyazı parçası zaten mevcut. Bir videoda aynı dil için birden fazla parça olabilir ancak her parçanın farklı bir adı olmalıdır.

Bu hatayı düzeltmenin birden fazla yolu vardır. Mevcut parçayı silip yeni bir parça ekleyebilir veya yeni parçayı eklemeden önce adını değiştirebilirsiniz.
forbidden (403) forbidden İstekle ilişkili izinler, altyazı parçasını yüklemek için yeterli değil. İstek düzgün bir şekilde yetkilendirilmemiş olabilir.
invalidValue (400) invalidMetadata İstekte, parçanın oluşturulmasını engelleyen geçersiz meta veri değerleri bulunuyor. İstekte snippet.language, snippet.name ve snippet.videoId özellikleri için geçerli değerlerin belirtildiğinden emin olun. snippet.isDraft özelliği de eklenebilir ancak gerekli değildir.
notFound (404) videoNotFound videoId parametresi tarafından tanımlanan video bulunamadı.
invalidValue (400) nameTooLong İstekte belirtilen snippet.name çok uzun. En fazla 150 karakter desteklenmektedir.

Deneyin!

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