Channels: 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.

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.