REST Resource: assets

Kaynak: Öğe

asset kaynağı, 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, belirli 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 mülk 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 durumu.

metadata

object (Metadata)

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

ownership

object (RightsOwnership)

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

matchPolicy

object (AssetMatchPolicy)

matchPolicy nesnesi, öğenin eşleşme politikası hakkında 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 saattir. 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ı hakkında bilgi içerir.

id

string

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

aliasId[]

string

Öğeye atıfta bulunmak için kullanılabilecek öğe kimliklerinin listesi. Öğe, birleştirilmiş birden fazla bileşen öğeyi temsil ediyorsa liste değerler içerir. Bu durumda, başlangıçta bileşen öğelere 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 ihtilaflı sahipliği hakkındaki 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 öğe için sahiplik anlaşmazlıklarını ve sahiplik anlaşmazlığının eklendiği bölgeleri tanımlayan liste.

performance[]

object (TerritoryConflicts)

Bir beste öğesinin performans hakları için sahiplik anlaşmazlıklarını ve ihtilaflı sahipliğin eklendiği bölgeleri tanımlayan liste.

synchronization[]

object (TerritoryConflicts)

Bir beste öğesinin senkronizasyon haklarının sahiplik anlaşmazlıklarını ve ihtilaflı sahipliğin eklendiği bölgeleri tanımlayan bir liste.

mechanical[]

object (TerritoryConflicts)

Bir beste öğesinin mekanik hakları için sahiplik anlaşmazlıklarını ve ihtilaflı 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ığı olan terörleri arama yöntemi.

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

string

Sahiplik anlaşmazlığının söz konusu olduğu bölgeler. Bölge, ISO 3166 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

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

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 çift yönlü gelir paylaşımı.

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

string

İki yönlü gelir paylaşımının durumu.

eligibleTerritories[]

string

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

ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

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

TerritoriesIneligibleForNWayRevenueSharing

Bir öğenin çift yönlü gelir paylaşımı için uygun olmadığı bölgelerle ilgili bilgiler.

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

string

Aşağıda listelenen bölgeler için uygun olmama nedeni.

territories[]

string

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

Yöntemler

get

Belirtilen öğenin meta verilerini alır.

insert

Belirtilen meta verilere sahip bir öğe ekler.

list

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

patch

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

update

Belirtilen öğe için meta verileri günceller.