REST Resource: assets

리소스: 애셋

asset 리소스는 음원 또는 TV 에피소드와 같은 지식 재산을 나타냅니다.

애셋이 이미 다른 콘텐츠 소유자의 소유인 경우 메타데이터 (assets.update 또는 assets.patch 사용) 또는 동영상 일치 관련 정책 (assetMatchPolicy.update 또는 assetMatchPolicy.patch 사용)을 업데이트하려면 먼저 애셋에 소유권을 추가 (ownership.update 또는 ownership.patch 방법 사용)해야 합니다.

JSON 표현 
{
  "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)
  }
}
필드
kind

string

API 리소스의 유형입니다. asset 리소스의 경우 값은 youtubePartner#asset입니다.
type

string

저작물의 유형입니다. 이 값은 애셋에 설정할 수 있는 메타데이터 필드를 결정합니다. 또한 특정 API 함수는 특정 유형의 애셋에 대해서만 지원될 수 있습니다. 예를 들어 음악작품 저작물은 다른 유형의 저작물보다 소유권 데이터가 더 복잡할 수 있습니다.

이 속성에 유효한 값은 다음과 같습니다.

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

아트 트랙 애셋 (art_track_video)은 API를 사용하여 만들거나 수정할 수 없습니다. DDEX 또는 CSV 피드를 통해 아트 트랙 메타데이터 및 미디어를 제공합니다.
status

string

애셋의 상태입니다.

사용 가능한 값:

  • active
  • inactive
  • pending
metadata

object (Metadata)

metadata 객체에는 애셋을 식별하고 설명하는 정보가 포함되어 있습니다. 이 정보는 애셋을 검색하거나 YouTube 데이터베이스 내 중복을 제거하는 데 사용될 수 있습니다.
ownership

object (RightsOwnership)

ownership 객체는 저작물의 소유자를 식별하고 소유권에 관한 추가 세부정보(예: 저작물을 소유한 지역)를 제공합니다.
matchPolicy

object (AssetMatchPolicy)

matchPolicy 객체에는 YouTube가 애셋과 일치하는 사용자 업로드 동영상에 적용하는 애셋의 동영상 일치 관련 정책에 대한 정보가 포함되어 있습니다.
timeCreated

string

애셋이 생성된 날짜와 시간입니다. 값은 RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z) 형식으로 지정됩니다.
metadataMine

object (Metadata)
metadataEffective

object (Metadata)
ownershipMine

object (RightsOwnership)
ownershipEffective

object (RightsOwnership)
matchPolicyMine

object (AssetMatchPolicy)
matchPolicyEffective

object (AssetMatchPolicy)
ownershipConflicts

object (OwnershipConflicts)

ownershipConflicts 객체에는 저작물의 소유권 충돌에 관한 정보가 포함되어 있습니다.
id

string

YouTube에서 저작물을 고유하게 식별하기 위해 할당하고 사용하는 ID입니다.
aliasId[]

string

저작물을 참조하는 데 사용할 수 있는 저작물 ID 목록입니다. 애셋이 병합된 여러 구성 애셋을 나타내는 경우 목록에 값이 포함됩니다. 이 경우 구성요소 저작물에 원래 할당된 저작물 ID를 사용하여 마스터 또는 합성 저작물을 업데이트할 수 있습니다.
label[]

string

저작물의 저작물 라벨 목록입니다.
licensability

object (AssetLicensability)

저작물 라이선스 부여 정보입니다.
nWayRevenueSharing

object (NWayRevenueSharing)

N방향 수익 공유 (Pangea) 정보입니다.

OwnershipConflicts

ownershipConflicts 리소스는 저작물의 소유권 충돌에 관한 정보를 나타냅니다.

JSON 표현 
{
  "general": [
    {
      object (TerritoryConflicts)
    }
  ],
  "performance": [
    {
      object (TerritoryConflicts)
    }
  ],
  "synchronization": [
    {
      object (TerritoryConflicts)
    }
  ],
  "mechanical": [
    {
      object (TerritoryConflicts)
    }
  ],
  "kind": string
}
필드
general[]

object (TerritoryConflicts)

저작물의 소유권 분쟁과 충돌하는 소유권이 삽입된 지역을 식별하는 목록입니다.
performance[]

object (TerritoryConflicts)

음악작품 저작물의 공연권 소유권 분쟁 및 소유권 분쟁이 삽입된 지역을 식별하는 목록입니다.
synchronization[]

object (TerritoryConflicts)

음악작품 저작물의 동기화 권한의 소유권 분쟁과 분쟁이 있는 소유권이 삽입된 지역을 식별하는 목록입니다.
mechanical[]

object (TerritoryConflicts)

음악작품 저작물의 기계적 복제권 소유권 분쟁 및 소유권 분쟁이 삽입된 지역을 식별하는 목록입니다.
kind

string

API 리소스의 유형입니다. ownershipConflicts 리소스의 경우 값은 youtubePartner#ownershipConflicts입니다.

TerritoryConflicts

소유권 분쟁이 있는 지역을 조회하는 방법입니다.

JSON 표현 
{
  "territory": string,
  "conflictingOwnership": [
    {
      object (ConflictingOwnership)
    }
  ]
}
필드
territory

string

소유권 충돌이 있는 지역입니다. 지역은 ISO 3166 두 자리 국가 코드입니다.
conflictingOwnership[]

object (ConflictingOwnership)

충돌하는 소유권 목록입니다.

ConflictingOwnership

충돌하는 소유권 중 하나에 관한 정보를 나타냅니다.

JSON 표현 
{
  "ratio": number,
  "owner": string
}
필드
ratio

number

소유자가 관리하는 저작물의 비율입니다.
owner

string

충돌하는 애셋 소유자의 ID입니다.

AssetLicensability

저작물 라이선스 부여 정보입니다.

JSON 표현 
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
필드
licensable

boolean

조정된 저작물에 라이선스를 부여할 수 있는지 여부입니다.
licensabilityState

string

애셋의 라이선스 부여 가능 상태입니다.

사용 가능한 값:

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

string

저작물에 라이선스를 부여할 수 없는 이유입니다.

사용 가능한 값:

  • 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

정보 애셋의 n-way 수익 공유입니다.

JSON 표현 
{
  "status": string,
  "eligibleTerritories": [
    string
  ],
  "ineligibleTerritories": [
    {
      object (TerritoriesIneligibleForNWayRevenueSharing)
    }
  ]
}
필드
status

string

n방향 수익 공유 상태입니다.

사용 가능한 값:

  • 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

각 국가는 2자리 ISO 국가 코드 (ISO 3166-1 alpha-2)로 표시됩니다.
ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

저작물이 n방향 수익 공유에 적합하지 않은 지역에 관한 정보입니다.

TerritoriesIneligibleForNWayRevenueSharing

저작물이 n-way 수익 공유 대상이 아닌 지역에 관한 정보입니다.

JSON 표현 
{
  "reason": string,
  "territories": [
    string
  ]
}
필드
reason

string

이 리소스에 나열된 지역의 자격 요건 미충족 사유입니다.

사용 가능한 값:

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

string

각 국가는 2자리 ISO 국가 코드 (ISO 3166-1 alpha-2)로 표시됩니다.

메서드

get

 지정된 애셋의 메타데이터를 가져옵니다.

insert

 지정된 메타데이터가 있는 애셋을 삽입합니다.

list

 애셋 메타데이터를 기반으로 애셋 목록을 가져옵니다.

patch

 지정된 애셋의 메타데이터를 패치합니다.

update

 지정된 ���작물�� ���타데이터를 업데이트합니다.