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 özelliğe de sahip. 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 Hizmetleri Hizmet Şartları'nın düzeltme geçmişlerine bakın.

Bir videonun meta verilerini günceller.

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

Yaygın kullanım örnekleri

İ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 amaç için kullanılır. 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 tüm kısımlarda bulunan 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 tüm bölümler, video eklerken veya güncellerken ayarlanabilecek özellikleri içermez. Ö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 belirtirse bu part API yanıtına yine de dahil edilir.

Aşağıdaki listede, parametre değerine dahil edebileceğiniz part adları yer almaktadır:
  • 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 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 bunları 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ığı asıl İYS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

İstek içeriği

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

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

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

  • Aşağıdaki özellikler için değer 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 ayarlarsanız status.privacyStatus mülkünü de private olarak ayarlamanız gerekir.
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    Güncelleme isteği gönderiyorsanız ve isteğinizde, halihazırda değeri olan bir tesis için bir değer belirtilmiyorsa tesisin 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ı tanımlanmaktadır. Daha fazla bilgi için 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 mülkü 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ı ayarlamaya ç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ı belirtir.
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 verileri geçersiz.
forbidden (403) forbidden
forbidden (403) forbiddenEmbedSetting İstek, video için geçersiz bir yerleştirme ayarı ayarlamaya çalışıyor. Bazı kanalların canlı yayınlarda yerleşik oynatıcı sunma izni olmayabilir. Daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin.
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ı ayarlamaya çalışıyor.
notFound (404) videoNotFound Güncellemeye çalıştığınız video bulunamıyor. Doğru olduğundan emin olmak için istek gövdesinde id alanının değerini kontrol edin.

Deneyin!

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