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