Beste Öğelerini Yönetme

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.

Not: Bu kılavuzdaki bilgiler özellikle beste öğeleri için geçerlidir.

YouTube'un hak yönetimi sisteminde öğe, bir fikri mülkiyet parçasını temsil eder. YouTube; filmler, müzik videoları, ses kayıtları ve besteler gibi farklı öğe türlerini tanır.

Bununla birlikte YouTube, beste sahipliğinin ve haklarının karmaşık yapısı nedeniyle beste öğeleri için iki katmanlı bir öğe modeli kullanır. Model, aşağıdakileri dikkate alacak şekilde tasarlanmıştır:

• Her ses kaydı bir besteyle ilişkilendirilir.
• İçerik sahiplerinin genellikle aynı şarkı ya da bestenin yayın haklarının sahipliğini farklı ses kayıtlarına uygulaması gerekir.

Bu belgede YouTube'un beste öğesi modeline genel bir bakış sunulmaktadır. İki beste öğesi türünün YouTube Content ID API yöntemlerinde nasıl kullanıldığı da açıklanmaktadır.

Beste öğesi modelini anlama

YouTube'un öğe modeli, beste öğelerinin iki farklı temsilini tanımlar:

• Beste paylaşımı, belirli bir yayıncının bir beste öğesi hakkında sağladığı bilgileri temsil eder. Bu nedenle, beste paylaşımı yalnızca tek yayıncının beste için sağladığı meta veri, sahiplik ve politika verilerini tanımlar.

  Beste paylaşımı birçok ses kaydıyla ilişkilendirilebilir.

• Beste görünümü, bir ses kaydı içine yerleştirilmiş beste öğesini temsil eder. Her ses kaydı tam olarak bir beste görünümüyle eşlenir ve beste görünümü, YouTube'un bir beste hakkında gösterdiği standart bilgi grubunu temsil eder. Beste görünümünün meta verileri, sahiplik verileri ve politikası, ilişkili tüm beste paylaşımı öğelerinden alınan veriler kullanılarak belirlenir.

  Beste görünümü sıfır veya daha fazla beste paylaşımıyla eşlenebilir. Bununla birlikte, bir bestenin birden fazla sahibi olması durumunda beste görünümü yalnızca birden fazla beste paylaşımıyla eşlenir.

  API'yi kullanan tek bir içerik sahibinin, bir bestenin birden fazla sahibini temsil edebileceğini ve dolayısıyla bu bestenin birden fazla paylaşımına sahip olabileceğini unutmayın. Örneğin, bir dijital hak toplayıcısı aynı bestenin haklarını farklı bölgelerdeki farklı taraflardan alabilir. Toplayıcının bu hakları temsil eden ayrı varlıkları olur ve bu varlıklar YouTube'un modelindeki farklı beste paylaşımlarıyla eşlenir. Farklı beste paylaşımları aynı beste görünümlerine bağlanmaya devam edebilir.

Aşağıdaki şemada bu model gösterilmektedir. Diyagramda:

• Çevreler ses kayıtlarıdır.
• Kareler, beste görünümleridir.
• Üçgenler beste paylaşımlarıdır. Her üçgen rengi, farklı bir içerik sahibini temsil eder. Karelerin içindeki küçük üçgenler, YouTube'un bir beste hakkında görüntülediği standart bilgi kümesini oluşturmak için hangi verilerin birleştirildiğini gösterir. YouTube bu verileri, bir bestenin sahipliğini ve politikasını hesaplamak için kullanır.

İki tür öğe kimliği

YouTube, beste paylaşımlarına ve beste görüntülemelerine kimlik atar. Her ikisi de öğe kimliği olarak kabul edilir. Ancak API'de birbirinin yerine kullanılamazlar. Bunu göz önünde bulundurarak bu belgenin geri kalanında, sırasıyla beste paylaşımlarına ve beste görüntülemelerine atanan kimlikleri ifade etmek için shareId ve viewId terimleri kullanılmıştır.

Genel olarak, bir öğe hakkında sağladığınız bilgileri alırken veya güncellerken bir shareId kullanırsınız. YouTube'un bir öğe hakkında gösterdiği standart bilgi grubunu alıyorsanız viewId değerini kullanırsınız.

Önceki bölümdeki şemaya tekrar bakarsanız ses kayıtlarının ve beste görüntülemelerinin sayılarla (SR₁, CV₁ vb.) işaretlendiğini görürsünüz. Sayılar, ses kayıtları ile beste görüntülemeleri arasındaki 1:1 ilişkiyi yansıtır. Dolayısıyla, belirli bir ses kaydındaki besteyle ilgili standart bilgileri almak istediğinizde bu beste için viewId kullanmanız gerekir.

Diğer yandan, beste paylaşımları harfle (CS_b vb.) işaretlenir. Harfler farklı içerik sahiplerini temsil eder. Yeşil içerik sahibiyseniz ve bir beste öğesi için sağladığınız meta verileri veya sahiplik verilerini almak istiyorsanız bu bilgileri almak için shareId kullanabilirsiniz.

API yöntemlerinde öğe kimliklerini kullanma

Bu belgenin geri kalanında, bağımsız API yöntemlerinin, bu kimlikler parametre veya özellik değeri olarak kullanıldığında shareIds ve viewIds için nasıl işlem yaptığı açıklanmaktadır. API yöntemleri alfabetik olarak listelendiğinden, önce bir beste öğesi oluşturmaya ve bu öğeyi bir ses kaydına bağlamaya ilişkin tipik adımların üzerinden geçmek yararlı olabilir.

1. Beste öğesi oluşturmak için assets.insert yöntemini çağırın. API yanıtı, id özelliğinin shareId olduğu bir asset kaynağıdır.

2. Beste paylaşımı için sahiplik verilerini ayarlamak üzere ownership.update yöntemini çağırın. Yöntemin assetId parametresini, 1. adımda elde edilen shareId olarak ayarlayın.

3. Beste paylaşımı için politika verilerini ayarlamak üzere assetMatchPolicy.update yöntemini çağırın. Politika, besteyi içeren ve hak talebinde bulunulan videolara uygulanır. Yöntemin assetId parametresini, 1. adımda elde edilen shareId olarak ayarlayın.

4. Besteyi içeren ses kayıtlarını tanımlamak için assetRelationships.insert yöntemini çağırın. Eklediğiniz assetRelationship kaynağında parentAssetId özelliğini, ses kaydının öğe kimliğine ayarlayın. childAssetId özelliğini, 1. adımda elde ettiğiniz shareId değerine ayarlayın.

5. viewIds ile shareIds eşlemesini depolarsanız assetRelationships.list yöntemini çağırıp assetId parametresini ses kaydının öğe kimliğine ayarlayarak viewId öğesini alabilirsiniz. Sonuç kümesindeki bir ilişki, ses kaydının öğe kimliğini parentAssetId olarak tanımlar. Bu ilişkide, childAssetId, 1. adımda elde edilen shareId ile eşleşen viewId'i tanımlar.

Öğe oluşturulduktan sonra hakkında bilgi almak, öğeyi güncellemek veya silmek için bu dokümanın geri kalanında açıklanan yöntemlerden herhangi birini kullanabilirsiniz.

asset.get/assets.list

assets.get ve assets.list yöntemleri, bir öğe veya öğe listesi hakkında bilgi getirir. Her iki yöntem de aynı istek parametresi grubunu destekler.

Bu parametrelerden üçü (fetchMatchPolicy, fetchMetadata ve fetchOwnership), öğeyle ilgili standart veri grubunu mu almak yoksa öğe hakkında sağladığınız verileri mi almak istediğinizi belirtmek için effective ve mine değerlerini kullanır. Bu değerler, YouTube'un beste görünümünü ve beste paylaşımlarını tek bir varlık olarak ele alan eski beste öğesi modelinin birer parçasıdır.

Bununla birlikte, değerler iki katmanlı modelde hâlâ desteklenmektedir ve API yanıtının içeriği hem parametre değerine hem de isteklerin shareIds veya viewIds sağladığına bağlıdır. assets.get yönteminin öğe kimliğini belirtmek için assetId parametresini, assets.list yönteminin ise id parametresini kullandığını unutmayın.

Aşağıdaki listede, istek parametresi değerlerinin, bu iki yöntem için API yanıtlarının içeriğini nasıl etkilediği açıklanmaktadır.

• fetchMatchPolicy
  • Öğe kimliği (id veya assetId parametresi) bir shareId belirtiyorsa:
    • fetchMatchPolicy parametresi mine ise API yanıtı, içerik sahibinin beste paylaşımı için ayarlanan API isteğini yetkilendirdiği politikayı içerir.
    • fetchMatchPolicy parametresi effective ise API 400 hatası döndürür.
  • Öğe kimliği bir viewId belirtiyorsa:
    • fetchMatchPolicy parametresi mine ise ve isteği yetkilendiren içerik sahibi, görünüm kimliğine bağlı yalnızca bir beste paylaşımına sahipse API bu beste paylaşımı için ayarlanan eşleşme politikasını döndürür.
    • fetchMatchPolicy parametresi mine ise ve isteği yetkilendiren içerik sahibi, görünüm kimliğine bağlı birden fazla beste paylaşımına sahipse API 400 hatası döndürür.
    • fetchMatchPolicy parametresi effective ise API, beste görünümü için standart eşleşme politikasını döndürür. Bu eşleşme politikası, hangi içerik sahiplerinin paylaşıma sahip olduğuna bakılmaksızın viewId ile bağlantılı tüm beste paylaşımlarının eşleşme politikalarını dikkate alır.
• fetchMetadata
  • Öğe kimliği bir shareId belirtiyorsa:
    • fetchMetadata parametresi mine ise API yanıtı, içerik sahibinin beste paylaşımı için ayarlanan API isteğini yetkilendirdiği öğe meta verilerini içerir.
    • fetchMetadata parametresi effective ise API 400 hatası döndürür.
  • Öğe kimliği bir viewId belirtiyorsa:
    • fetchMetadata parametresi mine ise ve isteği yetkilendiren içerik sahibi, görünüm kimliğine bağlı yalnızca bir beste paylaşımına sahipse API bu beste paylaşımı için ayarlanan meta verileri döndürür.
    • fetchMetadata parametresi mine ise ve isteği yetkilendiren içerik sahibi, görünüm kimliğine bağlı birden fazla beste paylaşımına sahipse API 400 hatası döndürür.
    • fetchMetadata parametresi effective ise API, beste görünümü için standart meta veri grubunu döndürür. Bu meta veriler, paylaşımlara hangi içerik sahiplerinin sahip olduğuna bakılmaksızın viewId ile bağlantılı tüm beste paylaşımları için sağlanan öğe meta verilerini dikkate alır.
• fetchOwnership
  • Öğe kimliği bir shareId belirtiyorsa:
    • fetchOwnership parametresi mine ise API yanıtı, içerik sahibinin beste paylaşımı için ayarlanan API isteğini yetkilendirdiği sahiplik verilerini içerir.
    • fetchOwnership parametresi effective ise API 400 hatası döndürür.
  • Öğe kimliği bir viewId belirtiyorsa:
    • fetchOwnership parametresi mine ise ve isteği yetkilendiren içerik sahibi, görünüm kimliğine bağlı yalnızca bir beste paylaşımına sahipse API bu beste paylaşımı için ayarlanan sahiplik verilerini döndürür.
    • fetchOwnership parametresi mine ise ve isteği yetkilendiren içerik sahibi, görünüm kimliğine bağlı birden fazla beste paylaşımına sahipse API 400 hatası döndürür.
    • fetchOwnership parametresi effective ise API, beste görünümü için standart sahiplik verilerini döndürür. Bu veriler, hangi içerik sahiplerinin paylaşımları olursa olsun viewId ile bağlantılı tüm beste paylaşımlarının sahiplik verilerini hesaba katar.
• fetchOwnershipConflicts
  • Öğe kimliği bir shareId belirtiyorsa API, 400 hata yanıtı döndürür.
  • Öğe kimliği bir viewId belirtiyorsa API, beste görünümüyle ilişkilendirilmiş sahiplik anlaşmazlıklarının listesini döndürür.

assets.insert

Bu yöntem bir asset kaynağı oluşturur ve YouTube, bu kaynağı benzersiz şekilde tanımlamak için bir kimlik atar. API yanıtında id özelliğinin değeri olarak döndürülen bu kimlik bir shareId'dir.

Not: shareIds ve viewIds değerlerinin yalnızca beste öğeleri için kullanıldığını hatırlatmak isteriz. Diğer öğe türleri, öğe verilerini yönetmek için iki katmanlı bir model kullanmaz.

asset.update ve assets.patch

Bu yöntemler, bir öğenin meta verilerini günceller. Her iki istekte de assetId parametresi güncellenen öğeyi tanımlar. Ayrıca, her iki istekte de istek gövdesi, id özellik değerinin assetId parametre değeriyle eşleşmesi gereken bir asset kaynağıdır.

• assetId parametresi ve id özelliği bir shareId belirtirse API isteği, belirtilen beste paylaşımını günceller.
• assetId parametresi ve id özelliği bir viewId belirtirse ve isteği yetkilendiren içerik sahibi, bu viewId ile bağlantılı yalnızca bir beste paylaşımına sahipse API isteği bu beste paylaşımını günceller.
• assetId parametresi ve id mülkü bir viewId belirtiyorsa ve isteği yetkilendiren içerik sahibi, bu viewId ile bağlantılı birden fazla beste paylaşımına sahipse API isteği 400 hatası döndürür.

assetMatchPolicy.get

Bu yöntem, belirtilen öğe için tanımlanan eşleşme politikasını döndürür. İsteğin assetId parametresi öğeyi tanımlar.

• assetId parametresi bir shareId belirtiyorsa API yanıtı, içerik sahibinin beste paylaşımı için ayarlanmış API isteğini yetkilendirdiği öğe meta verilerini içerir.
• assetId parametresi bir viewId belirtiyorsa API, beste görünümü için standart meta veri grubunu döndürür. Bu meta veriler, paylaşımlara hangi içerik sahiplerinin sahip olduğuna bakılmaksızın viewId ile bağlantılı tüm beste paylaşımları için sağlanan öğe meta verilerini dikkate alır.

assetMatchPolicy.update ve assetMatchPolicy.patch

Bu yöntemler, belirtilen öğe için eşleşme politikasını günceller. İsteğin assetId parametresi öğeyi tanımlar.

• assetId parametresi bir shareId belirtiyorsa API isteği, bu beste paylaşımı için eşleşme politikasını günceller.
• assetId parametresi bir viewId belirtiyorsa ve isteği yetkilendiren içerik sahibi, bu viewId ile bağlantılı yalnızca bir beste paylaşımına sahipse API isteği, bu beste paylaşımı için eşleşme politikasını günceller.
• assetId parametresi bir viewId belirtiyorsa ve isteği yetkilendiren içerik sahibi, bu viewId ile bağlantılı birden fazla beste paylaşımına sahipse API isteği 400 hatası döndürür.

assetRelationships.list

Bu yöntem, belirtilen öğe için öğe ilişkileri listesini döndürür. İsteğin assetId parametresi öğeyi tanımlar.

• assetId parametresi bir shareId belirtiyorsa API yanıtı, bağlı ses kaydı öğelerinin listesini içerir. Liste birden fazla öğe içerebilir. Her assetRelationship kaynağında ses kaydının öğe kimliği parentAssetId, shareId ise childAssetId öğesidir.
• assetId parametresi bir viewId belirtiyorsa API yanıtı, bu viewId ile bağlantılı ses kaydını tanımlar. Yanıt maksimum bir kaynak içeriyor.
• assetId parametresi bir ses kaydı öğesini tanımlarsa API yanıtı birden çok ilişki içerebilir.
  • Ses kaydının öğe kimliği, döndürülen assetRelationship kaynağındaki parentAssetId ise childAssetId özelliği bu ses kaydına bağlı beste görünümünü (viewId) tanımlar. Her ses kaydının tam olarak böyle bir ilişkisi vardır.
  • Ses kaydının öğe kimliği childAssetId ise parentAssetId, ses kaydını içeren bir videoyu (ör. müzik videosu veya resimli müzik videosu) tanımlar. Her ses kaydında bu tür birden fazla ilişki olabilir.

assetRelationships.insert

Bu yöntem, iki öğe arasında bir ilişki oluşturur. Bir ses kaydına bağlı bestenin bir payına sahip olduğunuzu belirtmek için bu yöntemi çağırırsınız.

İstek gövdesindeki assetRelationship kaynağında parentAssetId özelliğini ses kaydının öğe kimliğine ayarlayın. childAssetId özelliğini shareId olarak ayarlayın.

assetSearch.list

Bu yöntem, öğe meta verilerine göre öğe arar. API yanıtı, her kaynağın id özelliğinin bir öğe kimliği tanımladığı assetSearch kaynaklarının listesini içerir. id özellik değeri aslında bir öğe kimliğidir.

• assetSearch kaynağı bir beste tanımlıyorsa id özellik değeri shareId olur.

assetShares.list

Bu yöntem, beste görüntülemelerinin beste paylaşımlarıyla eşlemesini döndürür. İsteğin assetId parametresi bir viewId veya shareId belirtebilir.

• assetId parametresi bir viewId belirtiyorsa API yanıtı, assetShare kaynaklarının listesini içerir. Her kaynak, belirtilen beste görünümüne bağlı ve isteği yetkilendiren içerik sahibine ait bir beste paylaşımını tanımlar.

  API yanıtı birden fazla assetShare kaynağı içerebilir. Bir viewId öğesinin, aynı içerik sahibine ait birden fazla shareIds ile eşlendiği yaygın kullanım durumu, bu dokümanın Beste öğesi modelini anlama bölümünde açıklanmıştır.

• assetId parametresi bir shareId belirtiyorsa API yanıtı, assetShare kaynaklarının listesini içerir. Her kaynak, belirtilen beste paylaşımıyla ilişkilendirilmiş bir beste görünümünü tanımlar. Yanıt, beste paylaşımının bağlı olduğu her ses kaydı için bir kaynak içerir. (Her ses kaydı tam olarak bir beste görünümüne bağlıdır.)

claimSearch.list

Bu yöntem, belirtilen arama ölçütleriyle eşleşen hak taleplerinin listesini döndürür. Yöntemin assetId parametresi, belirli bir öğeyle ilişkilendirilmiş hak taleplerini aramanızı sağlar.

• API isteği bir shareId belirtiyorsa API, 400 yanıt kodu döndürür.

• API isteği bir viewId belirtiyorsa API, belirtilen beste görünümüyle ilişkilendirilmiş hak taleplerinin listesini döndürür ve bu liste tam olarak bir ses kaydı öğesiyle eşlenir.

metadataHistory.list

Bu yöntem, verileri hangi içerik sahibinin sağladığından bağımsız olarak bir öğe için sağlanan tüm meta verilerin listesini döndürür. İsteğin assetId parametresi, verilerinin alındığı öğeyi tanımlar.

• API isteği bir shareId belirtiyorsa API, bu beste paylaşımı için en son meta veri grubunu döndürür.

• API isteği bir viewId belirtiyorsa API, her girişin söz konusu beste görünümüne bağlı beste paylaşımı için sağlanan en son meta veri grubunu içeren bir liste döndürür.

ownership.get

Bu yöntem, belirtilen öğe için tanımlanan sahiplik verilerini döndürür. İsteğin assetId parametresi öğeyi tanımlar.

• assetId parametresi bir shareId belirtiyorsa API yanıtı, içerik sahibinin beste paylaşımı için ayarlanmış API isteğini yetkilendirdiği sahiplik verilerini içerir.
• assetId parametresi bir viewId belirtiyorsa API, beste görünümü için standart sahiplik verileri grubunu döndürür. Bu yanıt, hangi içerik sahiplerinin bu paylaşımların sahibi olduğuna bakılmaksızın viewId ile bağlantılı tüm beste paylaşımları için sağlanan sahiplik verilerini sentezler.

sahiplik.güncelleme ve sahiplik.yama

Bu yöntemler, belirtilen öğenin sahiplik verilerini günceller. İsteğin assetId parametresi öğeyi tanımlar.

• assetId parametresi bir shareId belirtiyorsa API isteği, bu beste paylaşımının sahiplik verilerini günceller.
• assetId parametresi bir viewId belirtiyorsa ve isteği yetkilendiren içerik sahibi, bu viewId ile bağlantılı yalnızca bir beste paylaşımına sahipse API isteği, bu beste paylaşımının sahiplik verilerini günceller.
• assetId parametresi bir viewId belirtiyorsa ve isteği yetkilendiren içerik sahibi, bu viewId ile bağlantılı birden fazla beste paylaşımına sahipse API isteği 400 hatası döndürür.

ownershipHistory.list

Bu yöntem, verileri hangi içerik sahibinin sağladığından bağımsız olarak bir öğe için sağlanan tüm sahiplik verilerinin listesini döndürür. İsteğin assetId parametresi, verilerinin alındığı öğeyi tanımlar.

• API isteği bir shareId belirtiyorsa API, bu beste paylaşımı için en son sahiplik verileri grubunu döndürür.

• API isteği bir viewId belirtiyorsa API, her girişin söz konusu beste görünümüne bağlı beste paylaşımı için sağlanan en son sahiplik veri grubunu içeren bir liste döndürür.