Videos: update

API artık kanalınızı veya videolarınızı "çocuklara özel" olarak işaretleme özelliğini destekliyor. Ayrıca, channel ve video kaynaklarında bu kanalın veya videonun "çocuklara özel" durumunu tanımlayan bir mülk de yer alıyor. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları da 10 Ocak 2020 tarihinde güncellendi. Daha fazla bilgi için lütfen YouTube Data API Hizmeti ve YouTube API Hizmetleri Hizmet Şartları'nın düzeltme geçmişlerine bakın.

Videonun meta verilerini günceller.

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

Yaygın kullanım alanları

İstek

HTTP isteği

PUT https://www.googleapis.com/youtube/v3/videos

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsam
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

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. Bu parametre, yazma işleminin ayarlayacağı özelliklerin yanı sıra, API yanıtının dahil edeceği özellikleri de tanımlar.

Bu yöntemin, parametre değerinin belirttiği tüm parçalarda bulunan tüm değişebilir özelliklerin mevcut değerlerini geçersiz kılacağını unutmayın. Örneğin, bir videonun gizlilik ayarı status bölümünde yer alır. Bu nedenle, isteğiniz gizli bir videoyu güncelliyorsa ve isteğin part parametre değeri status bölümünü içeriyorsa videonun gizlilik ayarı, istek gövdesinde belirtilen değere göre güncellenir. İstek gövdesinde bir değer belirtilmezse mevcut gizlilik ayarı kaldırılır ve video, varsayılan gizlilik ayarına geri döner.

Ayrıca, tüm videolar video eklenirken veya güncellenirken ayarlanabilecek özellikler içermez. Örneğin, statistics nesnesi, YouTube'un bir video için hesapladığı ve ayarlayabileceğiniz veya değiştirebileceğiniz değerleri içermeyen istatistikleri içerir. Parametre değeri, değişebilir değerler içermeyen bir part belirtiyorsa bu API, API yanıtına yine dahil edilir.

Aşağıdaki listede parametre değerine ekleyebileceğiniz part adları yer almaktadır:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca uygun bir yetkili istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları içindir.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İYS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalının sahibi ve yöneticisi olan YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimlik doğrulaması yapabilir ve tüm video ve kanal verilerine erişebilir. Kullanıcının kimlik doğrulaması yaptığı gerçek İYS hesabı, belirtilen YouTube içerik sahibine bağlanmalıdır.

İstek metni

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

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

    • id
    • snippet.title: Bu özellik yalnızca istek video kaynağının snippet sürümünü güncellerse gereklidir.
    • snippet.categoryId: Bu özellik yalnızca istek video kaynağının snippet sürümünü güncellerse gereklidir.

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

    • snippet.categoryId
    • snippet.defaultLanguage
    • snippet.description
    • snippet.tags[]
    • snippet.title
    • status.embeddable
    • status.license
    • status.privacyStatus
    • status.publicStatsViewable
    • status.publishAt – Bu mülk için bir değer belirlerseniz status.privacyStatus özelliğini de private olarak ayarlamanız gerekir.
    • status.selfDeclaredMadeForKids
    • recordingDetails.locationDescription (kullanımdan kaldırıldı)
    • recordingDetails.location.latitude (kullanımdan kaldırıldı)
    • recordingDetails.location.longitude (kullanımdan kaldırıldı)
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    Güncelleme isteği gönderiyorsanız ve isteğiniz, halihazırda değeri olan bir mülk için değer belirtmiyorsa mülkün mevcut değeri silinir.

Yanıt

Başarılı olursa bu yöntem yanıt gövdesinde bir video 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 ayrıntı için lütfen hata mesajı dokümanlarını inceleyin.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) defaultLanguageNotSet API isteği, video ayrıntılarının varsayılan dilini belirtmeden yerelleştirilmiş video ayrıntıları eklemeye çalışıyor.
badRequest (400) invalidCategoryId snippet.categoryId özelliği geçersiz bir kategori kimliği belirtiyor. Desteklenen kategorileri almak için videoCategories.list yöntemini kullanın.
badRequest (400) invalidDefaultBroadcastPrivacySetting İstek, varsayılan yayın için geçersiz bir gizlilik ayarı belirlemeye çalışıyor.
badRequest (400) invalidDescription İstek meta verileri geçersiz bir video açıklaması belirtiyor.
badRequest (400) invalidPublishAt İstek meta verisi, geçersiz bir planlanan yayın zamanı belirtiyor.
badRequest (400) invalidRecordingDetails İstek meta verilerindeki recordingDetails nesnesi, geçersiz kayıt ayrıntılarını belirtir.
badRequest (400) invalidTags İstek meta verileri geçersiz video anahtar kelimeleri belirtiyor.
badRequest (400) invalidTitle İstek meta verileri geçersiz veya boş bir video başlığı belirtiyor.
badRequest (400) invalidVideoMetadata İstek meta verisi geçersiz.
forbidden (403) forbidden
forbidden (403) forbiddenEmbedSetting İstek, video için geçersiz bir yerleştirme ayarı belirlemeye çalışıyor. Bazı kanalların canlı yayınlar için yerleşik oynatıcılar sunma izni olmayabileceğini unutmayın. Daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin.
forbidden (403) forbiddenLicenseSetting İstek, video için geçersiz bir lisans belirlemeye çalışıyor.
forbidden (403) forbiddenPrivacySetting İstek, video için geçersiz bir gizlilik ayarı belirlemeye çalışıyor.
notFound (404) videoNotFound Güncellemeye çalıştığınız video bulunamıyor. İstek gövdesindeki id alanının değerini kontrol ederek doğru olduğundan emin olun.

Deneyin.

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