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.
Kanalın meta verilerini günceller. Bu yöntemin şu anda yalnızca channel
kaynağının brandingSettings
, invideoPromotion
ve localizations
nesnelerinde ve bunların alt özelliklerinde yapılan güncellemeleri desteklediğini unutmayın.
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/channels
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. Yazma işleminin ayarlanacağı özelliklerin yanı sıra API yanıtının içereceği özellikleri de tanımlar.API, şu anda yalnızca parametre değerinin brandingSettings , invideoPromotion veya localizations olarak ayarlanmasına izin veriyor. (Bu bölümlerden herhangi birini yalnızca tek bir istekle güncelleyebilirsiniz.)Bu yöntemin, parametre değerinin belirttiği bölümde yer alan tüm değişebilir özelliklerin mevcut değerlerini geçersiz kıldığını unutmayın. |
|
İsteğe bağlı parametreler | ||
onBehalfOfContentOwner |
string Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. onBehalfOfContentOwner parametresi, kimliği doğrulanmış kullanıcının parametre değerinde belirtilen içerik sahibi adına hareket ettiğini belirtir. 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 kimliğini doğruladığı gerçek CMS hesabı, belirtilen YouTube içerik sahibine bağlanmalıdır. |
İstek içeriği
İstek gövdesinde bir kanal kaynağı sağlayın. Söz konusu kaynak için:
-
Şu özellikler için bir değer belirtmelisiniz:
id
-
Şu özellikler için değer ayarlayabilirsiniz:
brandingSettings.channel.country
brandingSettings.channel.description
brandingSettings.channel.defaultLanguage
brandingSettings.channel.keywords
brandingSettings.channel.trackingAnalyticsAccountId
brandingSettings.channel.unsubscribedTrailer
localizations.(key)
localizations.(key).title
localizations.(key).description
status.selfDeclaredMadeForKids
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 kanal 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) |
brandingValidationError |
brandingSettings nesnesindeki değerlerden biri doğrulanamadı. Kanalın mevcut ayarlarını almak için channels.list yöntemini kullanın ve channels kaynak dokümanlarındaki kurallara uygun şekilde mülk değerlerini güncelleyin. |
badRequest (400) |
channelTitleUpdateForbidden |
Bir kanalın brandingSettings part değerini güncellerken brandingSettings.channel.title özelliğinin değerini kanalın mevcut başlığı olarak ayarlamanız veya özelliği atlamanız gerekir. Özelliğin değerini değiştirirseniz API hata verir. |
badRequest (400) |
defaultLanguageNotSetError |
localizations güncellemesi için defaultLanguage ayarlanmalıdır. |
badRequest (400) |
invalidBrandingOption |
Belirttiğiniz markalama ayarlarından biri mevcut değil. Geçerli değerleri almak için channels.list yöntemini kullanın ve channels kaynak dokümanlarındaki yönergelere uyarak bunları güncellediğinizden emin olun. |
badRequest (400) |
invalidCustomMessage |
İstek meta verileri, geçersiz bir özel mesaj belirtiyor. İsteğin gönderdiği kaynaktaki invideoPromotion.items[].customMessage özelliğinin değerini kontrol edin. |
badRequest (400) |
invalidDuration |
İstek meta verileri, invideoPromotion bölümünde geçersiz bir süre belirtiyor. |
badRequest (400) |
invalidDuration |
İstek meta verileri, tanıtılan öğenin video oynatıcıda nasıl konumlandırılacağını belirlemek için geçersiz bir konum türü belirtiyor. İsteğin gönderdiği kaynaktaki invideoPromotion.position.type özelliğinin değerini kontrol edin. |
badRequest (400) |
invalidRecentlyUploadedBy |
İstek meta verileri geçersiz bir kanal kimliği belirtiyor. İsteğin gönderdiği kaynaktaki invideoPromotion.items[].id.recentlyUploadedBy özelliğinin değerini kontrol edin. |
badRequest (400) |
invalidTimingOffset |
İstek meta verileri, invideoPromotion bölümünde geçersiz bir zamanlama ofseti belirtiyor. |
badRequest (400) |
invalidTimingOffset |
İstek meta verileri, tanıtılan öğenin video oynatıcıda ne zaman gösterileceğini belirlemek için geçersiz bir zamanlama ofseti belirtiyor. İsteğin gönderdiği kaynaktaki invideoPromotion.timing.offsetMs özelliğinin değerini kontrol edin. |
badRequest (400) |
invalidTimingType |
İstek meta verileri, tanıtılan öğenin video oynatıcıda ne zaman gösterileceğinin belirlenmesi için geçersiz bir zamanlama yöntemi belirtiyor. İsteğin gönderdiği kaynaktaki invideoPromotion.timing.type özelliğinin değerini kontrol edin. |
badRequest (400) |
localizationValidationError |
Yerelleştirme nesnesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için channels.list yöntemini kullanın ve kanalların kaynak belgelerindeki yönergeleri izleyerek değerleri güncellediğinizden emin olun. |
badRequest (400) |
tooManyPromotedItems |
invideoPromotion bölümünde izin verilen tanıtılan öğe sayısı aşıldı. |
forbidden (403) |
channelForbidden |
id parametresinde belirtilen kanal, isteği desteklemiyor veya istek düzgün şekilde yetkilendirilmemiş. |
forbidden (403) |
promotedVideoNotAllowed |
API isteğinin güncellemeye çalıştığı kanal bulunamıyor. Kanal kimliğinin doğru olduğundan emin olmak için isteğin gönderdiği channel kaynağındaki id özelliğinin değerini kontrol edin. |
forbidden (403) |
websiteLinkNotAllowed |
Belirtilen web sitesi URL'sine izin verilmiyor. |
notFound (404) |
channelNotFound |
id parametresinde belirtilen kanal bulunamıyor. |
notFound (404) |
channelNotFound |
id parametresiyle belirtilen kanal bulunamıyor veya markalama seçenekleri içermiyor. |
notFound (404) |
unknownChannelId |
Belirtilen kanal kimliği bulunamadı. |
notFound (404) |
unknownChannelId |
Belirtilen recentUploadBy kanal kimliği bulunamadı. |
notFound (404) |
unknownVideoId |
Tanıtılan öğe olarak belirtilen video kimliği bulunamıyor. |
required (400) |
requiredItemIdType |
İstek meta verilerinin invideoPromotion bölümünde bir öğe türü belirtilmesi gerekir. |
required (400) |
requiredItemId |
İstek meta verilerinin invideoPromotion bölümünde bir öğe kimliği belirtilmesi gerekir. |
required (400) |
requiredTimingOffset |
YouTube'un tanıtılan öğenin ne zaman gösterileceğini belirleyebilmesi için istek meta verilerinin varsayılan zamanlama farkını belirtmesi gerekir. İsteğin gönderdiği kaynakta invideoPromotion.defaultTiming.offsetMs özelliğinin değerini ayarlayın. |
required (400) |
requiredTimingOffset |
YouTube'un tanıtılan öğenin ne zaman gösterileceğini belirleyebilmesi için istek meta verilerinin zamanlama farkını belirtmesi gerekir. İsteğin gönderdiği kaynakta invideoPromotion.timing.offsetMs özelliğinin değerini ayarlayın. |
required (400) |
requiredTimingType |
İstek meta verileri, YouTube'un tanıtılan öğenin ne zaman gösterileceğini belirleyebilmesi için bir zamanlama yöntemi belirtmelidir. İsteğin gönderdiği kaynakta invideoPromotion.defaultTiming.type özelliğinin değerini ayarlayın. |
required (400) |
requiredTimingType |
İstek meta verileri, YouTube'un tanıtılan öğenin ne zaman gösterileceğini belirleyebilmesi için bir zamanlama yöntemi belirtmelidir. İsteğin gönderdiği kaynakta invideoPromotion.timing.type özelliğinin değerini ayarlayın. |
required (400) |
requiredTiming |
İstek meta verileri, invideoPromotion bölümündeki her öğe için bir zamanlama belirtmelidir. |
required (400) |
requiredVideoId |
İstek meta verileri, tanıtılan öğeyi tanımlamak için bir video kimliği belirtmelidir. |
required (400) |
requiredWebsiteUrl |
İstek meta verilerinin invideoPromotion bölümünde bir web sitesi URL'si belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.items[].id.websiteUrl özelliğinin değerini ayarlayın. |
Deneyin.
Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer kullanın.