REST Resource: assets

Kaynak: Öğe

assetKaynak, ses kaydı veya televizyon programı bölümü gibi bir fikri mülkiyet parçasını temsil eder.

Bir öğe zaten başka bir içerik sahibine aitse meta verilerini (assets.update veya assets.patch kullanarak) ya da eşleşme politikasını (assetMatchPolicy.update veya assetMatchPolicy.patch kullanarak) güncelleyebilmeniz için önce sahipliğinizi öğeye eklemeniz (ownership.update veya ownership.patch yöntemini kullanarak) gerekir.

JSON gösterimi 
{
  "kind": string,
  "type": string,
  "status": string,
  "metadata": {
    object (Metadata)
  },
  "ownership": {
    object (RightsOwnership)
  },
  "matchPolicy": {
    object (AssetMatchPolicy)
  },
  "timeCreated": string,
  "metadataMine": {
    object (Metadata)
  },
  "metadataEffective": {
    object (Metadata)
  },
  "ownershipMine": {
    object (RightsOwnership)
  },
  "ownershipEffective": {
    object (RightsOwnership)
  },
  "matchPolicyMine": {
    object (AssetMatchPolicy)
  },
  "matchPolicyEffective": {
    object (AssetMatchPolicy)
  },
  "ownershipConflicts": {
    object (OwnershipConflicts)
  },
  "id": string,
  "aliasId": [
    string
  ],
  "label": [
    string
  ],
  "licensability": {
    object (AssetLicensability)
  },
  "nWayRevenueSharing": {
    object (NWayRevenueSharing)
  }
}
Alanlar
kind

string

API kaynağının türü. asset kaynakları için değer youtubePartner#asset'dir.
type

string

Öğenin türü. Bu değer, öğe için ayarlayabileceğiniz meta veri alanlarını belirler. Ayrıca, belirli API işlevleri yalnızca belirli öğe türlerinde desteklenebilir. Örneğin, beste öğeleri diğer öğe türlerine göre daha karmaşık sahiplik verilerine sahip olabilir.

Bu özellik için geçerli değerler şunlardır:

  • art_track_video
  • composition
  • episode
  • general
  • movie
  • music_video
  • season
  • show
  • sound_recording
  • video_game
  • web

Sanatçı Albümü Kapaklı Video öğeleri (art_track_video) API kullanılarak oluşturulamaz veya değiştirilemez. Albüm kapaklı video meta verilerini ve medyalarını DDEX veya CSV feed'leri aracılığıyla gönderin.
status

string

Öğenin durumu.

Kabul edilen değerler şunlardır:

  • active
  • inactive
  • pending
metadata

object (Metadata)

metadata nesnesi, öğeyi tanımlayan ve açıklayan bilgileri içerir. Bu bilgiler, öğeyi aramak veya YouTube'un veritabanındaki tekrarları ortadan kaldırmak için kullanılabilir.
ownership

object (RightsOwnership)

ownership nesnesi, bir öğenin sahiplerini tanımlar ve sahiplikleriyle ilgili ek ayrıntılar (ör. öğeye sahip oldukları bölgeler) sağlar.
matchPolicy

object (AssetMatchPolicy)

matchPolicy nesnesi, YouTube'un öğeyle eşleşen kullanıcı tarafından yüklenen videolara uyguladığı öğenin eşleşme politikasıyla ilgili bilgileri içerir.
timeCreated

string

Öğenin oluşturulduğu tarih ve saat. Değer, RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z) biçiminde belirtilir.
metadataMine

object (Metadata)
metadataEffective

object (Metadata)
ownershipMine

object (RightsOwnership)
ownershipEffective

object (RightsOwnership)
matchPolicyMine

object (AssetMatchPolicy)
matchPolicyEffective

object (AssetMatchPolicy)
ownershipConflicts

object (OwnershipConflicts)

ownershipConflicts nesnesi, öğenin sahiplik anlaşmazlıklarıyla ilgili bilgileri içerir.
id

string

YouTube'un öğeyi benzersiz şekilde tanımlamak için atadığı ve kullandığı kimlik.
aliasId[]

string

Öğeyi ifade etmek için kullanılabilecek öğe kimliklerinin listesi. Öğe, birleştirilmiş birden fazla bileşen öğeyi temsil ediyorsa listede değerler bulunur. Bu durumda, ana ��ğeyi veya sentezlenmiş öğeyi güncellemek için bileşen öğelere başlangıçta atanan öğe kimliklerinden herhangi biri kullanılabilir.
label[]

string

Öğedeki öğe etiketlerinin listesi.
licensability

object (AssetLicensability)

Öğe lisanslanabilirliği bilgileri.
nWayRevenueSharing

object (NWayRevenueSharing)

N yönlü gelir paylaşımı (Pangea) bilgileri.

OwnershipConflicts

ownershipConflicts kaynağı, öğenin çakışan sahipliğiyle ilgili bilgileri temsil eder.

JSON gösterimi 
{
  "general": [
    {
      object (TerritoryConflicts)
    }
  ],
  "performance": [
    {
      object (TerritoryConflicts)
    }
  ],
  "synchronization": [
    {
      object (TerritoryConflicts)
    }
  ],
  "mechanical": [
    {
      object (TerritoryConflicts)
    }
  ],
  "kind": string
}
Alanlar
general[]

object (TerritoryConflicts)

Bir öğenin sahiplik anlaşmazlıklarını ve anlaşmazlık içeren sahipliğin eklendiği bölgeleri tanımlayan liste.
performance[]

object (TerritoryConflicts)

Bir beste öğesinin gösterim/sahneleme haklarıyla ilgili sahiplik çakışmalarını ve çakışma içeren sahipliğin eklendiği bölgeleri belirten liste.
synchronization[]

object (TerritoryConflicts)

Bir beste öğesinin senkronizasyon haklarıyla ilgili sahiplik anlaşmazlıklarını ve anlaşmazlık içeren sahipliğin eklendiği bölgeleri tanımlayan liste.
mechanical[]

object (TerritoryConflicts)

Bir beste öğesinin mekanik haklarıyla ilgili sahiplik anlaşmazlıklarını ve anlaşmazlık içeren sahipliğin eklendiği bölgeleri belirten liste.
kind

string

API kaynağının türü. ownershipConflicts kaynakları için değer youtubePartner#ownershipConflicts'dir.

TerritoryConflicts

Sahiplik anlaşmazlığı olan bölgeleri arama yöntemi.

JSON gösterimi 
{
  "territory": string,
  "conflictingOwnership": [
    {
      object (ConflictingOwnership)
    }
  ]
}
Alanlar
territory

string

Sahiplik çakışmasının olduğu bölgeler. İdari bölge, ISO 3166 iki harfli ülke kodudur.
conflictingOwnership[]

object (ConflictingOwnership)

Çakışan sahipliklerin listesi.

ConflictingOwnership

Çakışan sahipliklerden biriyle ilgili bilgileri gösterir.

JSON gösterimi 
{
  "ratio": number,
  "owner": string
}
Alanlar
ratio

number

Sahibin kontrol ettiği veya yönettiği varlığın yüzdesi.
owner

string

Çakışan öğenin sahibinin kimliği.

AssetLicensability

Öğe lisanslanabilirliği bilgileri.

JSON gösterimi 
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
Alanlar
licensable

boolean

Üzerinde anlaşılan öğenin lisanslanabilir olup olmadığı.
licensabilityState

string

Öğenin lisanslanabilirliği durumu.

Kabul edilen değerler şunlardır:

  • action_required
  • active
  • eligible
  • not_active
  • not_eligible
  • objection
  • partially_active
unlicensableReason[]

string

Öğenin neden lisanslanamadığı.

Kabul edilen değerler şunlardır:

  • asset_opted_out
  • composition_non_conformant_policy
  • conflicting_composition_ownership
  • conflicting_sound_recording_ownership
  • contract_not_started_yet
  • future_release_date
  • insufficient_composition_ownership
  • insufficient_sound_recording_ownership
  • no_active_reference
  • non_conformant_policy
  • other
  • reference_inconsistent
  • reference_not_exclusive_enough
  • undermerged

NWayRevenueSharing

Bilgi öğesinin n yönlü gelir paylaşımı.

JSON gösterimi 
{
  "status": string,
  "eligibleTerritories": [
    string
  ],
  "ineligibleTerritories": [
    {
      object (TerritoriesIneligibleForNWayRevenueSharing)
    }
  ]
}
Alanlar
status

string

n taraflı gelir paylaşımının durumu.

Kabul edilen değerler şunlardır:

  • ineligible_in_all_owned_territories
  • restricted_in_all_owned_territories
  • restricted_in_some_owned_territories
  • unrestricted_in_all_owned_territories
  • unrestricted_in_some_owned_territories
eligibleTerritories[]

string

Her ülke, iki harfli ISO ülke koduyla (ISO 3166-1 alfa-2) gösterilir.
ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

Bir öğenin n taraflı gelir paylaşımına uygun olmadığı bölgelerle ilgili bilgiler.

TerritoriesIneligibleForNWayRevenueSharing

Bir öğenin n taraflı gelir paylaşımına uygun olmadığı bölgelerle ilgili bilgiler.

JSON gösterimi 
{
  "reason": string,
  "territories": [
    string
  ]
}
Alanlar
reason

string

Bu kaynakta listelenen bölgeler için uygun olmama nedeni.

Kabul edilen değerler şunlardır:

  • composition insufficient ownership
  • composition insufficient policy
  • contract not started yet
  • opted out
  • other
  • sound recording insufficient policy
  • sound recording ownership conflict
territories[]

string

Her ülke, iki harfli ISO ülke koduyla (ISO 3166-1 alfa-2) gösterilir.

Yöntemler

get

 Belirtilen öğenin meta verilerini alır.

insert

 Belirtilen meta verileri içeren bir öğe ekler.

list

 Öğe meta verilerine göre öğe listesini alır.

patch

 Belirtilen öğenin meta verilerini yamalar.

update

 Belirtilen öğenin meta verilerini günceller.