Captions: update

Bir altyazı parçasını günceller. Bir 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 şu kısıtlamalara uymalı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 450 birimlik kota maliyeti vardır.

Yaygın kullanım alanları

İstek

HTTP isteği

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

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
part string
Bu işlemde part parametresi iki amaca hizmet eder. Yazma işleminin ayarlayacağı özelliklerin yanı sıra API yanıtının içereceği özellikleri tanımlar. Kanalı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 liste, parametre değerine ekleyebileceğiniz part adlarını içerir:
  • id
  • snippet
İ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.
sync boolean
Bu parametrenin desteği sonlandırıldı. Not: API sunucusu, parametre değerini yalnızca istekte güncellenmiş altyazı dosyası varsa işler.

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

İstek içeriği

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

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

    • id

  • Şu özellikler için değer ayarlayabilirsiniz:

    • snippet.isDraft

    Güncelleme isteği gönderiyorsanız ve isteğinizde halihazırda değer bulunan bir mülk için bir değer belirtmiyorsa mülkün 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 çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için lütfen hata mesajı dokümanlarına bakın.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) contentRequired Talep, güncellenmiş bir altyazı dosyası yüklememiştir. sync parametresi true olarak ayarlanırsa gerçek kanal içerikleri gereklidir.
forbidden (403) forbidden İstekle ilişkili izinler, altyazı parçasını güncellemek için yeterli değildir. İstek düzgün şekilde yetkilendirilmemiş olabilir.
notFound (404) captionNotFound Belirtilen altyazı parçası bulunamadı. İsteğin id özelliği 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.