Channels: update

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 ilgili kanalın veya videonun "çocuklara özel" durumunu tanımlayan bir özellik de içeriyor. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları da 10 Ocak 2020'de güncellendi. Daha fazla bilgi için YouTube Data API Hizmeti ve YouTube API Hizmetleri Hizmet Şartları'nın düzeltme geçmişlerine bakın.

Bir kanalın meta verilerini günceller. Bu yöntemin yalnızca channel kaynağının brandingSettings, invideoPromotion ve localizations nesneleri ile bunların alt özelliklerinde yapılan güncellemeleri desteklediğini unutmayın.

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

Yaygın kullanım alanları

İstek

HTTP isteği

PUT https://www.googleapis.com/youtube/v3/channels

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir. Kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinmek için OAuth 2.0 yetkilendirmesini uygulama başlıklı makaleyi inceleyin.

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. Yazma işleminin ayarlayacağı özelliklerin yanı sıra API yanıtının içereceği özellikleri tanımlar.

API, parametre değerinin yalnızca brandingSettings, invideoPromotion veya localizations olarak ayarlanmasına izin verir. (Bu bölümlerden yalnızca birini tek bir istekle güncelleyebilirsiniz.)

Bu yöntemin, parametre değerinin belirttiği bölümde yer alan tüm değiştirilebilir özelliklerin mevcut değerlerini geçersiz kıldığını unutmayın.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca düzgün ş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 işlem yaptığını gösterir. Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahipleri, bu özellik sayesinde bir kez kimlik doğrulama yaparak tüm video ve kanal verilerine erişebilir. Her kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamaları gerekmez. Kullanıcının kimliğini doğruladığı gerçek İYS hesabının, belirtilen YouTube içerik sahibine bağlı olması gerekir.

İstek, yönetilen bir kanalda işlem yapan bir İYS içerik sahibi kullanıcısının kimlik bilgileriyle doğrulanırsa bu parametre sağlanmalıdır. Atlanırsa istek, kimliği doğrulanmış kullanıcının doğrudan bağlamı altında yürütülür ve HTTP 403 Forbidden hatası döndürülür.

İstek metni

İstek gövdesinde bir channel kaynağı sağlayın. Bu kaynak için:

  • Şu özellikler için bir değer belirtmeniz gerekir:

    • id

  • Bu özellikler için değerler 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

    Bir güncelleme isteği gönderiyorsanız ve isteğinizde, zaten bir değeri olan bir özellik için değer belirtilmiyorsa özelliğin mevcut değeri silinir.

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir channel kaynağı döndürür.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için YouTube Data API - Hatalar başlıklı makaleyi inceleyin.

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 yönergeleri uygulayarak özellik değerlerini güncelleyin.
badRequest (400) channelTitleUpdateForbidden Bir kanalın brandingSettings part özelliğini güncellerken brandingSettings.channel.title özelliğinin değerini kanalın mevcut başlığına ayarlamanız veya özelliği çıkarmanız gerekir. Mülkün değerini değiştirirseniz API hata döndürür.
badRequest (400) defaultLanguageNotSetError defaultLanguage, localizations değerini güncelleyecek şekilde 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önergeleri uygulayarak bu değerleri güncelleyin.
badRequest (400) invalidCustomMessage İstek meta verileri geçersiz bir özel mesaj belirtiyor. İsteğin gönderildiği kaynakta 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önderildiği kaynakta 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önderildiğ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 zaman farkı 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 zaman farkı belirtiyor. İsteğin gönderildiğ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ğini belirlemek için geçersiz bir zamanlama yöntemi belirtiyor. İsteğin gönderildiğ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 kaynak dokümanlarındaki yönergeleri uygulayarak bu değerleri güncelleyin.
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 bulunamadı. Kanal kimliğinin doğru olduğundan emin olmak için isteğin gönderildiğ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 yok.
notFound (404) unknownChannelId Belirtilen kanal kimliği bulunamadı.
notFound (404) unknownChannelId Belirtilen recentlyUploadedBy kanal kimliği bulunamadı.
notFound (404) unknownVideoId Tanıtılan öğe olarak belirtilen video kimliği bulunamıyor.
required (400) requiredItemIdType İstek meta verileri, invideoPromotion bölümünde bir öğe türü belirtmelidir.
required (400) requiredItemId İstek meta verilerinde, invideoPromotion bölümünde bir öğe kimliği belirtilmelidir.
required (400) requiredTimingOffset YouTube'un tanıtılan öğenin ne zaman gösterileceğini belirleyebilmesi için istek meta verilerinde varsayılan bir zaman farkı belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.defaultTiming.offsetMs özelliğinin değerini ayarlayın.
required (400) requiredTimingOffset YouTube'un tanıtılan öğeyi ne zaman göstereceğini belirleyebilmesi için istek meta verilerinde bir zamanlama farkı belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.timing.offsetMs özelliğinin değerini ayarlayın.
required (400) requiredTimingType YouTube'un tanıtılan öğeyi ne zaman göstereceğini belirleyebilmesi için istek meta verilerinde bir zamanlama yöntemi belirtilmelidir. İsteğin gönderdiği kaynakta invideoPromotion.defaultTiming.type özelliğinin değerini ayarlayın.
required (400) requiredTimingType YouTube'un tanıtılan öğeyi ne zaman göstereceğini belirleyebilmesi için istek meta verilerinde bir zamanlama yöntemi belirtilmelidir. İ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ği ile yanıtını görmek için APIs Explorer kullanın.