Captions: update

Altyazı dosyasını günceller. 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.

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önteme yapılan bir çağrının kota maliyeti 450 birimdir.

Yaygın kullanım alanları

İstek

HTTP isteği

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

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
part string
part parametresi bu işlemde iki amaca hizmet eder. Yazma işleminin ayarlayacağı özelliklerin yanı sıra API yanıtının içereceği özellikleri de tanımlar. Parçanın taslak durumunu güncelliyorsanız özellik değerini snippet olarak ayarlayın. Aksi takdirde, özellik değerini id olarak ayarlayın.

Aşağıdaki listede, parametre değerine ekleyebileceğ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 işlem yapan bir YouTube İYS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahipleri, bu özellik sayesinde bir kez kimlik doğrulama yaparak tüm video ve kanal verilerine erişebilir. Her kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamaları gerekmez. 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.
sync boolean
Bu parametrenin desteği sonlandırılmıştır. Not: API sunucusu, parametre değerini yalnızca istekte güncellenmiş bir altyazı dosyası varsa işler.

sync parametresi, YouTube'un altyazı dosyasını videonun ses parçasıyla otomatik olarak senkronize edip etmeyeceğini belirtir. Değeri true olarak ayarlarsanız YouTube, altyazı dosyasını ses parçasıyla otomatik olarak senkronize eder.

İstek metni

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

  • Şu özellikler için bir değer belirtmeniz gerekir:

    • id

  • Bu özellikler için değerler ayarlayabilirsiniz:

    • snippet.isDraft

    Bir güncelleme isteği gönderiyorsanız ve isteğinizde, zaten değeri olan bir özellik için değer belirtilmiyorsa özelliğin mevcut değeri silinir.

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir altyazı 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 lütfen hata mesajı belgelerine bakın.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) contentRequired İstek, güncellenmiş bir altyazı dosyası yüklemedi. sync parametresi true olarak ayarlanmışsa gerçek parça içerikleri gereklidir.
forbidden (403) forbidden İstekle ilişkili izinler, altyazı dosyasını güncellemek için yeterli değil. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404) captionNotFound Belirtilen altyazı dosyası bulunamadı. Doğru olduğundan emin olmak için isteğin id özelliğinin değerini kontrol edin.

Deneyin.

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