REST Resource: assets

Kaynak: Öğe

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

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 şeklindedir.

type

string

Öğenin türü. Bu değer, öğe için ayarlayabileceğiniz meta veri alanlarını belirler. Ayrıca, bazı API işlevleri yalnızca belirli öğe türleri için desteklenebilir. Örneğin, beste öğeleri diğer öğe türlerine kıyasla 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

status

string

Öğenin durumudur.

metadata

object (Metadata)

metadata nesnesi, öğeyi tanımlayan ve açıklayan bilgileri içerir. Bu bilgiler, öğeyi aramak veya YouTube'un veritabanında tekrarlamayı önlemek için kullanılabilir.

ownership

object (RightsOwnership)

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

matchPolicy

object (AssetMatchPolicy)

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

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 bilgiler içerir.

id

string

YouTube'un öğeyi benzersiz şekilde tanımlamak için atadığı ve kullandığı kimliktir.

aliasId[]

string

Öğeye referans vermek için kullanılabilecek öğe kimliklerinin listesi. Öğe, birleştirilmiş birden çok bileşen öğeyi temsil ediyorsa liste değerler içerir. Bu durumda, bileşen öğelere başlangıçta atanan öğe kimliklerinden herhangi biri ana öğeyi veya sentezlenmiş öğeyi güncellemek için kullanılabilir.

label[]

string

Öğedeki öğe etiketlerinin listesidir.

licensability

object (AssetLicensability)

Öğe lisanslanabilirliği bilgileri.

nWayRevenueSharing

object (NWayRevenueSharing)

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

OwnershipConflicts

ownershipConflicts kaynağı, öğenin sahiplik anlaşmazlığıyla 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 ihtilaflı sahipliğin eklendiği bölgeleri tanımlayan bir liste.

performance[]

object (TerritoryConflicts)

Bir beste öğesinin performans haklarındaki sahiplik anlaşmazlıklarını ve sahipliğin anlaşmazlığının eklendiği bölgeleri gösteren bir liste.

synchronization[]

object (TerritoryConflicts)

Bir beste öğesinin senkronizasyon haklarındaki sahiplik çakışmalarını ve sahipliğin anlaşmazlığa eklendiği bölgeleri tanımlayan bir liste.

mechanical[]

object (TerritoryConflicts)

Bir beste öğesinin mekanik haklarıyla ilgili sahiplik anlaşmazlıklarını ve bu tür sahipliğin eklendiği bölgeleri tanımlayan bir liste.

kind

string

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

TerritoryConflicts

Sahiplik anlaşmazlıkları bulunan terörleri arama yöntemi.

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

string

Sahiplik anlaşmazlığının bulunduğu bölgeler. Bölge, ISO 3166'ya uygun iki harfli ülke kodudur.

conflictingOwnership[]

object (ConflictingOwnership)

İhtilaflı sahipliklerin listesi.

ConflictingOwnership

İhtilaflı sahipliklerden biriyle ilgili bilgileri temsil eder.

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

number

Öğenin sahibinin kontrol ettiği veya yönettiği öğe yüzdesi.

owner

string

İhtilaflı öğe sahibinin kimliği.

AssetLicensability

Öğe lisanslanabilirliği bilgileri.

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

boolean

Mutabık kalınan öğenin lisanslanabilir olup olmadığı.

licensabilityState

string

Öğenin lisanslanabilirlik durumudur.

unlicensableReason[]

string

Öğenin lisanslanabilir olmamasının nedeni.

NWayRevenueSharing

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

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

string

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

eligibleTerritories[]

string

Her ülke, iki harfli ISO ülke koduyla (ISO 3166-1 alpha-2) temsil edilir.

ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

Öğenin farklı yönlü gelir paylaşımına uygun olmadığı bölgeler hakkında bilgiler.

TerritoriesIneligibleForNWayRevenueSharing

Bir öğenin n yönlü gelir paylaşımı için uygun olmadığı bölgeler hakkında bilgi.

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

string

Bölgelerin uygun olmama nedeni aşağıda listelenmiştir.

territories[]

string

Her ülke, iki harfli ISO ülke koduyla (ISO 3166-1 alpha-2) temsil edilir.

Yöntemler

get

Belirtilen öğenin meta verilerini getirir.

insert

Belirtilen meta verilerle bir öğe ekler.

list

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

patch

Belirtilen öğe için meta verilere yama uygular.

update

Belirtilen öğenin meta verilerini günceller.