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

Not: YouTube Content ID API, YouTube içerik iş ortaklarının kullanımı için tasarlanmıştır ve tüm geliştiriciler ya da tüm YouTube kullanıcıları tarafından kullanılamaz. YouTube Content ID API'yi Google API Konsolu'nda listelenen hizmetlerden biri olarak görmüyorsanız YouTube İş Ortağı Programı hakkında daha fazla bilgi edinmek için YouTube Yardım Merkezi'ni ziyaret edin.

Bu sayfada, YouTube Content ID API değişiklikleri ve belge güncellemeleri listelenmektedir.

10 Kasım 2023

videoAdvertisingOption kaynağının adFormats[] alanı, bu alan için geçerli tek değer third_party_ads olacak şekilde güncellendi. Şu reklam biçimleri artık desteklenmiyor: instream_trueview, instream_standard, display, preroll, postroll. Daha fazla bilgi için destek makalesini inceleyin.

1 Haziran 2023

Not: Bu bir kullanımdan kaldırma duyurusudur.

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

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

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

• Yeni kaynaklar ve yöntemler

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

20 Aralık 2022

assetSearch.list yönteminin ownershipRestriction sorgu parametresinin tanımı, bu parametrenin değeri none olduğunda metadataSearchFields parametre değerinin de en az bir kimlik filtresi kullanması gerektiğini netleştirmek için güncellendi. Bu doküman değişikliği, API davranışında herhangi 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 netleştirmek amacıyla güncellendi:

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

28 Eylül 2022

Lisanslanabilirlik bilgileri asset resource bölümüne eklendi.

18 Temmuz 2022

claimSearch.list yönteminin inactiveReasons belgeleri, YouTube Studio ile tutarlılık sağlayacak iyileştirmeleri yansıtacak şekilde güncellendi:

• Studio daha önce Audio Swap ve Song Erase desteğini kaldırmıştı. İlgili API değerleri (audio_removed ve song_erased) sessizce yoksayıldı ve belgelenmemiş durumda.
• channel_whitelisted, channel_allowlisted ile değiştirildi. Önceki değer artık belgelenmese de desteklenmeye devam eder.
• 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 kaynak dokümanları, iki yeni özelliği yansıtacak şekilde güncellendi: isrcs[] ve iswcs[]. Yeni isrcs[] ve iswcs[] özellik değerlerinin her biri, uygun şekilde arama sonucuyla tanımlanan öğeyle eşlenen bir ISRC veya ISWC belirten her değerle bir dize değerleri dizisi içerir.

Yeni özellikler daha doğru veriler sağladığından assetSearch kaynaklarında halihazırda bulunan isrc ve iswc özellikleri yerine yeni özelliklerin kullanılması önerilir. Yeni özellikler potansiyel olarak bir dize değerleri dizisi listelerken, isrc ve iswc özelliklerinin her biri, arama sonucuyla ilişkilendirilmiş 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 işaret edecek şekilde güncellendi. PHP için önceden oluşturulan 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 konusundaki iyileştirmeleri yansıtacak şekilde güncellendi:

• pageInfo.totalResults 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ğıyla ilgili dokümanlar, labelPrefix ve q istek parametrelerinin anlamını netleştirmek ve istek / yanıtı desteklemek için sayfalandırmanın yapıldığını belgelemek için güncellendi.

8 Aralık 2021

claimSearch.list kaynağıyla ilgili 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 arayın
• Hak talebi oluşturma tarihine, değiştirilme tarihine veya duruma göre arama yapın

Her kullanım alanı farklı bir sorgu parametresi grubunu destekler. claimSearch.list yönteminin belgeleri, her kullanım alanı için hangi parametrelerin desteklendiğini açıklayacak şekilde 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 olası hak taleplerinin durumunu active olarak güncelleme özelliğini desteklemektedir. claim kaynağının status özelliğinin tanımı daha ayrıntılı bilgi sağlar.
• claim ve claimSearch kaynaklarıyla ilgili 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ğerlerin listesi değişti. Parametre artık dört ek değeri destekliyor: batchTool, inProductShorts, melodyMatch ve youTubeAdmin. Ayrıca, dropboxUpload ve webUpload değerleri artık desteklenmemektedir.

26 Şubat 2021

claimSearch.list yönteminin videoId parametresiyle ilgili dokümanlar, parametre değerinin artık virgülle ayrılmış 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 bir kullanımdan kaldırma duyurusudur.

API dokümanları, contentOwnerAdvertisingOptions kaynağına ve yöntemlerine ilişkin referansları kaldıracak şekilde güncellendi. Bu yöntemler çok az kullanılıyordu ve bunları kullanan API kullanıcılarıyla bu duyurudan önce ayrıca iletişime geçilmişti.

21 Mart 2018

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

• Artık bir müzik videosu veya ses kaydı öğesini eklediğinizde, güncellediğinizde veya yama yaptığınızda metadataMine.artist özelliğini ayarlamanız gerekir. Bu kaynak türleri için özellik ayarlanmamışsa API artık hata döndürüyor. Ayrıca, metadataMine.artist özelliğinin yalnızca müzik videoları 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 iletim mekanizması aracılığıyla gönderilen 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, önceden yüklenen bir paketle ilgili bilgileri getirir.

• validator.validate yöntemi için uploaderName özelliğinin 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ımlamasını sağlayacak şekilde güncellenmiştir.

• reference kaynağının status özelliği, bir referansın başka bir referansın kopyası olduğunu belirtmek için artık duplicate_on_hold değerini kullanmaz. Bunun yerine, bir referans yineleniyorsa 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 özelliği yalnızca referans bir kopyaysa doldurulur. Ayarlanırsa ö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 ilgili olan yeni assetShare kaynağı, bir öğe kaynağının iki temsili arasındaki ilişkiyi tanımlar. Bu gösterimler, haklarınızın ses kaydı öğeleriyle ilişkilendirilme şekli konusunda daha fazla şeffaflık ve kontrol sağlamak için tasarlanmış yeni bir yayınlama verisi modelini yansıtmaktadır.

  Yeni modelde her ses kaydı tam olarak tek bir benzersiz öğeyle eşlenir. Buna beste görünümü denir. Bu öğenin meta verileri, YouTube'un belirli bir kayıtla ilişkili beste hakları hakkında görüntülediği standart bilgi grubunu temsil eder ve birden fazla veri sağlayıcısından gelen bilgileri sentezleyebilir.

  Ayrıca bestenin her sahibi kendi beste paylaşımı öğesine sahiptir. 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 beste görünümü ile beste 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 belirtin ve böyle bir paylaşım varsa isteği yetkilendiren iş ortağına ait olan ilgili beste paylaşımını alın.
  • İçerik iş ortağına ait 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 veya beste paylaşımlarını tanımlamasına bağlı olarak farklı API yöntemlerinin istekleri nasıl ele aldığı açıklanmaktadır.

• contentOwnerAdvertisingOptions kaynağının yeni claimedVideoOptions.autoGeneratedBreaks özelliği, YouTube'un hak talebinde bulunulan 10 dakikadan uzun videolarda reklam aralarını otomatik olarak oluşturup oluşturmayacağını ifade eder. Mülk, içerik sahibinin 10 dakikadan uzun tüm videolarını etkiler. Bununla birlikte, bir videoyla ilgili birden fazla hak talebi varsa bir videoyla ilgili hak talebinde bulunan ilk iş ortağı, bu mülk için söz konusu videoyla ilişkili varsayılan davranışı 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 tartışılan yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), geçerli Hizmet Şartları'nda kapsamlı güncellemeler içermektedir. Bu güncelleme, 10 Şubat 2017'de yürürlüğe girecek olan Güncellenen Şartlar'ın yanı sıra geliştiricilerin uyması gereken politikaların açıklanmasına yardımcı olan çeşitli destekleyici dokümanlar içerir.

  Yeni doküman grubunun tamamı, Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmıştır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde yapılacak değişikliklerin de ilgili düzeltme geçmişinde açıklaması yer alacaktır. Düzeltme geçmişindeki RSS özet akışı girişlerinde yapılan değişikliklere, dokümandaki bir bağlantıdan 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, meta veri dosyasının YouTube'un başarılı bir şekilde işlemesini engelleyecek doğrulama hataları içerip içermediğini belirlemenize olanak tanır. Dosya hatalar içeriyorsa API yanıtının errors özelliği, her hatanın önem derecesini, nedenini ve konumunu tanımlayan bir doğrulama hatalarının listesi içerir.

• 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ı destekleyebildiğini hatırlatmak isteriz. Lütfen her yöntemin hata belgelerine veya olası hataların tam listesi için 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. Söz konusu öğenin kimliğini (hata mesajında döndürülen) assetId parametresinin değeri olarak kullanarak isteği yeniden gönderin.

28 Mart 2016

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

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • claim kaynağının yeni matchInfo.matchSegments[] özelliğinde her öğenin, hak talebinde bulunulan videonun referans videonun bir kısmıyla eşleşen bir segmentini açıkladığı bir liste bulunur. Bir hak talebinde birden fazla eşleşme segmenti olabilir. Örneğin, yüklenen bir videonun ses ve video içeriği bir referans videonun ses ve video içeriği ile eşleşiyorsa iki eşleşme segmenti olur. Bir segment ses eşleşmesini, diğeri 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 bir eşleşme segmentinin hem hak talebinde bulunulan videoda hem de referans videoda başladığı ve bittiği zaman ofsetlerini de tanımlar.

  • contentOwnerAdvertisingOptions kaynağının claimedVideoOptions.newVideoDefaults[] özellik 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ği kullanımdan kaldı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ı destekleyebildiğini hatırlatmak isteriz. Lütfen her yöntemin hata belgelerine veya olası hataların tam listesi için hatalar sayfasına bakın.

    Hatalar
    badRequest (400)	alreadyClaimed Bu hak talebi, mevcut başka bir hak talebinin tekrarı olduğundan güncellenemez.

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

  • references.insert hata dokümanı, isteğin bozuk bir referans dosyası yüklemesi durumunda referansın kendisi işlenene kadar sorunun tespit edilemeyeceğini belirtecek şekilde güncellendi. Dolayısıyla, references.insert isteği başarılı bir yanıt döndürse bile referans başarıyla işlenmeyebilir. 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 kaynak ve yöntemlerde yapılan güncellemeler

  • API artık ürün listeleme reklamlarını desteklemektedir. Ürün listeleme reklamları, bir video içeriğiyle ilgili veya 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şikliğin bir sonucu olarak, product_listing artık aşağıdaki özelliklerin değerlerine dahil edilebilir:

    Kaynak/API yöntemi	Özellik
    contentOwnerAdvertisingOptions	allowedOptions.licAdFormats[]
    contentOwnerAdvertisingOptions	allowedOptions.ugcAdFormats[]
    contentOwnerAdvertisingOptions	claimedVideoOptions.newVideoDefaults[]
    videoAdvertisingOptions	adFormats[]
    videoAdvertisingOptions.getEnabledAds	countriesRestriction[].adFormats[]

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

  • Bir assetSearch.list isteğine verilen API yanıtında, type özelliği artık art_track_video değerini destekliyor. YouTube Yardım Merkezi'nde, resimli müzik videoları hakkında daha fazla bilgi edinebilirsiniz.

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

    Parametreler
    referenceId	Bu filtre parametresi, hak taleplerini aldığınız referansın YouTube referans kimliğini belirtir.
    inactiveReasons	Bu isteğe bağlı parametre, hak taleplerinin etkin olmamasının belirtilen nedenlere bağlı olarak yalnızca etkin olmayan hak taleplerini içerecek şekilde API yanıtını kısıtlamanıza olanak tanı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 belirtmenizi sağlar.

  • 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ı yükleme özelliğini desteklemektedir. Önceden oluşturulmuş bir dijital parmak izi sağlarsanız yüklenen reference kaynağında fpDirect özellik değerini true olarak ayarlayın.

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

• Yeni ve güncellenmiş hatalar

  Dokümanlarda 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 açıklanmıştır. Bir yöntemin, aynı hata türüne sahip birden çok hata döndürebileceğini unutmayın. Daha fazla bilgi için lütfen her iki yöntemin hata belgelerine veya hatalar sayfasına bakın.

  Hatalar
  badRequest (400)	inappropriateCampaignTarget Kampanya bazı kullanıcılar için uygun olmayabilecek bir videoyu öne çıkarmaya çalışırsa campaigns.insert ve campaigns.update yöntemleri bu hatayı döndürür. Hatayı gidermek için lütfen öne çıkarılacak farklı bir içerik seçin.
  badRequest (400)	canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets İş ortağı tarafından yüklenen bir beste veya ses kaydı öğesiyle hak talebi oluşturmaya çalışırsanız claims.insert yöntemi bu hatayı döndürür.
  badRequest (400)	existingSoundRecordingOrMusicVideoClaim Belirtilen videoda kaydedilmiş müzik için zaten bir hak talebi varsa claims.insert yöntemi bu hatayı döndürür. Doğrudan beste hak talepleri, API aracılığıyla eklenemez.
  badRequest (400)	asset_id İstek, bir dosya aracılığıyla referans oluşturmaya çalıştıysa ancak istekte bir assetId belirtmediyse references.insert yöntemi bu hatayı döndürür.
  badRequest (400)	canNotBeActivated references.update yöntemi, referansın durumu veya sahiplik koşulları nedeniyle etkinleştirilemiyorsa bu hatayı döndürür.
  badRequest (400)	videoNotClaimed Reklam seçeneklerini almaya çalıştığınız video için hak talebinde bulunmadıysanız ve bu nedenle istenen bilgileri kullanamıyorsanız videoAdvertisingOptions.get yöntemi bu hatayı döndürür.

18 Aralık 2015

Avrupa Birliği (AB) yasaları, AB'deki son kullanıcılara belirli açıklamalar yapılmasını 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 gerekmektedir. YouTube API Hizmet Şartlarımıza 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 videolarda 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 sahibi, bir filmden sahneler içeren ve hak talebinde bulunulmuş, kullanıcı tarafından yüklenmiş videolar için filmin izleme sayfasına bağlantı 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 kaynak ve yöntemlerde yapılan güncellemeler

  • assetSearch.list yönteminin yeni isrcs parametresi, en fazla 50 ISRC içeren bir liste belirtmenize olanak tanır. API yanıtı, bu ISRC'lerle ilişkilendirilmiş öğeleri içerecektir.

  • claimHistory kaynağının event[].reason özelliği aşağıdaki yeni değerleri destekler. Her bir neden, hak talebiyle ilgili belirli bir etkinliğin gerçekleşme nedenini 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. Varsayılan olarak kaynaklar, oluşturuldukları tarihlere göre ters kronolojik düzende (en yeniden en eskiye) sıralanır. Ayrıca kaynakları, hak talebinde bulunulan içerikle ilgili görüntüleme sayıları en yüksekten en düşük olana doğru sıralayabilirsiniz.

    claimSearch.list isteği ayrıca status parametre değerini appealed, disputed, pending, potential veya routedForReview olarak ayarlarsa sonuçların hak talebi inceleme süresinin sona erme tarihine göre sıralanacağını unutmayın.

  • ownership.update ve ownership.patch yöntemleri, bu yöntemler çağrılırken güncellenebilecek tüm özellikleri artık doğru bir şekilde listelemektedir. Bu değişiklik, API belgelerinde yapılan bir düzeltmeyi temsil etmekte olup API işlevinde bir değişikliğe işaret etmez.

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

  • 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çerebildiğini belirtmektedir.

• Yeni ve güncellenmiş hatalar

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

  Daha fazla bilgi için lütfen her iki yöntemin hata belgelerine 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	Gizli bir videoyla ilgili hak talebinde bulunmaya çalışırsanız claims.insert yöntemi bu hatayı döndürür. Yalnızca gizlilik durumu public veya unlisted olan bir videoyla ilgili hak talebinde bulunabilirsiniz.
  notModified (304)	blockOutsideOwnershipUnchanged	Hak talebindeki blockOutsideOwnership işareti başarıyla değiştirilmediyse claims.update yöntemi bu hatayı döndürür. Bu hatanın oluşmasının birkaç nedeni olabilir. Yaygın bir örnek, belirtilen değişikliğin hak talebinde bulunulan video üzerinde hiçbir etkisinin olmamasıdır.

7 Kasım 2014

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

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

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

  • claimHistory kaynağının event[].reason özelliği aşağıdaki yeni değerleri destekler. Her bir neden, hak talebiyle ilgili belirli bir etkinliğin gerçekleşme nedenini açıklar:

    • closed_invalid_reference_segment
    • closed_noadsense
    • suspended_monetization_on_channel
    • video_content_modified

  • claim kaynağının bir talebin 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 bestesi paylaştığını gösterir.

  • references.insert yönteminin belgeleri, 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şikliği değil, mevcut dokümanlarda yapılan bir düzeltmeyi temsil etmektedir.

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

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

    • İstek, referans içeriği olarak hak talebinde bulunulan bir videoyu kullanarak referans oluşturuyorsa doğru uç nokta şu şekildedir:

      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 bir hatayı döndürebilecek yöntemler açıklanmaktadır. Bir yöntemin, aynı hata türüne sahip birden çok hata döndürebileceğini unutmayın.

  Daha fazla bilgi için lütfen her iki yöntemin hata belgelerine 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 ile 30 karakter arasında olmalıdır. Açılı parantez, virgül, iki nokta, "ve" işareti (&), dikey çizgi karakteri (|) içeremez.
  badRequest (400)	ownerHaveMaximumNumberOfLabels	Bir içerik sahibi halihazırda 2.500 benzersiz öğe etiketi tanımlamışsa assets.insert, assets.update ve assetLabels.insert yöntemleri bu hatayı döndürür. Bu sayı, şu anda izin verilen maksimum sayıdır.
  badRequest (400)	tooManyLabelsOnOneAsset	Bir öğe 30 öğe etiketiyle zaten ilişkilendirilmişse assets.insert ve assets.update yöntemleri bu hatayı döndürür. Bu sayı, şu anda izin verilen maksimum sayıdır.
  badRequest (400)	channelMonetizationSuspended	Bir videonun kanalı, iş ortağı hak talepleri nedeniyle askıya alınırsa claims.insert ve claims.update yöntemleri bu hatayı döndürür.
  badRequest (400)	channelNotActive	claims.update yöntemi, bir videonun kanalı etkin değilse bu hatayı döndürür.

• İstek gövdesindeki kaynak metadataMine.contentType özelliğini içermiyorsa assets.insert ve assets.update yöntemleri artık bazı öğeler için 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 tarihinde düzeltme geçmişinde bildirilen içerik sahibi kimliği değişiklikleri geçerlilik kazanmıştır. Bu değişikliğin bir sonucu olarak API artık, 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 oluşturulmuş, benzersiz bir kimlik döndürmektedir. Önceden API, kimlik olarak "qrs_network" gibi kullanıcıların okuyabileceği bir ad döndürüyordu.

  Bu değişiklik aşağıdaki API işlevlerini etkilemektedir ve büyük olasılıkla, uygulamalarında İş Ortağı Kodlarını sabit olarak kodlayan iş ortaklarını da etkileyecektir.

  • API artık yeni kimliği, daha önce İş Ortağı Kodunu döndüren contentOwner kaynağının id özelliği gibi kaynak özelliklerinin değeri olarak döndürüyor.
  • API'nin tüm yöntemleri, API isteğinin kimin adına yapıldığı içerik sahibini tanımlayan onBehalfOfContentOwner parametresini destekler. Değişikliğin ardından parametre, İş Ortağı Kodu yerine yeni kimliğe ayarlanmalıdır. Kod arızalarını önlemek için parametre, geçiş döneminde her iki değeri de kabul eder.
  • Değişikliğin ardından, contentOwners.list yönteminin contentOwnerId parametresi, İş Ortağı Kodu yerine yeni kimliği belirtmelidir.

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • assetSearch.list yönteminin yeni metadataSearchFields parametresi, aramak istediğiniz öğe meta verisi alanlarını ve bu alanlarda aramak istediğiniz değerleri belirtmenizi sağlar. Parametre değeri, alan ve değer çiftlerinin virgülle ayrılmış listesidir. Bir çift içinde, alan ve değer iki nokta 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ğı. Bu kaynak, isteği gönderen içerik sahibinin hak talebinde bulunulan öğenin sahibi olduğu ülkelerin politika bilgilerini içerir.

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

    1. API isteğini gönderen içerik sahibiyle aynı bölgelerin bazılarında hak talebinde bulunulan öğenin kısmi sahibi olan diğer sahipler tarafından belirlenen politikaları da hesaba katar.

    2. Bu hesap, içerik sahibinin hak talebinde bulunulan öğeye sahip olduğu bölgelerde geçerli olan YouTube yönetim politikalarını dikkate alır.

  • claimHistory kaynağının yeni uploaderChannelId özelliği, 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 metin etiketini tanımlar. Öğe etiketleri, öğeleri özel kategorilere yerleştirmenize olanak tanıyarak öğe kitaplığınızı düzenlemenizi kolaylaştırır. Öğ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ıza olanak tanır.
    • assetLabels.insert yöntemi, yeni bir öğe etiketi oluşturmanıza olanak tanır. assets.update yöntemini çağırıp bir öğenin etiketlerini güncelleyerek de yeni etiketler oluşturabilirsiniz. API sunucusu, önceden tanımlanmamış tüm etiketler için otomatik olarak yeni bir assetLabel kaynağı oluşturur.

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

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

    Yeni Öğe Etiketlerini Kullanma kılavuzunda, öğe etiketlerinin nasıl oluşturulacağı ve alınacağının yanı sıra bir öğe etiketlerinin nasıl güncelleneceği veya belirli etiketlerle ilişkili öğeleri 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

  Geçmişte bu API, kimliği doğrulanmış kullanıcıyla veya API aracılığıyla yönetilen bir kaynakla ilişkili içerik sahibini benzersiz şekilde tanımlamak için okunabilir bir İş Ortağı Kodu (ör. "qrs_network") kullanıyordu. 2014'ün 3. çeyreğinde API, içerik sahiplerini tanımlamak için 22 karakterlik benzersiz bir kimlik kullanmaya başlayacaktır. Değişiklik aşağıdaki API işlevlerini etkilemektedir ve büyük olasılıkla, uygulamalarında İş Ortağı Kodlarını sabit olarak kodlayan iş ortaklarını da etkileyecektir.

  • API, contentOwner kaynağının id özelliği gibi daha önce İş Ortağı Kodu döndüren kaynak özelliklerinin değeri olarak 22 karakterlik kimliği döndürür.
  • API'nin tüm yöntemleri, API isteğinin kimin adına yapıldığı içerik sahibini tanımlayan onBehalfOfContentOwner parametresini destekler. Değişikliğin ardından parametre, İş Ortağı Kodu yerine 22 karakterlik kimliğe ayarlanmalıdır. Kod arızalarını önlemek için parametre, geçiş döneminde her iki değeri de kabul eder.
  • Değişikliğin ardından, contentOwners.list yönteminin contentOwnerId parametresi, İş Ortağı Kodu yerine 22 karakterli kimliği belirtmelidir.

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • asset kaynakları artık öğeyle ilişkilendirilmiş öğe etiketlerinin listesini belirten label özelliğini destekliyor. Gruplamak üzere birden çok öğeye bir etiket uygulayabilirsiniz. Toplu güncellemeler yapmak, raporları indirmek veya YouTube Analytics'i filtrelemek için etiketleri arama filtreleri 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şkilendirilmiş öğeleri içerecek şekilde kısıtlar. Varsayılan olarak API, belirtilen etiketlerin tümüyle eşleşen öğeleri döndürür. Bununla birlikte, API'ye belirtilen etiketlerden herhangi biriyle eşleşen öğeleri döndürmesi için includeAnyProvidedLabel parametresini kullanabilirsiniz.
    • includeAnyProvidedLabel: labels parametresiyle birlikte kullanılan bu parametre, labels parametre değerinde belirtilen etiketlerden herhangi biriyle ilişkilendirilmiş API döndürme öğelerine talimat verir.

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

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

  • 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 hak taleplerini içerecek şekilde kısıtlar.
    • includeThirdPartyClaims: videoId parametresiyle birlikte kullanılan bu parametre, API sonuçlarına üçüncü taraf hak taleplerinin dahil edilip edilmeyeceğini gösterir.

• Daha ayrıntılı hata bilgileri

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

• Yeni ve güncellenmiş hatalar

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

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

  Yöntem	Hatalar
  assetSearch.list	invalidValue – Bu API, program veya sezon öğelerini 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 sayıda öğe zaten mevcut. conflict: Belirtilen öğenin çok fazla kopyası zaten mevcut. invalidValue – API'yi çağıran kullanıcının belirtilen türde öğeler oluşturma izni yok.
  assets.patch assets.update	badRequest: API, denediğiniz öğe türü dönüştürmesini desteklemiyor.
  claimSearch.list	badRequest – includeThirdPartyClaims parametresi yalnızca videoId filtresiyle birlikte kullanılabilir.
  ownership.patch ownership.update	badRequest: Resimli müzik videosu öğesinin sahipliğini güncelleyemezsiniz.
  references.patch references.update	badRequest – Referans, denediğiniz işlem için geçersiz bir durumda.

3 Şubat 2014

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

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • Bir asset kaynağı artık type art_track_video değerine sahip olabilir.

  • Bir claimSearch kaynağı artık aşağıdaki yeni özellikleri içeriyor:

    • origin nesnesi, hak talebinin oluşturulma biçimini açıklayan bilgiler içerir.
    • thirdPartyClaim özelliği, hak talebinin, aramayı yapan kullanıcıyla ilişkilendirilmiş olan dışında bir içerik sahibi tarafından yapılıp yapılmadığını gösteren 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 ses hak taleplerini, yalnızca video hak taleplerini veya görsel-işitsel hak taleplerini içerecek şekilde kısıtlar.
    • origin: Hak taleplerini bulmak istediğiniz descriptiveSearch veya videoMatch gibi bir veya daha fazla hak talebi kaynağını 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 desteklemektedir: appealed, disputed, potential, takedown ve unknown.

  • claim kaynağının yeni blockOutsideOwnership özelliği, hak talebinde bulunulan videonun açıkça sahibi olmadığı bölgelerde engellenip engellenmeyeceğini belirtir. Varsayılan olarak, hak talebinde bulunulan video, hak talebiyle ilişkili öğe için sahiplik verilerinin tanımlanmadığı ülkelerde görüntülenebilir.

  • contentOwnerAdvertisingOption kaynağının yeni allowedOptions.autoGeneratedBreaks özelliği, iş ortağının YouTube tarafından otomatik olarak belirlenen ara zamanlarında videonun ortasında gösterilen ve yayın içi reklamları göstermeyi seçip seçemeyeceğini ifade eder.

  • 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 özelliği, politikanın en son ne zaman güncellendiğini belirtir.

  • policies.list yöntemi artık isteğe bağlı bir sort parametresini desteklemektedir. Bu parametre, sonuçların son güncellendiği zamana göre artan veya azalan düzende sıralanması gerektiğini belirtmek için kullanılabilir.

  • referenceConflict kaynağının yeni expiryTime özelliği, referans çakışmasının inceleme süresinin sona ereceği ve çakışmanın sona ereceği zamanı belirtir.

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

• Yeni ve güncellenmiş hatalar

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

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

  Yöntem	Hatalar
  assets.insert assets.update	badRequest: API, resimli müzik videosu öğelerinde yazma işlemlerini desteklemez.
  claimSearch.list	invalidValue – İstekteki pageToken parametresi geçersiz bir sayfa jetonu belirtiyor.
  claims.insert	badRequest – Oluşturmaya çalıştığınız hak talebi, videonun kanalı etkin olmadığı için geçersiz. badRequest – Hak talebinde bulunmak istediğiniz video, yayından kaldırma politikasından muaf. Sorgu için lütfen [email protected] adresine e-posta gönderin badRequest – Belirtilen video üzerinde üçüncü taraf hak talebi oluşturamayacağınız için isteğiniz işleme alınamıyor. conflict – Video, yayından kaldırma bildirimiyle karşılaştığı için istenen hak talebini oluşturamıyor. conflict – Videoyla ilgili etkin bir yayından kaldırma hak talebi olduğundan YouTube, istenen hak talebini oluşturamıyor.
  references.insert	badRequest – Kullanmaya çalıştığınız, hak talebinde bulunulan video silindi veya reddedildi ya da video işlenemedi.

• Belirli bir API yöntemine özgü olmayan contentOwnerNotProvided ve internalError hataları artık her yöntem sayfasında listelenmiyor. Bu hizmetlerin açıklamaları hâlâ API'nin hata dokümanlarının Genel hatalar bölümünde bulunabilir.

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 dosyası arasındaki çakışmayı tanımlar ve çakışma tespit edildiğinde bu dosyalar arasında var olan eşleşmeleri listeler. referenceConflicts.list yöntemi, yetkili içerik sahibiyle ilişkili çözülmemiş referans çakışmalarının listesini almanıza olanak tanır. referenceConflicts.get yöntemi, benzersiz referans çakışması kimliğini belirterek referans çakışmasını almanıza olanak tanır.

  Mevcut kaynak ve yöntemlerde yapılan 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 standart meta veri grubunu ve sahiplik verilerini alma desteği de içeren değişikliklerle paraleldir.

    Bir öğenin etkili 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 öğenin etkili eşleşme politikasını içerir.

  • asset kaynağının yeni ownershipConflicts nesnesi, öğenin sahiplik anlaşmazlıklarıyla ilgili bilgiler 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ünde, sahipler sadece genel öğe sahipliğine sahip olabilirler, ancak beste öğeleri için sahipler, performans hakları, senkronizasyon hakları veya mekanik haklar sahipliklerini maddeler halinde belirleyebilir.)

    Benzer şekilde ownershipConflicts nesnesi genel sahiplik hakları, performans hakları, senkronizasyon hakları ve mekanik haklarla ilgili çakışmaları tanımlayan ayrı listeler içerir. Her anlaşmazlık için veriler; anlaşmazlığın gerçekleştiği bölgeleri, ihtilaflı sahiplik verilerini sağlayan sahipleri ve anlaşmazlığın bulunduğu her bir sahibin sahip olduğunu iddia ettiği öğenin yüzdesini tanımlar.

  • assets.get ve assets.get yöntemleri artık yeni fetchOwnershipConflicts parametresini destekliyor. Parametre, API isteğinin API yanıtındaki öğelerle ilgili sahiplik çakışmalarını alıp almayacağını gösteren bir boole değerine sahiptir. Varsayılan değer false, yani sahiplik anlaşmazlıkları döndürülmez.

  • assetSearch.list yönteminin q parametresinin tanımı, YouTube'un aradığı meta veri alanlarını tanımlamak için güncellendi.

  • references.insert yöntemiyle ilgili istek gövdesinde, artık contentType özelliğinin değerini ayarlamanız gerektiği belirtiliyor. Bu değişiklik, belgeleri gerçek API işlevlerini doğru yansıtacak şekilde günceller ancak API işlevinde herhangi bir değişikliğe işaret etmez.

• Yeni ve güncellenmiş hatalar

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

  • assets.insert yöntemi, artık meta veri hatalarının metadata nesnesinde değil, metadataMine nesnesindeki özelliklerde meydana geldiğini tanımlar. metadataMine nesnesi, 16 Temmuz 2013'teki API güncellemesiyle kullanımdan kaldırılmıştır.

  • Hatalar sayfası, update ve patch yöntemlerini destekleyen her kaynak için, sayfada bu iki yöntem tarafından döndürülen hataların listelendiği bir tablo içerecek şekilde güncellenmiştir. Daha önce, listeler her zaman aynı olsa da sayfada her yöntem için hatalar ayrı ayrı listeleniyordu.

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ğında hak talebiyle ilgili etkinliklerin (ör. hak talebinin oluşturulması, güncellenmesi, itiraz edilmesi veya kapatılması) yer alır.

  • Yeni claimSearch.list yöntemi, aşağıdaki ölçütlerin 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şkilendirilmiş.
    • Hak talepleri, istekte sağlanan bir sorgu dizesiyle 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şkilendirilmiş öğe ve video dahil olmak üzere hak talebiyle ilgili ayrıntıları içerir. Kaynak, hak talebinde bulunulan videonun görüntüleme sayısını ve hak talebinde bulunulan videonun başlığını da belirtir.

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • Dokümanlarda artık bir dizi numaralandırılmış 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 bulunur.

  • API artık assets.get ve assets.list yöntemlerinde fetchMetadata ve fetchOwnership istek parametreleri için virgülle ayrılmış değerleri desteklemektedir. Böylece, birden fazla meta veri grubu veya sahiplik verisi alabilirsiniz.

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

    • metadata nesnesi kullanımdan kaldırıldı ve yerini metadataMine ve metadataEffective nesneleri aldı. Yeni nesneler, asset kaynağının hem API isteğinde bulunan 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 nesnesiyle değiştirildi. (API şu anda bir öğe için etkili eşleşme politikasını alma özelliğini desteklememektedir.)

    Not: Geriye dönük uyumluluğu sağlamak amacıyla, 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ı, kullanımdan kaldırılan nesnenin yanı sıra yeni desteklenen nesneyi de içerir. Örneğin, bir istek fetchMetadata parametresini mine olarak ayarlarsa API yanıtı, aynı verileri içeren bir metadata ve bir metadataMine nesnesi içerir. (Özellik güncellemesinden önce fetchMetadata=mine özelliğini ayarlama özelliği destekleniyordu. Böylece birden fazla meta veri sürümü alabilirsiniz.)
    
    Ancak fetchMetadata parametresi mine,effective olarak ayarlanırsa API yanıtı metadataMine ve metadataEffective nesnelerini içerir ancak metadata nesnesini içermez. (fetchMetadata=mine,effective özelliğini ayarlama özelliği bu özellik güncellemesinden önce desteklenmediğinden geriye dönük uyumluluk için metadata nesnesinin döndürülmesine gerek yoktur.) Aynı ilke fetchOwnership ve fetchMatchPolicy parametreleri için de geçerlidir.
    
    Benzer şekilde, geriye dönük uyumluluk amacıyla insert, update veya patch için yapılan isteklerde asset kaynağı, metadataMine veya metadata nesnesini içerebilir. Aynı ilke, asset kaynağının sahiplik verileri veya eşleşme politikası belirlenirken de geçerlidir.

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

  • Bir ownership kaynağında, general[].ratio, performance[].ratio, synchronization[].ratio ve mechanical[].ratio mülklerinin değerleri artık integer yerine double içerik biçimine sahiptir.

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

  • Referans, bir öğenin CMS hesabınıza bağlı bir YouTube kanalına yüklenmiş mevcut bir YouTube videosuyla ilişkilendirilmesiyle oluşturulmuşsa reference kaynağının yeni claimId özelliği mevcuttur. Bu durumda bu alanda, öğe ile video arasında ortaya çıkan ilişkilendirmeyi temsil eden hak talebinin kimliği yer alır.

  • reference kaynağının yeni excludedIntervals[] özelliği, referans sırasında YouTube'un referansı eşleştirmeye çalışırken yoksayması gereken zaman aralıklarının 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 status özelliğinin, references.update veya references.patch isteğinin gövdesinde gönderilen reference kaynağında ayarlanmasını gerektirmiyor.

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

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

    • adBreaks – Her nesnenin, reklamların yayınlanmasına izin verilen video oynatma sırasında veya sonrasında bir noktayla ilgili bilgi içerdiği nesnelerin listesi. Her nesne, reklam arası sırasında gerçekleşen reklam alanları ve her bir alanda yayınlanmasına izin verilen reklam türleri gibi reklam arasının diğer özelliklerini de belirtebilir.

    • adsOnEmbeds – Video yerleştirilmiş oynatıcıda oynatıldığında YouTube'un reklam gösterip gösteremeyeceğini belirten boole alanıdır.

    • countriesRestriction – Her nesnenin bir bölge listesini ve bu bölgelerde video oynatılırken 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 bir hatayı döndürebilecek yöntemler açıklanmaktadır. Ayrıca değişen hataları da tanımlar. Bir yöntemin, aynı hata türüne sahip birden çok hata döndürebileceğini unutmayın. Örneğin, gerekli meta veri alanı eksik olan bir asset kaynağı eklemeye çalışırsanız required hatası döndürülür. Hatta birden fazla gerekli meta veri alanı da olabilir. Bu alanların her biri, biraz farklı bir mesajla hata döndürür.

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

    Yöntem	Hatalar
    assets.insert assets.update assets.patch	Daha önce metadata nesnesinin alt özellikleriyle ilişkilendirilen invalidValue ve required hataları artık metadataMine nesnesinde aynı alt özelliklerle ilişkilendirilir.
    claimHistory.get	notFound – Geçmişini almaya çalıştığınız hak talebi bulunamıyor. required – İstek, claimId parametresi için bir değer belirtmiyor.
    claimSearch.list claims.list	badRequest – İstek geçersiz ölçütler belirtiyor. En fazla, şu filtre parametrelerinden biri belirtilebilir: q, assetId, videoId.
    claims.insert	badRequest: Oluşturmaya çalıştığınız hak talebi, istenen içerik sahibi hak talebiyle ilişkili öğenin sahibi olmadığı için geçersiz. badRequest – Adına hareket ettiğiniz içerik sahibinin belirtilen işlemle politika oluşturma izni yok. invalidValue – Adına hareket ettiğiniz içerik sahibinin API üzerinden kullanıcılar tarafından yüklenen videolarla ilgili hak talebinde bulunma izni yok.
    contentOwners.list	badRequest – İstek geçersiz ölçütler belirtiyor. Şu filtre parametrelerinden tam olarak biri belirtilmelidir: fetchMine, id. (Daha önce, hatada farklı bir filtre parametresi grubu listeleniyordu: has_conflicts_with, restrict_to_user, name_prefix ve id.)
    ownership.update ownership.patch	badRequest – Bir beste öğesinin sahiplik verilerini güncelleyen bir istekte general sahiplik hakları yerine ayrıntılı sahiplik verileri &mechanical, performance, synchronization ve/veya lyric hakları belirtmelidir. lyric hak türü yeni desteklendi.
    policies.insert policies.update policies.patch	invalidValue – İstek, geçersiz bir politika kuralı içeriyor. Bunun nedeni API'nin, takedown işlemini belirten politikaların oluşturulmasını veya değiştirilmesini desteklemediğini. invalidPolicyTakedownAction nedenini bildiren bu hata, kullanımdan kaldı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çeriğe yönelik bir referans zaten oluşturulmuş. badRequest – API, referans oluştururken fpDirect özelliği için değer belirleme özelliğini desteklemez. internalError: Yüklenen medya dosyasıyla ilgili bir 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 bulunamıyor. 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ımlamamaktadır. Bunun yerine, artık kullanımdan kaldırma politikasına tabi olan YouTube API'lerinin bir 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ştirildi:

  • youtubePartner#policy olan kind özelliğinin değeri youtubePartner#assetMatchPolicy olarak değiştirildi.
  • Yeni policyId özelliği, kayıtlı politika kaynağını benzersiz şekilde tanımlayan bir değer içerir.
  • rules[].subaction özellik değeri artık bir dize yerine dize listesidir.
  • rules[].conditions.contentMatchType özellik değeri artık bir dize yerine dize listesidir.
  • id, name ve description özellikleri kaldırıldı.

• assetMatchPolicy.update yöntemiyle ilgili dokümanlar, yöntemi çağırırken policyId özelliği veya rules[] nesnesi için değer ayarlayabileceğiniz gerçeğini yansıtacak şekilde güncellendi.

• claims kaynağı artık birkaç yeni mülkü desteklemektedir:

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

• claims kaynağındaki policy özelliği, bir Audio Değişme hak talebi için değerin güncellenemeyeceğine dikkat edilecek ş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 her içerik sahibi için yalnızca en son sahiplik verilerini alacağını belirtecek şekilde güncellendi. Ancak içerik sahibi, sahiplik verilerini birden çok veri kaynağı (API, içerik feed'leri vb.) üzerinden gönderdiyse liste, her içerik sahibi ve veri kaynağı için en yeni verileri içerir.

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

  • rule özelliği, kurallar olarak yeniden adlandırıldı.
  • rules[].subaction özellik değeri artık bir dize yerine dize listesidir.
  • rules[].conditions.contentMatchType özellik değeri artık bir dize yerine dize listesidir.

• policies.insert ve policies.update yöntemleriyle ilgili dokümanlar, bu yöntemleri çağırırken rules[] nesnesinin değerlerini ayarlayabileceğiniz gerçeğini yansıtacak şekilde güncellendi.

• Çeşitli API yöntemleri yeni hata türlerini desteklemektedir. Aşağıdaki tabloda yöntem ve yeni desteklenen hata türleri kısaca tanımlanmıştır. Birçok durumda, belirli bir tür için birden fazla hata olabilir. Örneğin, gerekli meta veri alanı eksik olan bir asset kaynağı eklemeye çalışırsanız required hatası döndürülür. Hatta birden fazla gerekli meta veri alanı da olabilir. Bu alanların her biri, biraz farklı bir mesajla hata döndürür.

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

  Yöntem	Hatalar
  assets.insert	invalidValue – Bir öğe meta verisi alanında geçersiz bir değer var. required: Zorunlu bir öğe meta verisi alanı eksik.
  assets.update assets.patch	forbidden: Güncellenmekte olan öğe, güncellemeyi tamamlamaya çalışan iş ortağına ait değildir. invalidValue – Bir öğe meta verisi alanında geçersiz bir değer var. notFound – Öğe, bulunamayan bir sezon öğesiyle veya program öğesiyle ilişkilendirilmiş. required: Zorunlu bir öğe meta verisi alanı eksik.
  claims.insert	badRequest: İstek, videoyla ilgili hak talebinde bulunmaya çalışılır ancak hak talebine izin verilmez.
  ownership.update ownership.patch	badRequest – İstek, bir idari bölgede toplam sahipliği %100'den fazla olarak tanımlıyor.
  policies.insert policies.patch policies.update	conflictingPolicyRules – Politika, çakışan politika kuralları içeriyor.

• Yeni hatalar sayfasında, API'nin döndürebileceği hatalar listelenir. Sayfada, birden fazla farklı API yöntemi için oluşabilecek genel hataların yanı sıra yönteme özgü hatalar yer almaktadır.

18 Ocak 2013

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

• Yeni belgelenen videoAdvertisingOptions.getEnabledAds yöntemi, belirli bir iş ortağı veya kullanıcı tarafından yüklenen video için izin verilen reklam türleri hakkında ayrıntıları almanızı sağlar.

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

• assets.list yönteminin belgelerinde aşağıdaki değişiklikler yapı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ı belirtmenizi sağlar.

  • Yeni desteklenen fetchOwnership parametresi, API isteğinin öğe için sahiplik verilerini de alıp almayacağını belirtmenizi sağlar.

  • API'nin döndürdüğü öğe listesi artık sayfalara ayırma verilerini içermez. Bunun sonucunda hem nextPageToken özelliği 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 politika belirlemeniz gerektiğini belirtecek şekilde güncellendi. (Dokümanlarda bu durum önceden belirtilse de, eklenen hak talebi bir politika belirtmiyorsa YouTube şu anda varsayılan kullanım politikanızı uygulamaz.)

• policy kaynağının hasUnpublishedDraft özelliği kullanımdan kaldırıldı.

• policies.list yönteminin yeni desteklenen id parametresi, API isteğinin alması gereken kayıtlı politikaları tanımlamanızı sağlar. Yalnızca geçerli olarak 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üncellendiğinde çalıştığını belirtmek üzere güncellendi. Bu durumda, referans tarafından oluşturulan tüm eşleşen hak taleplerini iptal etmek için releaseClaims parametresinin değerini true olarak da ayarlayabilirsiniz.

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

• Çeşitli API yöntemleri yeni hata türlerini desteklemektedir. Aşağıdaki tabloda yöntem ve yeni desteklenen hatalar tanımlanmıştır:

  Yöntem	Hata türü	Hata ayrıntısı	Açıklama
  guideCategories.list	notFound	Unavailable	Eşleşme politikasını almaya çalıştığınız öğe bulunamıyor.
  claims.get	notFound	Unavailable	Almaya çalıştığınız hak talebi bulunamıyor.
  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.