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:
|
|
İ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 istekvideo
kaynağınınsnippet
sürümünü güncellerse gereklidir.snippet.categoryId
: Bu özellik yalnızca istekvideo
kaynağınınsnippet
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 belirlersenizstatus.privacyStatus
özelliğini deprivate
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.