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ı, artık ilgili kanalın veya videonun "çocuklara özel" durumunu tanımlayan bir özellik de içeriyor. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları da 10 Ocak 2020'de güncellendi. Daha fazla bilgi için YouTube Data API Hizmeti ve YouTube API Servisleri Hizmet Şartları'nın düzeltme geçmişlerine bakın.

Bir videonun meta verilerini günceller.

Kota etkisi: Bu yönteme yapılan bir ç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, 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/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. Yazma işleminin ayarlayacağı özelliklerin yanı sıra API yanıtının içereceği özellikleri tanımlar.

Bu yöntemin, parametre değerinin belirttiği bölümlerde yer alan tüm değiştirilebilir ö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ü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, video eklenirken veya güncellenirken ayarlanabilecek özellikler tüm bölümlerde bulunmaz. Örneğin, statistics nesnesi YouTube'un bir video için hesapladığı istatistikleri kapsar ve ayarlayabileceğiniz veya değiştirebileceğiniz değerler içermez. Parametre değeri, değiştirilebilir değerler içermeyen bir part belirtiyorsa bu part yine de API yanıtına dahil edilir.

Aşağıdaki listede, parametre değerine ekleyebileceğiniz part adları yer almaktadır:
  • brandPartner
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
İ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ı 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. 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 kimlik doğrulaması yaptığı gerçek İçerik Yönetim Sistemi hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

İstek metni

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

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

    • id
    • snippet.title: Bu özellik yalnızca istek, video kaynağının snippet değerini güncelliyorsa gereklidir.
    • snippet.categoryId: Bu özellik yalnızca istek, video kaynağının snippet değerini güncelliyorsa gereklidir.

  • Bu ö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 özellik için bir değer ayarlarsanız status.privacyStatus özelliğini de private olarak ayarlamanız gerekir. Bu özellik yalnızca videonun gizlilik durumu private ise ve video daha önce hiç yayınlanmadıysa ayarlanabilir.
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    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 video 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ı belirtilmektedir. Daha fazla bilgi için hata mesajı belgelerine bakın.

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 verileri, geçersiz bir planlanmış yayınlama zamanı belirtiyor.
badRequest (400) invalidRecordingDetails İstek meta verilerindeki recordingDetails nesnesi, geçersiz kayıt ayrıntıları belirtiyor.
badRequest (400) invalidTags İstek meta verileri geçersiz video anahtar kelimeleri belirtiyor.
badRequest (400) invalidTitle İstek meta verilerinde geçersiz veya boş bir video başlığı belirtiliyor.
badRequest (400) invalidVideoMetadata İstek meta verileri 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ştirilmiş oynatıcı sunma izni olmayabilir. Daha fazla bilgi için YouTube Yardım Merkezi'ne göz atabilirsiniz.
forbidden (403) forbiddenLicenseSetting İstek, video için geçersiz bir lisans ayarlamaya ç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 kullanın.