Videos: update

Bu 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 söz konusu kanal ya da videonun "çocuklara özel" durumunu tanımlayan bir mülk de içeriyor. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları da 10 Ocak 2020'de 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.

Bir videonun meta verilerini günceller.

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

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 biriyle yetkilendirme 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 parametrelerin tümü sorgu parametreleridir.

Parametreler
Gerekli parametreler
part string
Bu işlemde part parametresi iki amaca hizmet eder. Hem yazma işleminin ayarlanacağı özellikleri hem de API yanıtının içereceği özellikleri tanımlar.

Bu yöntemin, parametre değerinin belirttiği herhangi bir bölümde yer alan değişebilir özelliklerin tümünün mevcut değerlerini geçersiz kılacağını unutmayın. Örneğin, videonun gizlilik ayarı status bölümündedir. 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. İsteğin gövdesinde bir değer belirtilmezse mevcut gizlilik ayarı kaldırılır ve video varsayılan gizlilik ayarına döner.

Ayrıca, bazı bölümlerde video eklerken veya güncellerken ayarlanabilecek özellikler bulunmaz. Örneğin, statistics nesnesi YouTube'un bir video için hesapladığı istatistikleri içerir ancak ayarlayabileceğiniz veya değiştirebileceğiniz değerleri içermez. Parametre değeri, değişken 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ı bulunmaktadı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 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.

İstek içeriği

İsteğin 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 değerini güncellerse gereklidir.
    • snippet.categoryId: Bu özellik, yalnızca istek video kaynağının snippet değerini güncellerse gereklidir.

  • Şu ö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 özellik 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ğ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 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 bilgi için lütfen hata mesajı dokümanlarına 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 zamanlanmış yayınlama saati 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 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ı belirlemeye çalışıyor. Bazı kanalların canlı yayınlar için yerleşik oynatıcılar sunma izni olmayabilir. Daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.
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. Doğru olduğundan emin olmak için istek gövdesindeki 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 kullanın.