YouTube Content ID API - Düzeltme Geçmişi

Not: YouTube Content ID API, YouTube içerik iş ortakları tarafından kullanılmak üzere tasarlanmıştır ve tüm geliştiriciler veya tüm YouTube kullanıcıları tarafından erişilemez. YouTube Content ID API'yi Google API Konsolu'nda listelenen hizmetler arasında görmüyorsanız YouTube İş Ortağı Programı hakkında daha fazla bilgi edinmek için YouTube Yardım Merkezi'ne göz atın.

Bu sayfada, YouTube Content ID API değişiklikleri ve doküman güncellemeleri listelenmiştir.

26 Mart 2025

YouTube, 31 Mart 2025'ten itibaren Shorts görüntülemelerinin sayılma şeklini değiştirecek. Daha önce, Shorts videolarının saniye cinsinden belirli bir süre oynatılması görüntüleme olarak sayılıyordu. Artık Shorts görüntülemeleri hesaplanırken minimum izlenme süresine artık bakılmayacak. Oynatma veya tekrar oynatma işlemlerinin her biri, başladığı andan itibaren görüntüleme olarak sayılacak. Daha fazla bilgi

Content ID API, 30 Haziran 2025'e kadar bu değişiklik doğrultusunda aşağıdaki şekilde güncellenecektir:

• claimSearch.list.sort için sıralama ölçütleri güncellenecek:
  • DAILY_ENGAGED_VIEWS, önceki görüntüleme sayma yöntemine göre günlük görüntüleme sayılarına eklenir.
  • LIFETIME_ENGAGED_VIEWS, önceki görüntüleme sayma yöntemine göre yaşam boyu görüntüleme sayılarına eklenir.
• assetSearch.list.sort için sıralama ölçütleri güncellenecek:
  • DAILY_ENGAGED_VIEWS, önceki görüntüleme sayma yöntemine göre günlük görüntüleme sayılarına eklenir.

Content ID API, 30 Eylül 2025'e kadar bu değişiklik doğrultusunda aşağıdaki şekilde güncellenecektir:

• assetSearch.list.sort sıralama düzeni VIEWS için destek sonlandırılacak.
• claimSearch.list.sort sıralama düzeni VIEW_COUNT için destek sonlandırılacak.
• claimSearch.claimSnippet.videoViews, Shorts görüntülemelerinin sayımında kullanılan güncellenmiş yöntemi yansıtacak şekilde güncellenecektir.
• claimSearch.claimSnippet.engagedViews, önceki görüntüleme sayma yöntemine göre görüntüleme sayılarına eklenir

14 Ocak 2025

videoAdvertisingOption kaynağının autoGeneratedBreaks[] alanının güncellenmesine karar verdik. Artık ad_breaks ve autoGeneratedBreaks değerlerinin aynı anda sağlanmasına izin veriyoruz. adBreaks tanımlanmış bir videoda autoGeneratedBreaks true olarak ayarlanırsa sistemlerimiz, manuel olarak yerleştirilmiş reklam alanlarınıza ek olarak reklam gösterilecek yerleri belirler. Daha fazla bilgi için destek makalesine bakın.

10 Kasım 2023

videoAdvertisingOption kaynağının adFormats[] alanı, bu alan için geçerli tek değer third_party olacak şekilde güncellendi. Artık aşağıdaki reklam biçimleri desteklenmiyor: instream_trueview, instream_standard, display, preroll, postroll. Daha fazla bilgi için destek makalesine bakın.

1 Haziran 2023

Not: Bu, desteği sonlandırılan bir özellik duyurusudur.

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • videoAdvertisingOption kaynağının breakPosition[] alanı, desteği sonlandırılan olarak işaretlendi ve 2024'te kaldırılacak.
    videoAdvertisingOptions.update ve videoAdvertisingOptions.patch yöntemleri zaten alanı yoksaymaktadır.
  • videoAdvertisingOption kaynağının desteği sonlandırılan adBreaks[].slot[] alanı kaldırıldı.
  • asset kaynağının desteği sonlandırılan category ve showCustomId alanları kaldırıldı.
  • Yeni claim kaynağının timeStatusLastModified alanı, bir hak talebinin son değiştirildiği zamanı bildirir.
  • Yeni claimSearch.list yönteminin isVideoShortsEligible parametresi, hak talebinde bulunulan videoları YouTube Shorts uygunluklarına göre filtrelemek için kullanılabilir.

• Yeni kaynaklar ve yöntemler

  • API artık YouTube Music kaynaklarının listelenmesini destekliyor:
    • musicRelease kaynakları, musicReleases.list yöntemiyle listelenir.
    • musicTrack kaynakları, musicTracks.list yöntemiyle listelenir.
    • musicChangeRequest kaynakları, musicChangeRequests.list yöntemiyle listelenir.

20 Aralık 2022

assetSearch.list yönteminin ownershipRestriction sorgusu parametresinin tanımı, bu parametrenin değeri none ise metadataSearchFields parametre değerinin de en az bir kimlik filtresi kullanması gerektiğini açıklığa kavuşturmak için güncellendi. Bu doküman değişikliği, API davranışında yapılan bir değişikliğe işaret etmez.

9 Kasım 2022

asset.get ve asset.list yöntemleriyle ilgili dokümanlar, aşağıdakiler için birden fazla değerin nasıl desteklendiğini açıklayacak şekilde güncellendi:

• fetchMatchPolicy (get, list)
• fetchMetadata (get, list)
• fetchOwnership (get, list)

28 Eylül 2022

Lisanslanabilirlik bilgileri asset resource dosyasına eklendi.

18 Temmuz 2022

claimSearch.list yönteminin inactiveReasons dokümanları, YouTube Studio ile tutarlılık için yapılan iyileştirmeleri yansıtacak şekilde güncellendi:

• Studio, daha önce Audio Swap ve Song Erase için desteği kaldırmıştı. İlgili API değerleri audio_removed ve song_erased sessizce yok sayıldı ve artık dokümanlar kapsamında yer almıyor.
• channel_whitelisted, channel_allowlisted ile değiştirildi. Önceki değer artık dokümanlar içinde yer almıyor ancak desteklenmeye devam ediyor.
• closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced ve video_modified değerleri artık desteklenmektedir.

14 Haziran 2022

assetSearch kaynağı dokümanları, isrcs[] ve iswcs[] adlı iki yeni özelliği yansıtacak şekilde güncellendi. Yeni isrcs[] ve iswcs[] özellik değerlerinin her biri, arama sonucu tarafından tanımlanan öğeyle eşleşen bir ISRC veya ISWC belirten bir dize değeri dizisi içerir.

Yeni mülkler daha doğru veriler sağladığı için assetSearch kaynaklarına dahil edilmiş isrc ve iswc mülkleri yerine yeni mülkler önerilir. Yeni mülkler olası bir dize değeri dizisi listeleyebilirken isrc ve iswc mülkleri her biri arama sonucuyla ilişkili yalnızca bir ISRC veya ISWC kodu tanımlar.

12 Mayıs 2022

İstemci kitaplıklarının bağlantıları, standart Google API'leri istemci kitaplıklarına yönlendirecek şekilde güncellendi. PHP için önceden oluşturulmuş bağlamalar güncellendi.

3 Mayıs 2022

claimSearch.list yönteminin status parametresi artık olası hak talebi ayrıntılarına dayalı daha fazla filtreyi desteklemektedir.

2 Mayıs 2022

assetSearch.list yönteminin Yanıtı ile ilgili dokümanlar, AIP-158 ile tutarlılık için yapılan iyileştirmeleri yansıtacak şekilde güncellendi:

• pageInfo.totalResults değerinin açıklamasında, değerin gerçek değer değil tahmin olduğu açıkça belirtiliyor
• pageInfo.resultsPerPage ve pageInfo.startIndex alanları kaldırıldı

25 Nisan 2022

assetLabels.list kaynağının dokümanları, labelPrefix ve q istek parametrelerinin anlamını netleştirmek ve istek / yanıtın sayfalandırmayı desteklediğini belirtmek için güncellendi.

8 Aralık 2021

claimSearch.list kaynağının dokümanları, bu yöntemin kapsadığı iki kullanım alanını doğru şekilde yansıtacak şekilde güncellendi:

• Kimliğe (öğe, referans veya video) ya da sorgu dizesine göre arama yapma
• Hak talebinin oluşturulma tarihine, değiştirilme tarihine veya durumuna göre arama yapma

Her kullanım alanı farklı bir sorgu parametresi grubunu destekler. claimSearch.list yönteminin dokümanları, her kullanım alanı için hangi parametrelerin desteklendiğini açıklamak üzere güncellendi.

17 Kasım 2021

Bu güncelleme aşağıdaki değişiklikleri içerir:

• claims.update yöntemi artık etkin olmayan veya potansiyel bir hak talebinin durumunu active olarak güncelleme özelliğini destekliyor. claim kaynağının status mülkünün tanımı daha fazla ayrıntı sağlar.
• claim ve claimSearch kaynaklarının dokümanları, hak talebiyle ilgili YouTube Studio sayfalarının bağlantılarını içeren yeni studioInfo nesnesinin eklenmesini yansıtacak şekilde güncellendi.
• claimSearch.list yönteminin origin parametresi için desteklenen değerler listesi değişti. Parametre artık dört ek değeri desteklemektedir: batchTool, inProductShorts, melodyMatch ve youTubeAdmin. Ayrıca dropboxUpload ve webUpload değerleri artık desteklenmiyor.

26 Şubat 2021

claimSearch.list yönteminin videoId parametresi için hazırlanan dokümanlar, parametre değerinin artık virgülle ayrılmış en fazla 10 video kimliğini kabul ettiğini belirtecek şekilde güncellendi. Değer 10'dan fazla video kimliği içeriyorsa API, badRequest hatası (400 HTTP yanıt kodu) döndürür.

6 Aralık 2018

Not: Bu, desteği sonlandırılan bir özellik duyurusudur.

API dokümanları, contentOwnerAdvertisingOptions kaynağına ve yöntemlerine yapılan referansları kaldıracak şekilde güncellendi. Bu yöntemler çok az kullanılıyordu ve bu yöntemlerden yararlanan API kullanıcılarıyla bu duyurudan önce ayrı olarak iletişime geçildi.

21 Mart 2018

Bu güncelleme aşağıdaki değişiklikleri içerir:

• metadataMine.artist mülkü artık müzik videosu veya ses kaydı öğesi eklediğiniz, güncellediğiniz ya da yamaladığınız her seferinde ayarlanmalıdır. Mülk bu kaynak türleri için ayarlanmamışsa API artık hata döndürüyor. Ayrıca, metadataMine.artist mülkünün yalnızca müzik videosu ve ses kaydı sanatçıları için desteklendiğini unutmayın.

24 Temmuz 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni package kaynağı, web, SFTP veya başka bir yayınlama mekanizması aracılığıyla yayınlanan bir dosya grubunu temsil eder. API, bu kaynak için iki yöntemi destekler:

  • package.insert yöntemi, tam olarak bir meta veri dosyası içeren yalnızca meta veri paketini doğrular ve yükler.
  • package.get yöntemi, daha önce yüklenen bir paketle ilgili bilgileri alır.

• validator.validate yöntemi için uploaderName mülkünün tanımı, değerin verileri yükleyen içerik iş ortağını değil, içerik sahibinin kullandığı belirli yükleyici hesabını tanımlayan web-google veya yt-google gibi bir değeri tanımlayacak şekilde güncellendi.

• reference kaynağının status mülkü, bir referansın başka bir referansın kopyası olduğunu belirtmek için artık duplicate_on_hold değerini kullanmıyor. Bunun yerine, bir referans yinelenen ise status özelliğinin değeri inactive, statusReason özelliğinin değeri ise REASON_DUPLICATE_FOR_OWNERS olarak ayarlanır.

  Ancak daha önce olduğu gibi, kaynağın duplicateLeader mülkü yalnızca referans yinelenen bir referanssa doldurulur. Bu özellik ayarlanmışsa ilgili özelliğin değeri yinelenen referansı tanımlar.

17 Nisan 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yalnızca beste öğeleriyle alakalı olan yeni assetShare kaynağı, bir öğe kaynağının iki temsili arasındaki ilişkiyi tanımlar. Bu temsiller, haklarınızın ses kaydı öğeleriyle ilişkilendirilme şekli konusunda daha fazla şeffaflık ve kontrol sunmak için tasarlanmış yeni bir yayınlama verisi modelini yansıtır.

  Yeni modelde her ses kaydı, beste görünümü adı verilen tam olarak bir benzersiz öğeyle eşlenir. Bu öğenin meta verileri, YouTube'un belirli bir kayıtla ilişkili beste hakları hakkında gösterdiği standart bilgi grubunu temsil eder ve birden fazla veri sağlayıcıdan alınan bilgileri sentezleyebilir.

  Ayrıca, besteyi paylaşan her kullanıcının kendi beste paylaşımı öğesi vardır. Beste paylaşımı, belirli bir yayıncının beste öğesi için sağladığı bilgileri temsil eder. Beste paylaşımı, birçok ses kaydıyla ilişkilendirilebilir.

  assetShare kaynağı, bir kompozisyon görünümü ile kompozisyon paylaşımı arasındaki ilişkiyi tanımlar. Yeni assetShares.list yöntemi, aşağıdakilerden birini yapmanıza olanak tanır:

  • Bir beste görünümünün kimliğini sağlayın ve böyle bir paylaşım varsa isteği yetkilendiren iş ortağının sahip olduğu ilgili beste paylaşımını alın.
  • İçerik iş ortağının sahip olduğu bir beste paylaşımının kimliğini sağlayın ve bu paylaşımın bağlı olduğu tüm beste görünümlerinin listesini alın.

• Yeni Beste öğelerini yönetme kılavuzunda, bu yöntemlere gönderilen öğe kimliklerinin beste görüntülemelerini mi yoksa beste paylaşımlarını mı tanımladığına bağlı olarak farklı API yöntemlerinin istekleri nasıl işlediği açıklanmaktadır.

• contentOwnerAdvertisingOptions kaynağının yeni claimedVideoOptions.autoGeneratedBreaks mülkü, YouTube'un 10 dakikadan uzun hak talebinde bulunulan videolarda otomatik olarak reklam araları oluşturup oluşturmayacağını belirtir. Bu özellik, içerik sahibinin 10 dakikadan uzun tüm videolarını etkiler. Bir videoda birden fazla hak talebi varsa videoyla ilgili olarak bu özelliğin varsayılan davranışını, video için hak talebinde bulunan ilk iş ortağı belirler.

11 Ağustos 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Mühendislik ve Geliştiriciler Blogu'nda ayrıntılı olarak ele alınan, yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar") mevcut Hizmet Şartları'nda zengin bir güncelleme grubu sunar. Bu güncelleme, 10 Şubat 2017'den itibaren geçerli olacak Güncellenen Şartlar'a ek olarak, geliştiricilerin uyması gereken politikaları açıklamaya yardımcı olacak çeşitli destekleyici dokümanlar içerir.

  Yeni dokümanların tamamı Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmaktadır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde gelecekte yapılacak değişiklikler de bu düzeltme geçmişinde açıklanacaktır. İlgili dokümandaki bir bağlantıdan, düzeltme geçmişindeki değişiklikleri listeleyen bir RSS özet akışına abone olabilirsiniz.

31 Mayıs 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni kaynaklar ve yöntemler

  • Yeni validator.validate yöntemi, bir meta veri dosyasının YouTube'un dosyayı başarıyla işlemesini engelleyecek doğrulama hataları içerip içermediğini belirlemenize olanak tanır. Dosyada hata varsa API yanıtının errors mülkünde, her bir hatanın önemini, nedenini ve yerini tanımlayan doğrulama hatalarının listesi yer alır.

• Yeni ve güncellenmiş hatalar

  • assets.patch ve assets.update yöntemleri artık aşağıdaki hatayı desteklemektedir. Bir yöntemin aynı hata türüne sahip birden fazla hatayı destekleyebileceğini hatırlatmak isteriz. Olası hataların tam listesi için lütfen her yöntemin hata belgelerine veya hatalar sayfasına bakın.

    Hatalar
    invalidValue (400)	parameters.assetId Güncellenen öğe başka bir öğeyle birleştirildiği için istek başarısız oldu. assetId parametresinin değeri olarak hata mesajında döndürülen öğenin kimliğini kullanarak isteği yeniden gönderin.

28 Mart 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • claim kaynağının yeni matchInfo.matchSegments[] mülkü, her öğenin hak talebinde bulunulan videonun, referans videonun bir kısmıyla eşleşen bir segmentini tanımladığı bir liste içerir. Bir hak talebinde birden fazla eşleşme segmenti olabilir. Örneğin, yüklenen bir videonun ses ve video içeriği referans videonunkiyle eşleşirse iki eşleşme segmenti olur. Bir segment ses eşleşmesini, diğeri ise video eşleşmesini tanımlar.

    API, her eşleşme segmenti için eşleşen içeriğin süresini ve türünü (ses veya video) döndürür. API, her eşleşme segmentinin hem hak talebinde bulunulan videoda hem de referans videoda başladığı ve bittiği zaman kaymalarını da tanımlar.

  • contentOwnerAdvertisingOptions kaynağının claimedVideoOptions.newVideoDefaults[] mülk değeri artık contentOwnerAdvertisingOptions.patch veya contentOwnerAdvertisingOptions.update yöntemlerini çağırdığınızda güncellenebilir.

  • contentOwnerAdvertisingOptions kaynağının salt okunur allowedOptions.autoGeneratedBreaks özelliğinin desteği sonlandırıldı.

• Yeni ve güncellenmiş hatalar

  • API'nin claims.update yöntemi artık aşağıdaki hatayı desteklemektedir. Bir yöntemin aynı hata türüne sahip birden fazla hatayı destekleyebileceğini hatırlatmak isteriz. Olası hataların tam listesi için lütfen her yöntemin hata belgelerine veya hatalar sayfasına bakın.

    Hatalar
    badRequest (400)	alreadyClaimed Hak talebi, mevcut başka bir hak talebinin kopyasıdır ve güncellenemez.

  • assets.list yöntemi zaman zaman zaman aşımı sorunuyla karşılaşır ve özellikle istek birçok öğenin verilerini aldığında ve fetchMatchPolicy parametresinin değeri effective olduğunda 500 HTTP yanıt kodu (Internal Server Error) döndürür. assets.list isteğiniz birden fazla öğe kimliği belirtiyorsa ve 500 hatası döndürüyorsa isteği tek bir öğe veya daha az sayıda öğe için yeniden göndermeyi deneyin.

  • references.insert hatası dokümanları, istek bozuk bir referans dosyası yüklerse bu sorunun, referans işlenene kadar tanımlanmadığını belirtecek şekilde güncellendi. Bu nedenle, references.insert isteği başarılı bir yanıt döndürse bile referans başarıyla işlenmemiş olabilir. Referans ekledikten sonra, referansın beklendiği gibi etkinleştirildiğini onaylamak için references.list yöntemini kullanarak anket yapmanızı öneririz.

3 Şubat 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • API artık ürün listeleme reklamlarını destekliyor. Ürün listeleme reklamları, video içeriğiyle ilgili veya video içeriğinde yer alan ürünleri öne çıkarır. Bu reklamlar, video sırasında gösterilen sponsorlu kartlardır. Kartlar, reklam sistemi tarafından otomatik olarak eklenir. İzleyiciler, birkaç saniye boyunca karta ait bir bilgi simgesi görür ve videonun kartlarına göz atmak için sağ üst kısımdaki simgeyi de tıklayabilir.

    Bu değişiklik sonucunda product_listing artık aşağıdaki özelliklerin değerlerine dahil edilebilir:

    Kaynak/API yöntemi	Mülk
    contentOwnerAdvertisingOptions	allowedOptions.licAdFormats[]
    contentOwnerAdvertisingOptions	allowedOptions.ugcAdFormats[]
    contentOwnerAdvertisingOptions	claimedVideoOptions.newVideoDefaults[]
    videoAdvertisingOptions	adFormats[]
    videoAdvertisingOptions.getEnabledAds	countriesRestriction[].adFormats[]

  • assetSearch.list yönteminin yeni createdBefore ve createdAfter parametreleri, API'ye yalnızca belirli bir tarihten önce ve/veya sonra oluşturulan öğeleri döndürme talimatı verir.

  • assetSearch.list isteğine verilen API yanıtında type mülkü artık art_track_video değerini destekliyor. Albüm kapaklı videolar hakkında daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin.

  • claimSearch.list yöntemi aşağıdaki yeni parametreleri destekler:

    Parametreler
    referenceId	Bu filtre parametresi, hak talebi aldığınız referansın YouTube referans kimliğini belirtir.
    inactiveReasons	Bu isteğe bağlı parametre, API yanıtını yalnızca etkin olmayan hak taleplerini içerecek şekilde kısıtlamanıza olanak tanır. Bu kısıtlama, hak taleplerinin etkin olmama nedenine göre yapılır. Parametre tanımında, arama yapabileceğiniz etkin olmayan hak talebi türleri listelenir.
    partnerUploaded	Bu isteğe bağlı boole parametresi, API yanıtının yalnızca iş ortağı tarafından yüklenen veya iş ortağı tarafından yüklenmeyen hak taleplerini içermesi gerektiğini belirtmenize olanak tanır.

  • reference kaynağının yeni references#origination nesnesi, referansın kaynağını açıklayan bilgileri içerir.

  • references.insert yöntemi artık YouTube'un gfp_gen yazılımı kullanılarak oluşturulan referansların yüklenmesini destekliyor. Önceden oluşturulmuş bir parmak izi sağlarsanız yüklenen reference kaynağında fpDirect mülk değerini true olarak ayarlayın.

    Bu değişiklikle birlikte, referans yüklerken fpDirect mülkünü ayarlamaya çalıştığınızda API'nin artık hata döndürmediğini unutmayın.

• Yeni ve güncellenmiş hatalar

  Belgede artık whitelist kaynağının yöntemleri tarafından döndürülen hatalar listelenmektedir.

  Ayrıca aşağıdaki tabloda, API'nin desteklediği yeni hatalar ve her bir hatayı döndürebilecek yöntemler tanımlanmaktadır. Bir yöntemin aynı hata türüne sahip birden fazla hata döndürebileceğini unutmayın. Daha fazla bilgi için lütfen her yöntemin hata dokümanlarına veya hatalar sayfasına bakın.

  Hatalar
  badRequest (400)	inappropriateCampaignTarget Bir kampanya bazı kullanıcılar için uygunsuz olabilecek bir videoyu öne çıkarmaya çalışırsa campaigns.insert ve campaigns.update yöntemleri bu hatayı döndürür. Hatayı düzeltmek için lütfen öne çıkarılacak farklı bir içerik seçin.
  badRequest (400)	canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets Beste veya ses kaydı öğesi içeren, iş ortağı tarafından yüklenen bir hak talebi oluşturmaya çalışırsanız claims.insert yöntemi bu hatayı döndürür.
  badRequest (400)	existingSoundRecordingOrMusicVideoClaim Belirtilen videoda kayıtlı müzik için zaten bir hak talebi varsa claims.insert yöntemi bu hatayı döndürür. Doğrudan derleme hak talepleri API üzerinden eklenemez.
  badRequest (400)	asset_id İstek bir dosya üzerinden referans oluşturmaya çalıştıysa ancak istek bir assetId belirtmediyse references.insert yöntemi bu hatayı döndürür.
  badRequest (400)	canNotBeActivated Referans, muhtemelen referansın durumu veya sahiplik koşulları nedeniyle etkinleştirilemiyorsa references.update yöntemi bu hatayı döndürür.
  badRequest (400)	videoNotClaimed Reklamcılık seçeneklerini almak istediğiniz video için hak talebinde bulunmadıysanız videoAdvertisingOptions.get yöntemi bu hatayı döndürür ve istenen bilgilere erişemezsiniz.

18 Aralık 2015

Avrupa Birliği (AB) yasaları, AB'deki son kullanıcılara belirli bilgilerin verilmesini ve bu kullanıcılardan izin alınmasını zorunlu kılar. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekir. YouTube API Hizmet Şartlarımız'a bu şartla ilgili bir bildirim ekledik.

21 Nisan 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni campaign kaynağı, içerik sahibinin hak talebinde bulunulan, kullanıcı tarafından yüklenen videolardaki içeriği tanıtmak için ek açıklamaları kullanmasına olanak tanıyan belirli bir içerik sahibi kampanyasını temsil eder. Örneğin, içerik sahipleri, filmlerinden sahneler içeren ve hak talebinde bulunulan, kullanıcı tarafından yüklenen videolara filmin izleme sayfasına yönlendiren bağlantılar ekleyen bir kampanya oluşturabilir.

  API, get, list, insert, update, patch ve delete campaign kaynaklarına yönelik yöntemleri destekler.

• API, yeni campaigns.get, campaigns.insert, campaigns.update ve campaigns.delete yöntemleri için çeşitli yeni hataları destekler.

30 Mart 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • assetSearch.list yönteminin yeni isrcs parametresi, 50 adede kadar ISRC'nin listesini belirtmenize olanak tanır. API yanıtı, bu ISRC'lerle ilişkili öğeleri içerir.

  • claimHistory kaynağının event[].reason mülkü aşağıdaki yeni değerleri destekler. Her neden, hak talebiyle ilgili belirli bir olayın neden gerçekleştiğini açıklar:

    • closed_audio_claim_on_visual_reference
    • closed_partner_exclusion
    • closed_reference_conflict

  • claimSearch.list yönteminin yeni sort parametresi, API yanıtında kaynakları sıralamak için kullanılacak yöntemi belirtir. Kaynaklar varsayılan olarak oluşturuldukları tarihlere göre ters kronolojik sırada (en yeniden en eskiye doğru) sıralanır. Kaynakları, hak talebinde bulunulan içerik için görüntüleme sayısına göre en yüksekten en düşüğe doğru da sıralayabilirsiniz.

    claimSearch.list isteği status parametre değerini appealed, disputed, pending, potential veya routedForReview olarak da ayarlarsa sonuçların, hak talebi inceleme süresinin sona erdiği zamana göre sıralandığını unutmayın.

  • ownership.update ve ownership.patch yöntemleri artık bu yöntemler çağrılırken güncellenebilecek tüm özellikleri doğru şekilde listeliyor. Bu değişiklik, API dokümanlarında yapılan bir düzeltmeyi temsil eder ve API işlevinde bir değişiklik olduğunu göstermez.

  • assets.get ve assets.list yöntemlerinin fetchMatchPolicy parametreleri artık desteklenen bir değer olarak effective'ı listeliyor. Değer, API sunucusuna YouTube'un öğe için uyguladığı eşleşme politikasını almasını söyler.

  • assets.list, claims.list, contentOwners.list, policies.list, publishers.list ve references.list yöntemlerinin id parametrelerinin tümü artık parametre değerlerinin en fazla 50 virgülle ayrılmış kimlik içerebileceğini belirtiyor.

• Yeni ve güncellenmiş hatalar

  Aşağıdaki tabloda, API'nin desteklediği yeni hatalar ve her hatayı döndürebilecek yöntemler belirtilmektedir. Bir yöntemin aynı hata türüne sahip birden fazla hata döndürebileceğini unutmayın.

  Daha fazla bilgi için lütfen her yöntemin hata dokümanlarına veya hatalar sayfasına bakın.

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	tooManyIsrcs	isrcs parametresi 50'den fazla ISRC belirtiyorsa assetSearch.list yöntemi bu hatayı döndürür.
  badRequest (400)	videoIsPrivate	claims.insert yöntemi, özel bir video için hak talebinde bulunmaya çalıştığınızda bu hatayı döndürür. Yalnızca gizlilik durumu public veya unlisted olan videolar için hak talebinde bulunabilirsiniz.
  notModified (304)	blockOutsideOwnershipUnchanged	Hak talebindeki blockOutsideOwnership işareti başarıyla değiştirilmemişse claims.update yöntemi bu hatayı döndürür. Bu hatanın birkaç nedeni olabilir. Belirtilen değişikliğin hak talebinde bulunulan video üzerinde hiçbir etkisi olmaması yaygın bir örnektir.

7 Kasım 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • claimSearch.list yönteminin status parametresi artık routedForReview değerini desteklemektedir. Bu değer, sonuçları bir öğenin eşleşme politikasındaki bir kurala göre manuel inceleme gerektiren hak talepleriyle kısıtlar.

  • claimHistory kaynağının event[].reason mülkü aşağıdaki yeni değerleri destekler. Her neden, hak talebiyle ilgili belirli bir olayın neden gerçekleştiğini açıklar:

    • closed_invalid_reference_segment
    • closed_noadsense
    • suspended_monetization_on_channel
    • video_content_modified

  • claim kaynağının, hak talebinin kaynağını tanımlayan origin.source özelliği artık melodyMatch değerini destekliyor. Melodi eşleşmesi hak talebi, hak talebinde bulunulan videonun bir referansla müzik bestesini paylaştığını gösterir.

  • references.insert yönteminin dokümanları, API'nin bu yöntem için iki farklı uç nokta kullandığını doğru şekilde yansıtacak şekilde güncellendi. Bu, API işlevinde bir değişiklik değil, mevcut dokümanda yapılan bir düzeltmedir.

    • İstek yeni bir referans dosyası yüklüyorsa doğru uç nokta:

      POST https://www.googleapis.com/upload/youtube/partner/v1/references

    • İstek, referans içeriği olarak hak talebinde bulunulan bir videoyu kullanıyorsa doğru uç nokta:

      POST https://www.googleapis.com/youtube/partner/v1/references

• Yeni ve güncellenmiş hatalar

  Aşağıdaki tabloda, API'nin desteklediği yeni hatalar ve her hatayı döndürebilecek yöntemler belirtilmektedir. Bir yöntemin aynı hata türüne sahip birden fazla hata döndürebileceğini unutmayın.

  Daha fazla bilgi için lütfen her yöntemin hata dokümanlarına veya hatalar sayfasına bakın.

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	invalidLabelName	Bir öğe etiketinin adı geçersizse assets.insert, assets.update ve assetLabels.insert yöntemleri bu hatayı döndürür. Etiket adları iki ila 30 karakter arasında olmalıdır. Açılı parantez, virgül, iki nokta, "ve" işareti (&) veya dikey çizgi karakteri (|) içeremez.
  badRequest (400)	ownerHaveMaximumNumberOfLabels	İçerik sahibi şu anda izin verilen maksimum sayı olan 2.500 benzersiz öğe etiketi tanımladıysa assets.insert, assets.update ve assetLabels.insert yöntemleri bu hatayı döndürür.
  badRequest (400)	tooManyLabelsOnOneAsset	Bir öğe hâlihazırda 30 öğe etiketiyle ilişkilendirilmişse (şu anda izin verilen maksimum sayı) assets.insert ve assets.update yöntemleri bu hatayı döndürür.
  badRequest (400)	channelMonetizationSuspended	claims.insert ve claims.update yöntemleri, bir videonun kanalı iş ortağı hak talepleri nedeniyle askıya alınmışsa bu hatayı döndürür.
  badRequest (400)	channelNotActive	Bir videonun kanalı etkin değilse claims.update yöntemi bu hatayı döndürür.

• İstek gövdesinde metadataMine.contentType mülkü bulunmayan bazı öğeler için assets.insert ve assets.update yöntemleri artık badRequest hatası döndürmez.

23 Eylül 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• İçerik sahibi kimliği değişiklikleri

  9 Temmuz 2014'te düzeltme geçmişinde duyurulan içerik sahibi kimliği değişiklikleri yürürlüğe girdi. Bu değişiklik sonucunda API, kimliği doğrulanmış kullanıcıyla veya API aracılığıyla yönetilen bir kaynakla ilişkili içerik sahibini tanımlamak için artık oluşturulmuş, benzersiz bir kimlik döndürüyor. Daha önce API, kimlik olarak "qrs_network" gibi kullanıcı tarafından okunabilir bir ad döndürüyordu.

  Bu değişiklik aşağıdaki API işlevini etkiler ve büyük olasılıkla uygulamalarında sabit kodlu İş Ortağı Kodları olan iş ortaklarını etkileyecektir.

  • API artık daha önce İş Ortağı Kodu'nu döndüren kaynak özelliklerinin (ör. contentOwner kaynağının id özelliği) değeri olarak yeni kimliği döndürüyor.
  • API'nin tüm yöntemleri, API isteğinin gönderildiği içerik sahibini tanımlayan onBehalfOfContentOwner parametresini destekler. Değişiklik sonrasında parametre, İş Ortağı Kodu yerine yeni kimliğe ayarlanmalıdır. Kodda kesinti yaşanmaması için parametre, geçiş döneminde iki değerden birini kabul eder.
  • Değişiklik sonrasında, contentOwners.list yönteminin contentOwnerId parametresi İş Ortağı Kodu yerine yeni kimliği belirtmelidir.

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • assetSearch.list yönteminin yeni metadataSearchFields parametresi, aramak istediğiniz öğe meta veri alanlarının yanı sıra bu alanlarda aramak istediğiniz değerleri belirtmenize olanak tanır. Parametre değeri, alan ve değer çiftlerinin virgülle ayrılmış bir listesidir. Bir çift içinde alan ve değer iki nokta üst üste ile ayrılır.

  • claim kaynağının yeni appliedPolicy nesnesi, YouTube'un hak talebi için uyguladığı politikayı belirtir. Nesnenin değeri bir policy kaynağıdır. Bu kaynak, isteği gönderen içerik sahibinin hak talebinde bulunduğu öğenin sahibi olduğu ülkelerle ilgili politika bilgilerini içerir.

    Uygulanan politika, içerik sahibinin tanımladığı politikadan iki şekilde farklı olabilir:

    1. API isteğini gönderen içerik sahibiyle aynı bölgelerin bazılarında hak talebinde bulunulan öğenin kısmi sahipliğine sahip olan diğer sahipler tarafından belirlenen politikaları dikkate alır.

    2. Bu politika, içerik sahibinin hak talebinde bulunduğu öğenin sahibi olduğu bölgelerde geçerli olan YouTube yönetim politikalarını dikkate alır.

  • claimHistory kaynağının yeni uploaderChannelId mülkü, hak talebinde bulunulan videonun yüklendiği kanalın kanal kimliğini tanımlar.

8 Eylül 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni kaynaklar ve yöntemler

  • Yeni assetLabel kaynağı, bir öğeye atanabilecek bir metin etiketini tanımlar. Öğe etiketleri, öğeleri özel kategorilere yerleştirmenize olanak tanır. Böylece öğe kitaplığınızı daha kolay düzenleyebilirsiniz. Öğeleri etiketlerine göre arayarak belirli öğe gruplarını güncellemenizi gerektiren kullanım durumlarını da kolaylaştırabilirsiniz.

    • assetLabels.list yöntemi, içerik sahibinin etiketlerinin listesini almanızı sağlar.
    • assetLabels.insert yöntemi, yeni bir öğe etiketi oluşturmanıza olanak tanır. assets.update yöntemini çağırarak ve bir öğenin etiketlerini güncelleyerek de yeni etiketler oluşturabilirsiniz. API sunucusu, daha önce tanımlanmamış etiketler için otomatik olarak yeni bir assetLabel kaynağı oluşturur.

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • asset kaynağının label[] mülkü, bir öğenin etiketlerini güncellemek için assets.update yöntemini çağırabileceğiniz şekilde güncellendi. Ancak assets.insert yöntemini çağırırken bir öğenin etiketlerini ayarlayamazsınız.

    Yeni Öğe Etiketlerini Kullanma kılavuzunda, öğe etiketlerinin nasıl oluşturulacağı ve alınacağı, ayrıca öğelerin etiketlerinin nasıl güncelleneceği veya belirli etiketlerle ilişkili öğelerin nasıl aranacağı açıklanmaktadır.

• Yeni ve güncellenmiş hatalar

  API, yeni assetLabels.list ve assetLabels.insert yöntemleri için çeşitli yeni hataları destekler.

9 Temmuz 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• İçerik sahibi kimliği değişiklikleri

  API, geçmişte kimliği doğrulanmış kullanıcıyla veya API aracılığıyla yönetilen bir kaynakla ilişkili içerik sahibini benzersiz bir şekilde tanımlamak için "qrs_network" gibi kullanıcı tarafından okunabilen bir İş Ortağı Kodu kullanıyordu. 2014'ün 3. çeyreğinde API, içerik sahiplerini tanımlamak için 22 karakterlik benzersiz bir kimlik kullanmaya başlayacaktır. Bu değişiklik aşağıdaki API işlevini etkiler ve büyük olasılıkla uygulamalarında sabit kodlanmış İş Ortağı Kodları olan iş ortaklarını etkileyecektir.

  • API, daha önce İş Ortağı Kodu döndüren kaynak mülklerinin (ör. contentOwner kaynağının id mülkü) değeri olarak 22 karakterli kimliği döndürür.
  • API'nin tüm yöntemleri, API isteğinin gönderildiği içerik sahibini tanımlayan onBehalfOfContentOwner parametresini destekler. Değişiklik sonrasında parametre, İş Ortağı Kodu yerine 22 karakterli kimliğe ayarlanmalıdır. Kodda kesinti yaşanmaması için parametre, geçiş döneminde iki değerden birini kabul eder.
  • Değişiklik sonrasında, contentOwners.list yönteminin contentOwnerId parametresi İş Ortağı Kodu yerine 22 karakterli kimliği belirtmelidir.

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • asset kaynakları artık öğeyle ilişkili öğe etiketlerinin listesini belirten label mülkünü desteklemektedir. Gruplamak üzere birden çok öğeye bir etiket uygulayabilirsiniz. Etiketleri toplu güncelleme yapmak, raporları indirmek veya YouTube Analytics'i filtrelemek için arama filtresi olarak kullanabilirsiniz.

  • assetSearch.list yöntemi artık aşağıdaki isteğe bağlı parametreleri desteklemektedir:

    • labels: Sonuçları yalnızca belirtilen etiketlerle ilişkili öğeleri içerecek şekilde kısıtlar. API varsayılan olarak belirtilen tüm etiketlerle eşleşen öğeleri döndürür. Ancak API'ye, belirtilen etiketlerden herhangi biriyle eşleşen öğeleri döndürmesini talimatlandırmak için includeAnyProvidedLabel parametresini kullanabilirsiniz.
    • includeAnyProvidedLabel: labels parametresiyle birlikte kullanılan bu parametre, API'ye labels parametre değerinde belirtilen etiketlerden herhangi biriyle ilişkili öğeleri döndürme talimatı verir.

  • claimHistory kaynakları artık aşağıdaki yeni özellikleri içerir:

    • event[].source.userEmail mülkü, etkinliği başlatan kullanıcının e-posta adresini sağlar.
    • event[].typeDetails.disputeNotes mülkü, dispute_create etkinliğiyle ilgili itiraz notları içeriyor.

  • claimSearch.list yöntemi artık aşağıdaki isteğe bağlı parametreleri desteklemektedir:

    • createdAfter: Sonuçları yalnızca belirtilen tarihten sonra oluşturulan hak taleplerini içerecek şekilde kısıtlar.
    • createdBefore: Sonuçları yalnızca belirtilen tarihten önce oluşturulan talepleri içerecek şekilde kısıtlar.
    • includeThirdPartyClaims: videoId parametresiyle birlikte kullanılan bu parametre, üçüncü taraf hak taleplerinin API sonuçlarına dahil edilip edilmeyeceğini belirtir.

• Daha ayrıntılı hata bilgileri

  Hata dokümanlarında artık her hata türünün HTTP yanıt kodu belirtilmektedir.

• Yeni ve güncellenmiş hatalar

  Aşağıdaki tabloda, API'nin desteklediği yeni hatalar ve her hatayı döndürebilecek yöntemler belirtilmektedir. Bir yöntemin aynı hata türüne sahip birden fazla hata döndürebileceğini unutmayın. Örneğin, zorunlu bir meta veri alanı eksik olan bir asset kaynağı eklemeye çalışırsanız required hatası döndürülür. Aslında, birden fazla zorunlu meta veri alanı olabilir. Bu alanların her biri, biraz farklı bir mesaj içeren bir hata döndürür.

  Daha fazla bilgi için lütfen her yöntemin hata dokümanlarına veya hatalar sayfasına bakın.

  Yöntem	Hatalar
  assetSearch.list	invalidValue: API, program veya sezon öğeleri arama özelliğini desteklemez. type parametresinin değerini desteklenen bir değerle değiştirin.
  assets.insert	conflict: Aynı tanımlayıcıya (ör. özel kimlik, ISRC vb.) sahip çok fazla öğe zaten var. conflict: Belirtilen öğenin çok fazla kopyası zaten mevcut. invalidValue: API'yi çağıran kullanıcının, belirtilen türde öğe oluşturma izni yoktur.
  assets.patch assets.update	badRequest: API, denediğiniz öğe türü dönüşümünü desteklemiyor.
  claimSearch.list	badRequest: includeThirdPartyClaims parametresi yalnızca videoId filtresiyle birlikte kullanılabilir.
  ownership.patch ownership.update	badRequest: Posterli video öğesinin sahipliğini güncelleyemezsiniz.
  references.patch references.update	badRequest: Referans, gerçekleştirmeye çalıştığınız işlem için geçersiz durumdadır.

3 Şubat 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • asset kaynakları artık art_track_video değerine sahip bir type değerine sahip olabilir.

  • claimSearch kaynakları artık aşağıdaki yeni özellikleri içerir:

    • origin nesnesi, iddianın oluşturulma şeklini açıklayan bilgileri içerir.
    • thirdPartyClaim mülkü, hak talebinin aramayı yapan kullanıcıyla ilişkili içerik sahibinden başka bir içerik sahibi tarafından yapılıp yapılmadığını belirten bir Boole değeri içerir.

  • claimSearch.list yöntemi artık aşağıdaki isteğe bağlı parametreleri desteklemektedir:

    • contentType: Sonuçları yalnızca sesle ilgili hak talepleri, yalnızca videoyla ilgili hak talepleri veya işitsel ve görsel hak talepleri içerecek şekilde kısıtlar.
    • origin: Hak talebi bulmak istediğiniz bir veya daha fazla hak talebi kaynağını (ör. descriptiveSearch veya videoMatch) belirtir.
    • status: Sonuçları yalnızca belirtilen duruma sahip hak taleplerini içerecek şekilde kısıtlar.

  • claim kaynağının status özelliği artık şu ek değerleri destekler: appealed, disputed, potential, takedown ve unknown.

  • claim kaynağının yeni blockOutsideOwnership mülkü, hak talebinde bulunulan videonun açıkça sahipliğinin bulunmadığı bölgelerde engellenip engellenmeyeceğini belirtir. Hak talebinde bulunulan videolar, varsayılan olarak hak talebiyle ilişkili öğe için sahiplik verilerinin tanımlanmadığı ülkelerde izlenebilir.

  • contentOwnerAdvertisingOption kaynağının yeni allowedOptions.autoGeneratedBreaks mülkü, iş ortağının YouTube tarafından otomatik olarak belirlenen ara zamanlarında videonun ortasında gösterilen yayın içi reklamları göstermeyi tercih edip edemeyeceğini belirtir.

  • contentOwners.list yöntemi artık https://www.googleapis.com/auth/youtubepartner-content-owner-readonly kapsamını belirten bir yetkilendirme jetonuyla çağrılabilir.

  • policy kaynağının yeni timeUpdated mülkü, politikanın en son güncellendiği zamanı belirtir.

  • policies.list yöntemi artık isteğe bağlı bir sort parametresini destekliyor. Bu parametre, sonuçların son güncellenme zamanlarına göre artan veya azalan düzende sıralanacağını belirtmek için kullanılabilir.

  • referenceConflict kaynağının yeni expiryTime mülkü, referans çakışması için inceleme süresinin sona ereceği zamanı belirtir ve bu da çakışmanın süresinin dolmasına neden olur.

  • videoAdvertisingOption kaynağının yeni autoGeneratedBreaks mülkü, videonun YouTube tarafından otomatik olarak belirlenen ara zamanlarında yayın içi reklamlar gösterip göstermeyeceğini belirtir.

• Yeni ve güncellenmiş hatalar

  Aşağıdaki tabloda, API'nin desteklediği yeni hatalar ve her hatayı döndürebilecek yöntemler belirtilmektedir. Bir yöntemin aynı hata türüne sahip birden fazla hata döndürebileceğini unutmayın. Örneğin, zorunlu bir meta veri alanı eksik olan bir asset kaynağı eklemeye çalışırsanız required hatası döndürülür. Aslında, birden fazla zorunlu meta veri alanı olabilir. Bu alanların her biri, biraz farklı bir mesaj içeren bir hata döndürür.

  Daha fazla bilgi için lütfen her yöntemin hata dokümanlarına veya hatalar sayfasına bakın.

  Yöntem	Hatalar
  assets.insert assets.update	badRequest: API, albüm kapaklı video öğelerinde yazma işlemlerini desteklemez.
  claimSearch.list	invalidValue: İstekteki pageToken parametresi geçersiz bir sayfa jetonu belirtiyor.
  claims.insert	badRequest: Videonun kanalı etkin olmadığı için oluşturmaya çalıştığınız hak talebi geçersiz. badRequest: Hak talebinde bulunmaya çalıştığınız video, yayından kaldırma politikasından muaftır. Sorularınız için lütfen copyright@youtube.com adresiyle iletişime geçin. badRequest: Belirtilen videoda üçüncü taraf hak talebi oluşturamadığınız için isteğiniz işleme alınamıyor. conflict: Video, yayından kaldırma bildirimine karşı geldiği için YouTube istenen hak talebini oluşturamaz. conflict: Videoda etkin bir yayından kaldırma hak talebi olduğu için YouTube, istenen hak talebini oluşturamaz.
  references.insert	badRequest: Kullanmaya çalıştığınız hak talebinde bulunulan video silinmiş veya reddedilmiş ya da işlenmesi başarısız olmuştur.

• Belirli bir API yöntemine özgü olmayan contentOwnerNotProvided ve internalError hataları artık her yöntem sayfasında listelenmiyor. Bu hatalarla ilgili açıklamalara API'nin hata dokümanının Genel hatalar bölümünden ulaşabilirsiniz.

12 Eylül 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni kaynaklar ve yöntemler

  • Yeni referenceConflict kaynağı, iki referans dosya arasındaki bir uyuşmazlığı tanımlar ve uyuşmazlık tanımlandığında bu dosyalar arasında bulunan eşleşmeleri listeler. referenceConflicts.list yöntemi, yetkili içerik sahibiyle ilişkili çözülmemiş referans anlaşmazlıklarının listesini almanızı sağlar. referenceConflicts.get yöntemi, benzersiz referans çakışması kimliğini belirterek bir referans çakışmasını almanıza olanak tanır.

  Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • API artık bir öğe için geçerli eşleşme politikasını alma özelliğini desteklemektedir. Bu değişiklik, 16 Temmuz 2013'te yayınlanan ve bir öğenin kanonik meta veri grubu ve sahiplik verilerinin alınmasına yönelik desteği içeren değişikliklerle paraleldir.

    Bir öğenin geçerli eşleşme politikasını almak için assets.get veya assets.list yöntemlerini çağırırken fetchMatchPolicy parametre değerini effective olarak ayarlayın. API yanıtında, döndürülen her asset kaynağındaki matchPolicyEffective nesnesi, söz konusu öğe için geçerli eşleşme politikasını içerir.

  • asset kaynağının yeni ownershipConflicts nesnesi, öğenin sahiplik anlaşmazlıkları hakkında bilgi içerir. Nesnenin yapısı, bir öğe sahibinin sahip olabileceği her farklı hak türünü tanımlayan ownership kaynağının yapısına benzer. (Çoğu öğe türü için sahipler yalnızca genel öğe sahipliğine sahip olabilir ancak beste öğeleri için sahipler performans hakları, senkronizasyon hakları veya mekanik haklara sahipliklerini ayrıntılı olarak belirtebilir.)

    Benzer şekilde, ownershipConflicts nesnesi genel sahiplik hakları, performans hakları, senkronizasyon hakları ve mekanik haklar için anlaşmazlıkları tanımlayan ayrı listeler içerir. Her anlaşmazlık için verilerde, anlaşmazlığın gerçekleştiği idari bölgeler, çelişen sahiplik verileri sağlayan sahipler ve çelişen her bir sahibin sahip olduğunu iddia ettiği öğe yüzdesi tanımlanır.

  • assets.get ve assets.get yöntemleri artık yeni fetchOwnershipConflicts parametresini destekliyor. Parametre, API isteğinin API yanıtındaki öğeler için sahiplik anlaşmazlıklarını alıp almayacağını belirten bir boole değerine sahiptir. Varsayılan değer false'tür. Bu, sahiplik anlaşmazlıkları döndürülmediği anlamına gelir.

  • assetSearch.list yönteminin q parametresinin tanımı, YouTube'un aradığı meta veri alanlarını tanımlayacak şekilde güncellendi.

  • references.insert yönteminin istek gövdesinin dokümanlarında artık contentType özelliğinin değerini ayarlamanız gerektiği belirtiliyor. Bu değişiklik, dokümanları gerçek API işlevini doğru şekilde yansıtacak şekilde günceller ancak API işlevinde bir değişiklik anlamına gelmez.

• Yeni ve güncellenmiş hatalar

  • API, istenen işlemin bir hizmet hesabı tarafından yetkilendirilemediğini belirten, belirli bir yönteme özgü olmayan yeni bir forbidden hatası destekler.

  • assets.insert yöntemi artık meta veri hatalarını 16 Temmuz 2013'teki API güncellemesinden itibaren desteği sonlandırılan metadata nesnesi yerine metadataMine nesnesinde gerçekleşiyor olarak tanımlar.

  • errors sayfası, update ve patch yöntemlerini destekleyen her kaynak için bu iki yöntem tarafından döndürülen hataları listeleyen bir tablo içerecek şekilde güncellendi. Daha önce, her yöntemin hataları ayrı ayrı listeleniyordu ancak listeler her zaman aynıydı.

16 Temmuz 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni kaynaklar ve yöntemler

  • Yeni claimHistory.get yöntemi, belirli bir hak talebiyle ilgili bilgileri tanımlamanıza ve almanıza olanak tanır. Döndürülen claimHistory kaynağı, hak talebiyle ilgili etkinliklerin (ör. hak talebinin oluşturulması, güncellenmesi, itiraz edilmesi veya kapatılması) listesini içerir.

  • Yeni claimSearch.list yöntemi, aşağıdaki ölçütlerden herhangi birini veya tümünü karşılayan hak taleplerini aramanıza olanak tanır:

    • Hak talepleri belirli bir öğeyle ilişkilidir.
    • Hak talepleri belirli bir videoyla ilişkilendirilir.
    • Hak talepleri, istekte sağlanan bir sorgu diziyle eşleşiyor.

    API yanıtındaki her claimSnippet kaynağı, hak talebinin benzersiz hak talebi kimliği, durumu, türü (audio, video veya audiovisual) ve hak talebiyle ilişkili öğe ve video dahil olmak üzere hak talebiyle ilgili ayrıntıları içerir. Kaynakta, hak talebinde bulunulan videonun görüntüleme sayısı ve videonun başlığı da belirtilir.

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • Dokümanda artık, bir dizi listelenmiş değere sahip mülkler için desteklenen değerler listelenmektedir. Bu tür özellikler arasında asset kaynağının type özelliği ve claim kaynağının status özelliği yer alır.

  • API, assets.get ve assets.list yöntemleri için artık fetchMetadata ve fetchOwnership istek parametrelerinde virgülle ayrılmış değerleri destekliyor. Bu sayede birden fazla meta veri veya sahiplik verisi grubu alabilirsiniz.

    Aşağıdaki listede, asset kaynağının yapısında yapılan değişiklikler ve bu değişikliklerin get, list, insert, update veya patch asset kaynakları için API yöntemleri üzerindeki etkileri açıklanmaktadır.

    • metadata nesnesi kullanımdan kaldırıldı ve metadataMine ve metadataEffective nesneleriyle değiştirildi. Yeni nesneler, asset kaynağının hem API isteği gönderen içerik sahibi tarafından sağlanan meta veri grubunu hem de YouTube'un öğe için en doğru ve eksiksiz meta veri grubu olduğunu belirlediği standart meta veri grubunu içermesine olanak tanır.

    • Benzer şekilde, ownership nesnesi ownershipMine ve ownershipEffective nesneleriyle değiştirildi.

    • matchPolicy nesnesi, matchPolicyMine nesnesi ile değiştirildi. (API şu anda bir öğenin geçerli eşleşme politikasını alma özelliğini desteklememektedir.)

    Not: Geriye dönük uyumluluğu sağlamak için bir öğe için yalnızca bir meta veri sürümü, bir sahiplik verisi grubu veya bir eşleşme politikası istenirse API yanıtı, desteği sonlandırılan nesnenin yanı sıra yeni desteklenen nesneyi de içerir. Örneğin, bir istek fetchMetadata parametresini mine olarak ayarlarsa API yanıtı, her ikisi de aynı verileri içeren bir metadata nesnesi ve bir metadataMine nesnesi içerir. (fetchMetadata=mine parametresinin ayarlanması, birden fazla meta veri sürümü almanızı sağlayan özellik güncellemesinden önce destekleniyordu.)
    
    Ancak fetchMetadata parametresi mine,effective olarak ayarlanırsa API yanıtı metadataMine ve metadataEffective nesnelerini içerir ancak metadata nesnesi içermez. (fetchMetadata=mine,effective ayarlama özelliği bu özellik güncellemesinden önce desteklenmediğinden, geriye dönük uyumluluk için metadata nesnesini döndürmeniz gerekmez.) Aynı ilke fetchOwnership ve fetchMatchPolicy parametreleri için de geçerlidir.
    
    Benzer şekilde, geriye dönük uyumluluk için bir asset kaynağına insert, update veya patch isteği metadataMine nesnesini ya da metadata nesnesini içerebilir. asset kaynağının sahiplik verileri veya eşleşme politikası ayarlamak için de aynı ilke geçerlidir.

  • claims.list yönteminin assetId, q ve videoId parametreleri kullanımdan kaldırıldı. Bu ölçütlerden herhangi birini kullanarak hak talebi aramak için bu parametrelerin tümünü destekleyen claimSearch.list yöntemini kullanın.

  • ownership kaynağındaki general[].ratio, performance[].ratio, synchronization[].ratio ve mechanical[].ratio özelliklerinin değerlerinin tümü artık integer yerine double içerik biçimine sahip.

  • policy kaynağının rules[].action mülkünün tanımında artık bu mülk için geçerli değerler listelenmektedir: block, monetize, takedown ve track. Ancak, API'yi bir hak talebine yayından kaldırma politikası uygulamak için kullanamayacağınızı unutmayın.

  • Referans, bir öğenin İYS hesabınıza bağlı bir YouTube kanalına yüklenen mevcut bir YouTube videosuyla ilişkilendirilmesiyle oluşturulduysa reference kaynağının yeni claimId mülkü mevcuttur. Bu durumda bu alan, öğe ile video arasında kurulan ilişkiyi temsil eden hak talebinin kimliğini içerir.

  • reference kaynağının yeni excludedIntervals[] mülkü, referans sırasında YouTube'un referansı eşleştirmeye çalışırken göz ardı etmesi gereken zaman aralıkları listesini belirtir. Her aralık, videonun başlangıcından itibaren saniye cinsinden ölçülen bir başlangıç ve bitiş zamanı belirtir.

  • API artık references.update veya references.patch isteğinin gövdesinde gönderilen reference kaynağında status özelliğinin ayarlanmasını gerektirmiyor.

  • Dokümanlar, videoAdvertisingOptions.getEnabledAds yöntemi için API yanıt biçimini doğru şekilde tanımlayacak şekilde düzeltildi. youtubePartner#videoAdvertisingOptionGetEnabledAds kaynağı olan yanıt aşağıdaki bilgileri içerir:

    • id: YouTube'un, ayarlarla ilişkili hak talebinde bulunulan videoyu benzersiz şekilde tanımlamak için kullandığı kimliktir.

    • adBreaks: Her nesnenin, reklamların yayınlanmasına izin verildiği video oynatmadan önce, oynatılırken veya oynatıldıktan sonra bir noktayla ilgili bilgi içerdiği nesnelerin listesi. Her nesne, reklam arasının diğer özelliklerini de belirtebilir (ör. ara sırasında gösterilen reklam alanları ve her alan sırasında yayınlanmasına izin verilen reklam türleri).

    • adsOnEmbeds: Video yerleşik bir oynatıcıda oynatıldığında YouTube'un reklam gösterip gösteremeyeceğini belirten bir boole alanı.

    • countriesRestriction: Her nesnenin bir bölge listesini ve bu bölgelerde videonun oynatılması sırasında kullanılan reklam biçimlerini tanımladığı nesnelerin listesi.

• Yeni ve güncellenmiş hatalar

  • Aşağıdaki tabloda, API'nin desteklediği yeni hatalar ve her hatayı döndürebilecek yöntemler belirtilmektedir. Ayrıca, değişen hataları da tanımlar. Bir yöntemin aynı hata türüne sahip birden fazla hata döndürebileceğini unutmayın. Örneğin, zorunlu bir meta veri alanı eksik olan bir asset kaynağı eklemeye çalışırsanız required hatası döndürülür. Aslında, birden fazla zorunlu meta veri alanı olabilir. Bu alanların her biri, biraz farklı bir mesaj içeren bir hata döndürür.

    Daha fazla bilgi için lütfen her yöntemin hata dokümanlarına veya hatalar sayfasına bakın.

    Yöntem	Hatalar
    assets.insert assets.update assets.patch	Daha önce metadata nesnesinin alt mülkleriyle ilişkilendirilmiş invalidValue ve required hataları artık metadataMine nesnesinde aynı alt mülklerle ilişkilendirilmiştir.
    claimHistory.get	notFound: Geçmişini almak istediğiniz hak talebi bulunamadı. required: İstek, claimId parametresi için bir değer belirtmiyor.
    claimSearch.list claims.list	badRequest: İstek geçersiz ölçütler belirtiyor. En fazla aşağıdaki filtre parametrelerinden biri belirtilebilir: q, assetId, videoId.
    claims.insert	badRequest: İstenen içerik sahibi, hak talebiyle ilişkili öğenin sahibi olmadığı için oluşturmaya çalıştığınız hak talebi geçersiz. badRequest: Temsil ettiğiniz içerik sahibinin, belirtilen işlemle politika oluşturma izni yoktur. invalidValue: Temsil ettiğiniz içerik sahibinin, kullanıcı tarafından yüklenen videolar için API üzerinden hak talebinde bulunma izni yoktur.
    contentOwners.list	badRequest: İstek geçersiz ölçütler belirtiyor. Aşağıdaki filtre parametrelerinden tam olarak biri belirtilmelidir: fetchMine, id. (Daha önce hata mesajında has_conflicts_with, restrict_to_user, name_prefix ve id olmak üzere farklı bir filtre parametresi grubu listeleniyordu.)
    ownership.update ownership.patch	badRequest: Bir kompozisyon öğesinin sahiplik verilerini güncelleyen istek, general sahiplik hakları yerine ayrıntılı sahiplik verilerini (mechanical, performance, synchronization ve/veya lyric hakları) belirtmelidir. lyric hak türü yeni desteklenmeye başlandı.
    policies.insert policies.update policies.patch	invalidValue: API, takedown işlemini belirten politikaların oluşturulmasını veya değiştirilmesini desteklemediği için istek geçersiz bir politika kuralı içeriyor. invalidPolicyTakedownAction nedenini bildiren bu hata, desteği sonlandırılan invalidPolicyConditionalTakedown hatasının yerini almıştır.
    references.insert	badRequest: İstek, bir medya dosyası göndermeli veya claimId istek parametresi için bir değer belirtmelidir. Ancak bir istek, medya dosyası gönderemez ve claimId istek parametresi için bir değer belirtemez. badRequest: Aynı YouTube videosundaki farklı bir hak talebinden aynı içerik için daha önce bir referans oluşturuldu. badRequest: API, referans oluştururken fpDirect mülkü için değer ayarlama özelliğini desteklemez. internalError: Yüklenen medya dosyasında sorun var. invalidValue: contentType, assetId veya claimId istek parametresinin değeri geçersiz. Hata, geçersiz değeri tanımlar. notFound: Belirttiğiniz öğe veya hak talebi bulunamadı. Lütfen isteğinizdeki assetId ve claimId parametre değerlerini kontrol edin. required: İstek, contentType parametresi için bir değer belirtmelidir.
    references.insert references.update references.patch	invalidValue: Referans için belirtilen excludedIntervals geçerli değil. Bir referansı devre dışı bırakırken hariç tutma aralıkları belirtemeyeceğinizi unutmayın.

10 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube artık deneysel API özelliklerini ve hizmetlerini tanımlamıyor. Bunun yerine, destek sonlandırma politikasına tabi olan YouTube API'lerinin listesini sunuyoruz.

8 Nisan 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API, YouTube Content ID API olarak yeniden adlandırıldı.

• assetMatchPolicy kaynağında birkaç özellik değişti:

  • kind mülk değeri youtubePartner#policy yerine youtubePartner#assetMatchPolicy olarak değiştirildi.
  • Yeni policyId mülkü, kayıtlı bir politika kaynağını benzersiz şekilde tanımlayan bir değer içerir.
  • rules[].subaction mülk değeri artık dize yerine dizelerden oluşan bir liste.
  • rules[].conditions.contentMatchType mülk değeri artık dize yerine dizelerden oluşan bir liste.
  • id, name ve description mülkleri kaldırıldı.

• assetMatchPolicy.update yönteminin dokümanları, yöntemi çağırırken policyId özelliği veya rules[] nesnesi için değer belirleyebileceğinizi yansıtacak şekilde güncellendi.

• claims kaynağı artık birkaç yeni özelliği destekliyor:

  Mülk adı	Değer	Açıklama
  timeCreated	datetime	Hak talebinin oluşturulduğu tarih ve saat.
  matchInfo	object	matchInfo nesnesi, hak talebini oluşturan eşleşen içerikle ilgili bilgileri içerir. Bu bilgiler yalnızca, yüklenmiş bir video mevcut bir referans dosyasıyla eşleştiği için hak talebi otomatik olarak oluşturulduysa claim kaynağına dahil edilir.
  matchInfo.referenceId	string	Eşleşmeyi oluşturan referansı reference tanımlamak için YouTube tarafından kullanılan benzersiz kimlik.
  matchInfo.longestMatch	object	longestMatch nesnesi, referans ile yüklenen video arasındaki en uzun eşleşme hakkında bilgi içerir.
  matchInfo.longestMatch.durationSecs	unsigned long	Eşleşmenin saniye cinsinden süresi.
  matchInfo.longestMatch.userVideoOffset	unsigned long	Eşleştirmenin başladığı zaman farkı. Yüklenen videonun başlangıcından itibaren saniye cinsinden ölçülür.
  matchInfo.longestMatch.referenceOffset	unsigned long	Eşleşmenin başladığı zaman kayması. Referansın başlangıcından itibaren saniye cinsinden ölçülür.
  matchInfo.totalMatch	object	totalMatch nesnesi, yüklenen videonun referansla eşleşen toplam miktarı ve referansın yüklenen videoyla eşleşen toplam miktarı hakkında bilgi içerir. Eşleşen içerik, yüklenen videoda veya referans videoda döngü halinde oynatılıyorsa bu değerler farklı olabilir. Örneğin, yüklenen bir videoda referanstaki 10 saniyelik bir klip yer alıyorsa ancak klip altı kez tekrarlanıyorsa yüklenen videodaki toplam eşleşen içerik 60 saniye, referanstaki toplam eşleşen içerik ise yalnızca 10 saniyedir.
  matchInfo.totalMatch.userVideoDurationSecs	unsigned long	Yüklenen videonun referansla eşleşen içeriğinin toplam uzunluğu (saniye cinsinden).
  matchInfo.totalMatch.referenceDurationSecs	unsigned long	Yüklenen videoyla eşleşen referans içeriğinin toplam uzunluğu (saniye cinsinden).
  origin	object	origin nesnesi, iddianın kaynağını açıklayan bilgileri içerir.
  origin.source	string	Hak talebinin kaynağı.

• claims kaynağındaki policy mülkü, AudioSwap hak talebi için değerin güncellenemeyeceğini belirtecek şekilde güncellendi.

• metadataHistory kaynağının timeProvidedMs özelliği timeProvided olarak yeniden adlandırıldı.

• ownershipHistory kaynağının timeProvidedMs özelliği timeProvided olarak yeniden adlandırıldı.

• ownershipHistory.list yönteminin tanımı, yöntemin yalnızca her içerik sahibi için en son sahiplik verilerini aldığını belirtecek şekilde güncellendi. Ancak içerik sahibi, sahiplik verilerini birden fazla veri kaynağı (API, içerik feed'leri vb.) aracılığıyla gönderdiyse liste her içerik sahibi ve veri kaynağı için en son verileri içerir.

• policy kaynağında birkaç özellik değişti:

  • rule mülkü kurallar olarak yeniden adlandırıldı.
  • rules[].subaction mülk değeri artık dize yerine dizelerden oluşan bir liste.
  • rules[].conditions.contentMatchType mülk değeri artık dize yerine dizelerden oluşan bir liste.

• policies.insert ve policies.update yöntemlerinin dokümanları, bu yöntemleri çağırırken rules[] nesnesi için değerler belirleyebileceğinizi yansıtacak şekilde güncellendi.

• Bazı API yöntemleri yeni hata türlerini destekler. Aşağıdaki tabloda yöntem ve yeni desteklenen hata türleri kısaca açıklanmaktadır. Birçok durumda, belirli bir tür için birden fazla hata olabilir. Örneğin, zorunlu bir meta veri alanı eksik olan bir asset kaynağı eklemeye çalışırsanız required hatası döndürülür. Aslında, birden fazla zorunlu meta veri alanı olabilir. Bu alanların her biri, biraz farklı bir mesaj içeren bir hata döndürür.

  Daha fazla bilgi için lütfen her yöntemin hata dokümanlarına veya hatalar sayfasına bakın.

  Yöntem	Hatalar
  assets.insert	invalidValue: Öğe meta verileri alanında geçersiz bir değer var. required: Zorunlu bir öğe meta verileri alanı eksik.
  assets.update assets.patch	forbidden: Güncellenen öğenin sahibi, güncellemeyi tamamlamaya çalışan iş ortağı değildir. invalidValue: Öğe meta verileri alanında geçersiz bir değer var. notFound: Öğe, bulunamayan bir sezon öğesiyle veya program öğesiyle ilişkilendiriliyor. required: Zorunlu bir öğe meta verileri alanı eksik.
  claims.insert	badRequest: İstekte video için hak talebinde bulunulmaya çalışılır ancak hak talebine izin verilmez.
  ownership.update ownership.patch	badRequest: İstek, bir bölgede toplam sahipliği yüzde 100'den fazla olarak tanımlar.
  policies.insert policies.patch policies.update	conflictingPolicyRules: Politika, birbiriyle çelişen politika kuralları içeriyor.

• Yeni errors sayfasında, API'nin döndürebileceği hatalar listelenir. Sayfada, birden fazla farklı API yönteminde ortaya çıkabilecek genel hatalar ve yönteme özgü hatalar yer alır.

18 Ocak 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni belgelenen videoAdvertisingOptions.getEnabledAds yöntemi, belirtilen bir iş ortağı veya kullanıcı tarafından yüklenen videoda izin verilen reklam türleriyle ilgili ayrıntıları almanızı sağlar.

• assetSearch.list yönteminin ownershipRestriction parametresinin tanımı, varsayılan parametre değerinin mine olduğunu belirtecek şekilde güncellendi. Bu, API'nin yalnızca geçerli kullanıcıya ait öğeleri alması gerektiğini gösterir.

• assets.list yönteminin dokümanında aşağıdaki değişiklikler yansıtılmıştır:

  • id parametresi artık zorunludur.

  • Yeni desteklenen fetchMatchPolicy parametresi, API isteğinin öğe için ayarladığınız eşleşme politikasını da alıp almayacağını belirtmenize olanak tanır.

  • Yeni desteklenen fetchOwnership parametresi, API isteğinin öğenin sahiplik verilerini de alıp almayacağını belirtmenize olanak tanır.

  • API'nin döndürdüğü öğe listesi artık sayfalandırma verilerini içermiyor. Sonuç olarak, hem nextPageToken mülkü hem de pageInfo nesnesi API yanıtından kaldırıldı. pageInfo nesnesi totalResults, resultsPerPage ve startIndex özelliklerini içeriyordu.

• claims kaynak dokümanları, hak talebi oluştururken bir politika belirtmeniz gerektiğini belirtecek şekilde güncellendi. (YouTube, daha önce bu durumun geçerli olduğunu belirtmesine rağmen, eklenen hak talebinde bir politika belirtilmemişse şu anda varsayılan kullanım politikanızı uygulamamaktadır.)

• policy kaynağının hasUnpublishedDraft özelliğinin desteği sonlandırıldı.

• policies.list yönteminin yeni desteklenen id parametresi, API isteğinin alması gereken kayıtlı politikaları tanımlamanıza olanak tanır. Yalnızca şu anda kimliği doğrulanmış içerik sahibine ait politikalar alınabilir.

• Hem references.patch hem de references.update yöntemi için releaseClaims parametresinin tanımı, parametrenin yalnızca hak talebinin durumu inactive olarak güncellenirken çalıştığını belirtecek şekilde güncellendi. Bu durumda, referans tarafından oluşturulan tüm eşleşme iddialarını serbest bırakmak için releaseClaims parametresinin değerini true olarak da ayarlayabilirsiniz.

• Hem references.patch hem de references.update yöntemleri, bu işlemlerden herhangi birini gerçekleştirirken referansın durumunu belirtmeniz gerektiğini belirtecek şekilde güncellendi.

• Bazı API yöntemleri yeni hata türlerini destekler. Aşağıdaki tabloda yöntem ve yeni desteklenen hatalar belirtilmiştir:

  Yöntem	Hata türü	Hata ayrıntısı	Açıklama
  guideCategories.list	notFound	Unavailable	Eşleşme politikasını almak istediğiniz öğe bulunamıyor.
  claims.get	notFound	Unavailable	Almak istediğiniz hak talebi bulunamadı.
  ownership.patch	invalidValue	Unavailable	Sağladığınız sahiplik verileri geçersiz bir değer içeriyor.
  ownership.update	invalidValue	Unavailable	Sağladığınız sahiplik verileri geçersiz bir değer içeriyor.